upd：完善demo和d.ts (#149)

Co-authored-by: chrisftian <chrisftian@tencent.com>

Author: livehigh

demo/config.js

@@ -1,9 +1,9 @@
 var config = {
-    SecretId: process.env.SecretId,
-    SecretKey: process.env.SecretKey,
-    Bucket: process.env.Bucket,
-    Region: process.env.Region,
-    Uin: process.env.Uin,
+    SecretId: process.env.SecretId || '',
+    SecretKey: process.env.SecretKey || '',
+    Bucket: process.env.Bucket || '',
+    Region: process.env.Region || '',
+    Uin: process.env.Uin || '',
 };
 
 module.exports = config;

demo/demo.js

@@ -1335,20 +1335,20 @@ function moveObject() {
         Key: source,
         Body: 'hello!',
     }, function (err, data) {
-        if (err) return logger.log(err);
+        if (err) return console.log(err);
         cos.putObjectCopy({
             Bucket: config.Bucket,
             Region: config.Region,
             Key: target,
             CopySource: copySource,
         }, function (err, data) {
-            if (err) return logger.log(err);
+            if (err) return console.log(err);
             cos.deleteObject({
                 Bucket: config.Bucket,
                 Region: config.Region,
                 Key: source,
             }, function (err, data) {
-                logger.log(err || data);
+                console.log(err || data);
             });
         });
     });
@@ -1391,7 +1391,7 @@ function uploadFolder() {
 
 /* 创建文件夹 */
 function createFolder() {
-    cos.getBucket({
+    cos.putObject({
         Bucket: config.Bucket,
         Region: config.Region,
         Key: 'folder/', // 对象存储没有实际的文件夹，可以创建一个路径以 / 结尾的空对象表示，能在部分场景中满足文件夹使用需要
@@ -1543,7 +1543,7 @@ function appendObject_continue() {
   }, function(err, data) {
       if (err) return console.log(err);
       // 首先取到要追加的文件当前长度，即需要上送的Position
-      var position = data.headers['content-length'];
+      var position = data.headers && data.headers['content-length'];
       cos.appendObject({
           Bucket: config.Bucket, // Bucket 格式：test-1250000000
           Region: config.Region,
@@ -1553,7 +1553,7 @@ function appendObject_continue() {
       },
       function(err, data) {
           // 也可以取到下一次上传的position继续追加上传
-          var nextPosition = data.headers['x-cos-next-append-position'];
+          var nextPosition = data.headers && data.headers['x-cos-next-append-position'];
           console.log(err || data);
       })
   });
@@ -2753,6 +2753,7 @@ function DescribeAuditJob() {
     var jobId = 'st3bb560af647911ec919652540024deb5';
     cos.request({
         Url: `https://${config.Bucket}.ci.${config.Region}.myqcloud.com/text/auditing/${jobId}`,
+        Method: 'GET',
     }, function (err, data) {
         console.log(err || data.Response.JobsDetail);
     });

index.d.ts

@@ -1861,6 +1861,8 @@ Bulk：批量模式，恢复时间为24 - 48小时。 */
   // request
   /** request 接口参数 */
   interface RequestParams extends BucketParams {
+    Bucket?: Bucket;
+    Region?: Region;
     /** 操作方法，如 get，post，delete， head 等 HTTP 方法 */
     Method: string,
     /** 请求的对象键，最前面不带 / */
@@ -1875,10 +1877,12 @@ Bulk：批量模式，恢复时间为24 - 48小时。 */
     Url?: string,
     /** 返回值body是否不需要解析 */
     RawBody?: boolean,
+    ContentType?: string,
   }
   /** Request 接口返回值 */
   interface RequestResult extends GeneralResult {
     Body?: Buffer,
+    Response?: any,
   }
 
   // getObjectUrl
@@ -1903,6 +1907,18 @@ Bulk：批量模式，恢复时间为24 - 48小时。 */
     Url: string
   }
 
+  interface DownloadFileParams {
+    Bucket: Bucket,
+    Region: Region,
+    Key: Key,
+    FilePath: string,
+    ChunkSize?: number,
+    ParallelLimit?: number,
+    RetryTimes?: number,
+    onTaskReady?: (TaskId: COS.TaskId) => void,
+    onProgress?: onProgress,
+  }
+
   // getV4Auth
   interface GetV4AuthParams {
     /** 计算签名用的密钥 SecretId，如果不传会用实例本身的凭证，可选 */
@@ -2293,6 +2309,10 @@ declare class COS {
   appendObject(params: COS.AppendObjectParams, callback: (err: COS.CosError, data: COS.GeneralResult) => void): void;
   appendObject(params: COS.AppendObjectParams): Promise<COS.GeneralResult>;
 
+  /** 分块下载 @see https://cloud.tencent.com/document/product/436/64981#.E5.88.86.E5.9D.97.E4.B8.8B.E8.BD.BD.E5.AF.B9.E8.B1.A1 */
+  downloadFile(params: COS.DownloadFileParams, callback: (err: COS.CosError, data: COS.GeneralResult) => void): void;
+  downloadFile(params: COS.DownloadFileParams): Promise<COS.GeneralResult>;
+
   /** 获取 COS JSON API (v4) 签名 @see https://cloud.tencent.com/document/product/436/6054 */
   getV4Auth(params: COS.GetV4AuthParams): COS.Authorization;