//用 web.rest 客户端调用 HTTP API - 下载文件
import console; 
import web.rest.jsonLiteClient;

console.showLoading("正在下载");

//创建 REST 客户端
var httpClient = web.rest.client();

/*
web.rest 的客户端都能自动检查响应类型，可作为普通 HTTP 客户端使用。
httpClient.receiveFile 用于预先指定接收下载的文件名（可选指定进度回调函数）。
httpClient.receiveFile 返回 httpClient 自身。
*/
httpClient.receiveFile("/.test1.jpg").get("https://httpbin.org/image/jpeg")

//声明 HTTP API
var httpApi = httpClient.api("https://httpbin.org");

/*
httpApi.receiveFile 用于预先指定接收下载的文件名（可选指定进度回调函数）。
如果创建文件失败 receiveFile 函数会返回 null 及错误信息，否则返回 httpApi 对象自身。
*/
var ok,err = httpApi.receiveFile("/.test2.jpg").image.jpeg.get();

/*
可选如下指定下载进度回调函数：
要切记 receiveFile 指定的下载参数仅对本次请求有效。
*/
var ok,err = httpApi.receiveFile("/.test3.jpg"
	,function(recvData,recvSize,contentLength){
		/*
		recvData 为当前下载数据。
		recvSize 为当前下载数据字节数。
		contentLength 为需要下载的总字节数。
		*/
		console.log(math.size64(recvSize).format(),contentLength)
	}).get();

console.error(err);//无 err 会自动跳过
console.pause();