JavaScript SDK

{"value":"# JavaScript-SDK\n\n[Build Status](https:\/\/travis-ci.org\/qiniu\/js-sdk) \n\n[GitHub release](https:\/\/github.com\/qiniu\/js-sdk\/releases) \n\n[Coverage Status](https:\/\/codecov.io\/gh\/qiniu\/js-sdk)\n\n\u57fa\u4e8e API \u5f00\u53d1\u7684\u524d\u7aef JavaScript SDK\n\n## \u5f53\u524d\u7248\u672c\u4e3a 3.x\uff0c\u65e7\u7248\u672c\u6587\u6863\uff1a[2.x](https:\/\/github.com\/qiniu\/js-sdk\/tree\/2.x)\u3001[1.x](https:\/\/github.com\/qiniu\/js-sdk\/tree\/1.x)\n\n### 2.x \u5347\u7ea7\u5230 3.x \u7684\u6ce8\u610f\u4e8b\u9879\u8bf7\u53c2\u8003 [\u6587\u6863](https:\/\/github.com\/qiniu\/js-sdk\/wiki\/2.x-\u5347\u7ea7\u5230-3.x-\u6587\u6863\u6ce8\u610f\u4e8b\u9879)\n\n## \u5feb\u901f\u5bfc\u822a\n\n## \u6982\u8ff0\n\nJavaScript-SDK \uff08\u4e0b\u6587\u7b80\u79f0\u4e3a JS-SDK\uff09\u9002\u7528\u4e8e \uff1aIE11\u3001Edge\u3001Chrome\u3001Firefox\u3001Safari \u7b49\u6d4f\u89c8\u5668\uff0c\u57fa\u4e8e\u4e91\u5b58\u50a8\u5b98\u65b9 API \u6784\u5efa\uff0c\u5176\u4e2d\u4e0a\u4f20\u529f\u80fd\u57fa\u4e8e H5 File API\u3002\u5f00\u53d1\u8005\u57fa\u4e8e JS-SDK \u53ef\u4ee5\u65b9\u4fbf\u7684\u4ece\u6d4f\u89c8\u5668\u7aef\u4e0a\u4f20\u6587\u4ef6\u81f3\u4e91\u5b58\u50a8\uff0c\u5e76\u5bf9\u4e0a\u4f20\u6210\u529f\u540e\u7684\u56fe\u7247\u8fdb\u884c\u4e30\u5bcc\u7684\u6570\u636e\u5904\u7406\u64cd\u4f5c\u3002 JS-SDK \u517c\u5bb9\u652f\u6301 H5 File API \u7684\u6d4f\u89c8\u5668\uff0c\u5728\u4f4e\u7248\u672c\u6d4f\u89c8\u5668\u4e0b\uff0c\u9700\u8981\u989d\u5916\u7684\u63d2\u4ef6\u5982 plupload\uff0cJS-SDK \u63d0\u4f9b\u4e86\u4e00\u4e9b\u63a5\u53e3\u53ef\u4ee5\u7ed3\u5408\u63d2\u4ef6\u6765\u8fdb\u884c\u4e0a\u4f20\u5de5\u4f5c\uff0c\u6ce8\u610f\uff1a(\u5728\u4f4e\u7248\u672c\u6d4f\u89c8\u5668\u9700\u8981\u5f15\u5165 [babel-polyfill](https:\/\/babeljs.cn\/docs\/usage\/polyfill\/) \u6765\u89e3\u51b3 SDK \u91cc\u67d0\u4e9b\u8bed\u6cd5\u6216\u8005\u5c5e\u6027\u6d4f\u89c8\u5668\u4e0d\u80fd\u8bc6\u522b\u7684\u95ee\u9898)\u3002\n\nJavaScript-SDK \u4e3a\u5ba2\u6237\u7aef SDK\uff0c\u6ca1\u6709\u5305\u542b `token` \u751f\u6210\u5b9e\u73b0\uff0c\u4e3a\u4e86\u5b89\u5168\uff0c`token` \u5efa\u8bae\u901a\u8fc7\u7f51\u7edc\u4ece\u670d\u52a1\u7aef\u83b7\u53d6\uff0c\u5177\u4f53\u751f\u6210\u4ee3\u7801\u53ef\u4ee5\u53c2\u8003\u5176\u4ed6\u670d\u52a1\u7aef SDK \u7684\u6587\u6863\u3002\n\nJavaScript-SDK \u7684\u793a\u4f8b [Demo](http:\/\/jssdk-v2.demo.qiniu.io\/) \u4e2d\u7684\u670d\u52a1\u5668\u7aef\u90e8\u5206\u662f\u57fa\u4e8e [Node.js \u670d\u52a1\u5668\u7aef SDK](https:\/\/developer.qiniu.com\/kodo\/sdk\/nodejs) \u5f00\u53d1\u7684\u3002\n\n- [JavaScript SDK \u5728\u7ebf\u793a\u4f8b V3](https:\/\/js-sdk-demo.qiniu.io\/)\n- [JavaScript SDK \u5728\u7ebf\u793a\u4f8b V2](http:\/\/jssdk-v2.demo.qiniu.io\/)\n\n\n\n## \u529f\u80fd\u7b80\u4ecb\n\n- \u4e0a\u4f20\n - \u5927\u4e8e 4M \u65f6\u53ef\u5206\u5757\u4e0a\u4f20\uff0c\u5c0f\u4e8e 4M \u65f6\u76f4\u4f20\n - \u5206\u5757\u4e0a\u4f20\u65f6\uff0c\u652f\u6301\u65ad\u70b9\u7eed\u4f20\n- \u6570\u636e\u5904\u7406\uff08\u56fe\u7247\uff09\n - imageView2\uff08\u7f29\u7565\u56fe\uff09\n - imageMogr2\uff08\u9ad8\u7ea7\u5904\u7406\uff0c\u5305\u542b\u7f29\u653e\u3001\u88c1\u526a\u3001\u65cb\u8f6c\u7b49\uff09\n - imageInfo \uff08\u83b7\u53d6\u57fa\u672c\u4fe1\u606f\uff09\n - exif \uff08\u83b7\u53d6\u56fe\u7247 EXIF \u4fe1\u606f\uff09\n - watermark \uff08\u6587\u5b57\u3001\u56fe\u7247\u6c34\u5370\uff09\n - pipeline \uff08\u7ba1\u9053\uff0c\u53ef\u5bf9 imageView2\u3001imageMogr2\u3001watermark \u8fdb\u884c\u94fe\u5f0f\u5904\u7406\uff09\n\n\n\n## \u51c6\u5907\n\n- \u5728\u4f7f\u7528 JS-SDK \u4e4b\u524d\uff0c\u60a8\u5fc5\u987b\u5148\u6ce8\u518c\u4e00\u4e2a\u5e10\u53f7\uff0c\u5e76\u767b\u5f55\u63a7\u5236\u53f0\u83b7\u53d6\u4e00\u5bf9\u6709\u6548\u7684 `AccessKey` \u548c `SecretKey`\uff0c\u60a8\u53ef\u4ee5\u9605\u8bfb \u5feb\u901f\u5165\u95e8 \u548c \u5b89\u5168\u673a\u5236 \u4ee5\u8fdb\u4e00\u6b65\u4e86\u89e3\u5982\u4f55\u6b63\u786e\u4f7f\u7528\u548c\u7ba1\u7406\u5bc6\u94a5 \u3002\n\n- JS-SDK \u4f9d\u8d56\u670d\u52a1\u7aef\u9881\u53d1 `token`\uff0c\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u4e8c\u79cd\u65b9\u5f0f\u5b9e\u73b0\uff1a\n\n - \u5229\u7528 [SDK](https:\/\/developer.qiniu.com\/sdk#sdk) \u6784\u5efa\u540e\u7aef\u670d\u52a1\n - \u5229\u7528\u5e95\u5c42 API \u6784\u5efa\u670d\u52a1\uff0c\u8be6\u89c1 \u4e0a\u4f20\u7b56\u7565\u548c \u4e0a\u4f20\u51ed\u8bc1\n\n \u524d\u7aef\u901a\u8fc7\u63a5\u53e3\u8bf7\u6c42\u4ee5\u83b7\u5f97 `token` \u4fe1\u606f\n\n\n\n## \u5f15\u5165\n\n\u652f\u6301\u4ee5\u4e0b\u51e0\u79cd\u5b89\u88c5\u65b9\u5f0f\n\n- \u76f4\u63a5\u4f7f\u7528\u9759\u6001\u6587\u4ef6\u5730\u5740\uff1a\n\n ```\n https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/qiniu-js\/<version>\/qiniu.min.js\n \n \/\/ \u5f53\u4e0a\u65b9\u8d44\u6e90\u94fe\u63a5\u8bbf\u95ee\u4e0d\u7a33\u5b9a\u65f6\uff0c\u53ef\u9009\u4f7f\u7528\u4e0b\u65b9\u8d44\u6e90\u94fe\u63a5\n https:\/\/cdn.staticfile.org\/qiniu-js\/<version>\/qiniu.min.js\n ```\n\n \u901a\u8fc7 script \u6807\u7b7e\u5f15\u5165\u8be5\u6587\u4ef6\uff0c\u4f1a\u5728\u5168\u5c40\u751f\u6210\u540d\u4e3a `qiniu` \u7684\u5bf9\u8c61\n\n- \u4f7f\u7528 NPM \u5b89\u88c5\n\n NPM \u7684\u5168\u79f0\u662f Node Package Manager\uff0c\u662f\u4e00\u4e2a [NodeJS](https:\/\/nodejs.org\/) \u5305\u7ba1\u7406\u548c\u5206\u53d1\u5de5\u5177\uff0c\u5df2\u7ecf\u6210\u4e3a\u4e86\u975e\u5b98\u65b9\u7684\u53d1\u5e03 Node \u6a21\u5757\uff08\u5305\uff09\u7684\u6807\u51c6\u3002\u5982\u679c\u9700\u8981\u66f4\u8be6\u7ec6\u7684\u5173\u4e8e NPM \u7684\u4f7f\u7528\u8bf4\u660e\uff0c\u60a8\u53ef\u4ee5\u8bbf\u95ee [NPM \u5b98\u65b9\u7f51\u7ad9](https:\/\/www.npmjs.com\/)\uff0c\u6216\u5bf9\u5e94\u7684 [\u4e2d\u6587\u7f51\u7ad9](http:\/\/www.npmjs.com.cn\/)\n\n ```shell\n npm install qiniu-js\n ```\n\n ```Javascript\n const qiniu = require('qiniu-js')\n \/\/ or\n import * as qiniu from 'qiniu-js'\n ```\n\n- \u901a\u8fc7\u6e90\u7801\u7f16\u8bd1\n\n`git clone git@github.com:qiniu\/js-sdk.git`\uff0c\u8fdb\u5165\u9879\u76ee\u6839\u76ee\u5f55\u6267\u884c `npm install` \uff0c\u6267\u884c `npm run build`\uff0c\u5373\u53ef\u5728dist \u76ee\u5f55\u751f\u6210 `qiniu.min.js`\u3002\n\n\n\n## \u4f7f\u7528\n\n`qiniu.upload` \u8fd4\u56de\u4e00\u4e2a `observable` \u5bf9\u8c61\u7528\u6765\u63a7\u5236\u4e0a\u4f20\u884c\u4e3a\uff0c`observable` \u5bf9\u50cf\u901a\u8fc7 `subscribe` \u65b9\u6cd5\u53ef\u4ee5\u88ab `observer` \u6240\u8ba2\u9605\uff0c\u8ba2\u9605\u540c\u65f6\u4f1a\u5f00\u59cb\u89e6\u53d1\u4e0a\u4f20\uff0c\u540c\u65f6\u8fd4\u56de\u4e00\u4e2a `subscription` \u5bf9\u8c61\uff0c\u8be5\u5bf9\u8c61\u6709\u4e00\u4e2a `unsubscribe` \u65b9\u6cd5\u53d6\u6d88\u8ba2\u9605\uff0c\u540c\u65f6\u7ec8\u6b62\u4e0a\u4f20\u884c\u4e3a\u3002\u5bf9\u4e8e\u4e0d\u652f\u6301 SDK \u7684\u6d4f\u89c8\u5668\u53ef\u4ee5\u53c2\u8003 demo1 \u4e2d\u7528\u63d2\u4ef6\u5904\u7406\u548c form \u76f4\u4f20\u7684\u65b9\u5f0f\uff1b \u4e00\u822c form \u63d0\u4ea4\u5e38\u5e38\u4f1a\u5bfc\u81f4\u7f51\u9875\u8df3\u8f6c\uff0cdemo1 \u4e2d form \u76f4\u4f20\u901a\u8fc7\u52a0\u5165 iframe\uff0c\u5e76\u7ed3\u5408\u540e\u7aef SDK \u4e0a\u4f20\u6765\u89e3\u51b3\u7f51\u9875\u8df3\u8f6c\u95ee\u9898\uff0c\u5b9e\u73b0 form \u65e0\u5237\u65b0\u4e0a\u4f20\u3002\u5206\u7247\u4e0a\u4f20\u65f6\uff0cJS-SDK\u652f\u6301\u65ad\u70b9\u7eed\u4f20\u529f\u80fd\uff0c\u4f1a\u628a\u5df2\u4e0a\u4f20\u7247\u7684\u540e\u7aef\u8fd4\u56de\u503cctx\u4fe1\u606f\u5b58\u50a8\u5230\u672c\u5730\uff0c\u6709\u6548\u671f\u4e3a\u4e00\u5929\uff0c\u8d85\u8fc7\u4e00\u5929\u540e\uff0c\u5f53\u7ee7\u7eed\u4e0a\u4f20\u8be5\u6587\u4ef6\u65f6\u4f1a\u6e05\u9664\u6389\u672c\u5730\u5b58\u50a8\u4fe1\u606f\u91cd\u65b0\u4e0a\u4f20\u3002\n\n### Example\n\n\u6587\u4ef6\u4e0a\u4f20\uff1a\n\n```JavaScript\nconst observable = qiniu.upload(file, key, token, putExtra, config)\n\nconst subscription = observable.subscribe(observer) \/\/ \u4e0a\u4f20\u5f00\u59cb\n\/\/ or\nconst subscription = observable.subscribe(next, error, complete) \/\/ \u8fd9\u6837\u4f20\u53c2\u5f62\u5f0f\u4e5f\u53ef\u4ee5\n\nsubscription.unsubscribe() \/\/ \u4e0a\u4f20\u53d6\u6d88\n```\n\n\u56fe\u7247\u4e0a\u4f20\u524d\u538b\u7f29\uff1a\n\n```JavaScript\nconst options = {\n quality: 0.92,\n noCompressIfLarger: true\n \/\/ maxWidth: 1000,\n \/\/ maxHeight: 618\n}\nqiniu.compressImage(file, options).then(data => {\n const observable = qiniu.upload(data.dist, key, token, putExtra, config)\n const subscription = observable.subscribe(observer) \/\/ \u4e0a\u4f20\u5f00\u59cb\n})\n```\n\n## API Reference Interface\n\n### qiniu.upload(file: File, key: string, token: string, putExtra?: object, config?: object): observable\n\n- **observable**: \u4e3a\u4e00\u4e2a\u5e26\u6709 subscribe \u65b9\u6cd5\u7684\u7c7b\u5b9e\u4f8b\n\n - observable.subscribe(observer: object): subscription\n\n - observer: `observer` \u4e3a\u4e00\u4e2a `object`\uff0c\u7528\u6765\u8bbe\u7f6e\u4e0a\u4f20\u8fc7\u7a0b\u7684\u76d1\u542c\u51fd\u6570\uff0c\u6709\u4e09\u4e2a\u5c5e\u6027 `next`\u3001`error`\u3001`complete`:\n\n ```JavaScript\n const observer = {\n next(res){\n \/\/ ...\n },\n error(err){\n \/\/ ...\n },\n complete(res){\n \/\/ ...\n }\n }\n ```\n\n - next: \u63a5\u6536\u4e0a\u4f20\u8fdb\u5ea6\u4fe1\u606f\u7684\u56de\u8c03\u51fd\u6570\uff0c\u56de\u8c03\u51fd\u6570\u53c2\u6570\u503c\u4e3a `object`\uff0c\u5305\u542b\u5b57\u6bb5\u4fe1\u606f\u5982\u4e0b\uff1a\n\n - uploadInfo:\n\n \n\n ```\n object\n ```\n\n \uff0c\u53ea\u6709\u5206\u7247\u4e0a\u4f20\u65f6\u624d\u8fd4\u56de\u8be5\u5b57\u6bb5\n\n - uploadInfo.id: \u4e0a\u4f20\u4efb\u52a1\u7684\u552f\u4e00\u6807\u8bc6\u3002\n - uploadInfo.url: \u4e0a\u4f20\u5730\u5740\u3002\n\n - chunks:\n\n \n\n ```\n Array<ProgressCompose>\n ```\n\n \n\n \u6bcf\u4e2a\n\n \n\n ```\n chunk\n ```\n\n \n\n \u7684\u4e0a\u4f20\u4fe1\u606f\uff0c\u53ea\u6709\u5206\u7247\u4e0a\u4f20\u6709\u6b64\u5b57\u6bb5\n\n - ProgressCompose \u7684\u4fe1\u606f\u5982\u4e0b\n - size: `number` chunk \u7684\u5c3a\u5bf8\n - loaded: `number` \u5df2\u7ecf\u53d1\u9001\u5b8c\u6bd5\u7684\u5c3a\u5bf8\n - percent: `number` \u8fdb\u5ea6\u6bd4\u4f8b\uff0c\u8303\u56f4\u5728 0 - 100\n - fromCache?: `boolean` \u662f\u5426\u662f\u6765\u81ea\u7f13\u5b58\n\n - total: \u5305\u542b\n\n \n\n ```\n loaded\n ```\n\n \u3001\n\n ```\n total\n ```\n\n \u3001\n\n ```\n percent\n ```\n\n \n\n \u4e09\u4e2a\u5c5e\u6027:\n\n - total.loaded: `number`\uff0c\u5df2\u4e0a\u4f20\u5927\u5c0f\uff0c\u5355\u4f4d\u4e3a\u5b57\u8282\u3002\n - total.total: `number`\uff0c\u672c\u6b21\u4e0a\u4f20\u7684\u603b\u91cf\u63a7\u5236\u4fe1\u606f\uff0c\u5355\u4f4d\u4e3a\u5b57\u8282\uff0c\u6ce8\u610f\u8fd9\u91cc\u7684 total \u8ddf\u6587\u4ef6\u5927\u5c0f\u5e76\u4e0d\u4e00\u81f4\u3002\n - total.percent: `number`\uff0c\u5f53\u524d\u4e0a\u4f20\u8fdb\u5ea6\uff0c\u8303\u56f4\uff1a0\uff5e100\u3002\n\n - error: \u4e0a\u4f20\u9519\u8bef\u540e\u89e6\u53d1\uff1b\u81ea\u52a8\u91cd\u8bd5\u672c\u8eab\u5e76\u4e0d\u4f1a\u89e6\u53d1\u8be5\u9519\u8bef\uff0c\u800c\u5f53\u91cd\u8bd5\u6b21\u6570\u5230\u8fbe\u4e0a\u9650\u540e\u5219\u53ef\u4ee5\u89e6\u53d1\u3002\u5f53\u4e0d\u662f xhr \u8bf7\u6c42\u9519\u8bef\u65f6\uff0c\u4f1a\u628a\u5f53\u524d\u9519\u8bef\u4ea7\u751f\u539f\u56e0\u76f4\u63a5\u629b\u51fa\uff0c\u8bf8\u5982 JSON \u89e3\u6790\u5f02\u5e38\u7b49\uff1b\u5f53\u4ea7\u751f xhr \u8bf7\u6c42\u9519\u8bef\u65f6\uff0c\u53c2\u6570 err \u7684\u7c7b\u578b\u4e3a `QiniuError`, \u5bf9\u4e8e\u8bf7\u6c42\u9519\u8bef\uff0cerr \u7684\u7c7b\u578b\u4e3a `QiniuRequestError`(\u7ee7\u627f\u81ea`QiniuError`)\uff0c\u5982\u679c\u662f\u7531\u4e8e\u975e\u670d\u52a1\u7aef\u539f\u56e0\u53d1\u751f\u9519\u8bef\u65f6\uff08\u4f8b\u5982\u65ad\u7f51\u3001\u8de8\u57df\u7b49\u7b49\uff09\uff0c\u9519\u8bef\u7684\u7c7b\u578b\u4e3a `QiniuNetworkError`(\u7ee7\u627f\u81ea`QiniuRequestError`)\u3002\n\n - ```\n QiniuError\n ```\n\n - name: `QiniuErrorName` \u9519\u8bef\u7684\u7c7b\u578b\u3002\n - message: `string` \u9519\u8bef\u7684\u4fe1\u606f\u3002\n - stack: `string` \u8c03\u7528\u5806\u6808\u4fe1\u606f\u3002\n\n - ```\n QiniuRequestError\n ```\n\n \n\n \u7ee7\u627f\u81ea\n\n \n\n ```\n QiniuError\n ```\n\n - data: `any` \u670d\u52a1\u7aef\u8fd4\u56de\u7684\u9519\u8bef\u4fe1\u606f\uff0c\u5982\u679c\u4e0d\u662f\u6807\u51c6\u7684 `json` \u683c\u5f0f\uff0c\u5219\u8be5\u5b57\u6bb5\u4e3a `undefined`\u3002\n - reqId: `string` xhr \u8bf7\u6c42\u9519\u8bef\u7684 `X-Reqid`\u3002\n - code: `number` \u8bf7\u6c42\u9519\u8bef\u72b6\u6001\u7801\uff0c\u53ef\u67e5\u9605\u7801\u503c\u5bf9\u5e94 [\u8bf4\u660e](https:\/\/developer.qiniu.com\/kodo\/api\/3928\/error-responses)\u3002\n - isRequestError: \u56fa\u5b9a\u4e3a `true`\uff0c*\u4e0d\u63a8\u8350\u4f7f\u7528\uff0c\u5373\u5c06\u5e9f\u5f03*\u3002\n\n - ```\n QiniuNetworkError\n ```\n\n \n\n \u7ee7\u627f\u81ea\n\n \n\n ```\n QiniuRequestError\n ```\n\n - reqId: \u7531\u4e8e\u8bf7\u6c42\u53ef\u80fd\u8fd8\u672a\u771f\u6b63\u53d1\u51fa\uff0c\u6240\u4ee5\u53ef\u80fd\u65e0\u6cd5\u6536\u96c6\u5230 `reqId`\uff0c\u8be5\u5b57\u6bb5\u53ef\u80fd\u4e3a `''`\u3002\n\n - complete: \u63a5\u6536\u4e0a\u4f20\u5b8c\u6210\u540e\u7684\u540e\u7aef\u8fd4\u56de\u4fe1\u606f\uff0c\u5177\u4f53\u8fd4\u56de\u7ed3\u6784\u53d6\u51b3\u4e8e\u540e\u7aef SDK \u7684\u914d\u7f6e\uff0c\u53ef\u53c2\u8003 \u4e0a\u4f20\u7b56\u7565\u3002\n\n - subscription: \u4e3a\u4e00\u4e2a\u5e26\u6709 `unsubscribe` \u65b9\u6cd5\u7684\u7c7b\u5b9e\u4f8b\uff0c\u901a\u8fc7\u8c03\u7528 `subscription.unsubscribe()` \u505c\u6b62\u5f53\u524d\u6587\u4ef6\u4e0a\u4f20\u3002\n\n- **bucket**: \u4e0a\u4f20\u7684\u76ee\u6807\u7a7a\u95f4\n\n- **file**: `File` \u5bf9\u8c61\uff0c\u4e0a\u4f20\u7684\u6587\u4ef6\n\n- **key**: \u6587\u4ef6\u8d44\u6e90\u540d\uff0c\u4e3a\u7a7a\u5b57\u7b26\u4e32\u65f6\u5219\u6587\u4ef6\u8d44\u6e90\u540d\u4e5f\u4e3a\u7a7a\uff0c\u4e3a `null` \u6216\u8005 `undefined` \u65f6\u5219\u81ea\u52a8\u4f7f\u7528\u6587\u4ef6\u7684 `hash` \u4f5c\u4e3a\u6587\u4ef6\u540d\n\n- **token**: \u4e0a\u4f20\u9a8c\u8bc1\u4fe1\u606f\uff0c\u524d\u7aef\u901a\u8fc7\u63a5\u53e3\u8bf7\u6c42\u540e\u7aef\u83b7\u5f97\n\n- **config**: `object`\uff0c\u5176\u4e2d\u7684\u6bcf\u4e00\u9879\u90fd\u4e3a\u53ef\u9009\n\n ```JavaScript\n const config = {\n useCdnDomain: true,\n region: qiniu.region.z2\n };\n ```\n\n - config.useCdnDomain: \u8868\u793a\u662f\u5426\u4f7f\u7528 cdn \u52a0\u901f\u57df\u540d\uff0c\u4e3a\u5e03\u5c14\u503c\uff0c`true` \u8868\u793a\u4f7f\u7528\uff0c\u9ed8\u8ba4\u4e3a `false`\u3002\n - config.disableStatisticsReport: \u662f\u5426\u7981\u7528\u65e5\u5fd7\u62a5\u544a\uff0c\u4e3a\u5e03\u5c14\u503c\uff0c\u9ed8\u8ba4\u4e3a `false`\u3002\n - config.uphost: \u4e0a\u4f20 `host`\uff0c\u7c7b\u578b\u4e3a `string[] | string`\uff0c\u5982\u679c\u6307\u5b9a\u4e00\u4e2a\u975e\u7a7a\u6570\u7ec4\u6216\u8005\u975e\u7a7a\u5b57\u7b26\u4e32\uff0c\u5219\u4ec5\u4f7f\u7528\u8be5\u6570\u636e\u4f5c\u4e3a\u4e0a\u4f20 `host`\uff0c\u9ed8\u8ba4\u4e3a `[]`\uff0c\u4f20\u5165\u591a\u4e2a `host` \u65f6\uff0c\u5185\u90e8\u4f1a\u5728\u91cd\u8bd5\u8fc7\u7a0b\u4e2d\u6839\u636e\u60c5\u51b5\u81ea\u52a8\u5207\u6362\u4e0d\u540c\u7684 `host`\u3002\n - config.upprotocol: \u81ea\u5b9a\u4e49\u4e0a\u4f20\u57df\u540d\u534f\u8bae\uff0c\u503c\u4e3a `https` \u6216\u8005 `http`\uff0c\u9ed8\u8ba4\u4e3a `https`\u3002\n - config.region: \u9009\u62e9\u4e0a\u4f20\u57df\u540d\u533a\u57df\uff1b\u5f53\u4e3a `null` \u6216 `undefined` \u65f6\uff0c\u81ea\u52a8\u5206\u6790\u4e0a\u4f20\u57df\u540d\u533a\u57df\uff0c\u5f53\u6307\u5b9a\u4e86 `uphost` \u65f6\uff0c\u6b64\u8bbe\u7f6e\u9879\u65e0\u6548\u3002\n - config.retryCount: \u4e0a\u4f20\u81ea\u52a8\u91cd\u8bd5\u6b21\u6570\uff08\u6574\u4f53\u91cd\u8bd5\u6b21\u6570\uff0c\u800c\u4e0d\u662f\u67d0\u4e2a\u5206\u7247\u7684\u91cd\u8bd5\u6b21\u6570\uff09\uff1b\u9ed8\u8ba4 3 \u6b21\uff08\u5373\u4e0a\u4f20\u5931\u8d25\u540e\u6700\u591a\u91cd\u8bd5\u4e24\u6b21\uff09\u3002\n - config.concurrentRequestLimit: \u5206\u7247\u4e0a\u4f20\u7684\u5e76\u53d1\u8bf7\u6c42\u91cf\uff0c`number`\uff0c\u9ed8\u8ba4\u4e3a3\uff1b\u56e0\u4e3a\u6d4f\u89c8\u5668\u672c\u8eab\u4e5f\u4f1a\u9650\u5236\u6700\u5927\u5e76\u53d1\u91cf\uff0c\u6240\u4ee5\u6700\u5927\u5e76\u53d1\u91cf\u4e0e\u6d4f\u89c8\u5668\u6709\u5173\u3002\n - config.checkByServer: \u662f\u5426\u5f00\u542f\u670d\u52a1\u7aef\u6587\u4ef6\u7b7e\u540d\u6821\u9a8c\uff0c\u4e3a\u5e03\u5c14\u503c\uff1b\u5f00\u542f\u540e\u5728\u6587\u4ef6\u4e0a\u4f20\u65f6\u4f1a\u8ba1\u7b97\u672c\u5730\u7684\u6587\u4ef6\u7b7e\u540d\uff0c\u670d\u52a1\u7aef\u4f1a\u6839\u636e\u672c\u5730\u7684\u7b7e\u540d\u4e0e\u63a5\u6536\u5230\u7684\u6570\u636e\u7684\u7b7e\u540d\u8fdb\u884c\u6bd4\u5bf9\uff0c\u5982\u679c\u4e0d\u76f8\u540c\u3001\u5219\u8bf4\u660e\u6587\u4ef6\u53ef\u80fd\u5b58\u5728\u95ee\u9898\uff0c\u6b64\u65f6\u4f1a\u8fd4\u56de\u9519\u8bef\uff08`code`: 406\uff09\uff0c\u9ed8\u8ba4\u4e3a `false`\uff0c\u4e0d\u5f00\u542f\u3002\n - config.checkByMD5: \u662f\u5426\u5f00\u542f `MD5` \u6821\u9a8c\uff0c\u4e3a\u5e03\u5c14\u503c\uff1b\u5728\u65ad\u70b9\u7eed\u4f20\u65f6\uff0c\u5f00\u542f `MD5` \u6821\u9a8c\u4f1a\u5c06\u5df2\u4e0a\u4f20\u7684\u5206\u7247\u4e0e\u5f53\u524d\u5206\u7247\u8fdb\u884c `MD5` \u503c\u6bd4\u5bf9\uff0c\u82e5\u4e0d\u4e00\u81f4\uff0c\u5219\u91cd\u4f20\u8be5\u5206\u7247\uff0c\u907f\u514d\u4f7f\u7528\u9519\u8bef\u7684\u5206\u7247\u3002\u8bfb\u53d6\u5206\u7247\u5185\u5bb9\u5e76\u8ba1\u7b97 `MD5` \u9700\u8981\u82b1\u8d39\u4e00\u5b9a\u7684\u65f6\u95f4\uff0c\u56e0\u6b64\u4f1a\u7a0d\u5fae\u589e\u52a0\u65ad\u70b9\u7eed\u4f20\u65f6\u7684\u8017\u65f6\uff0c\u9ed8\u8ba4\u4e3a `false`\uff0c\u4e0d\u5f00\u542f\u3002\n - config.forceDirect: \u662f\u5426\u4e0a\u4f20\u5168\u90e8\u91c7\u7528\u76f4\u4f20\u65b9\u5f0f\uff0c\u4e3a\u5e03\u5c14\u503c\uff1b\u4e3a `true` \u65f6\u5219\u4e0a\u4f20\u65b9\u5f0f\u5168\u90e8\u4e3a\u76f4\u4f20 form \u65b9\u5f0f\uff0c\u7981\u7528\u65ad\u70b9\u7eed\u4f20\uff0c\u9ed8\u8ba4 `false`\u3002\n - config.chunkSize: `number`\uff0c\u5206\u7247\u4e0a\u4f20\u65f6\u6bcf\u7247\u7684\u5927\u5c0f\uff0c\u5fc5\u987b\u4e3a\u6b63\u6574\u6570\uff0c\u5355\u4f4d\u4e3a `MB`\uff0c\u4e14\u6700\u5927\u4e0d\u80fd\u8d85\u8fc7 1024\uff0c\u9ed8\u8ba4\u503c 4\u3002\u56e0\u4e3a chunk \u6570\u6700\u5927 10000\uff0c\u6240\u4ee5\u5982\u679c\u6587\u4ef6\u4ee5\u4f60\u6240\u8bbe\u7684 `chunkSize` \u8fdb\u884c\u5206\u7247\u5e76\u4e14 chunk \u6570\u8d85\u8fc7 10000\uff0c\u6211\u4eec\u4f1a\u628a\u4f60\u6240\u8bbe\u7684 `chunkSize` \u6269\u5927\u4e8c\u500d\uff0c\u5982\u679c\u4ecd\u4e0d\u7b26\u5408\u5219\u7ee7\u7eed\u6269\u5927\uff0c\u76f4\u5230\u7b26\u5408\u6761\u4ef6\u3002\n - config.debugLogLevel: `INFO` | `WARN` | `ERROR` | `OFF`\uff0c\u5141\u8bb8\u7a0b\u5e8f\u5728\u63a7\u5236\u53f0\u8f93\u51fa\u65e5\u5fd7\uff0c\u9ed8\u8ba4\u4e3a `OFF`\uff0c\u4e0d\u8f93\u51fa\u4efb\u4f55\u65e5\u5fd7\uff0c\u672c\u529f\u80fd\u4ec5\u4ec5\u7528\u4e8e\u672c\u5730\u8c03\u8bd5\uff0c\u4e0d\u5efa\u8bae\u5728\u7ebf\u4e0a\u73af\u5883\u5f00\u542f\u3002\n\n- **putExtra**: `object`\uff0c\u5176\u4e2d\u7684\u6bcf\u4e00\u9879\u90fd\u4e3a\u53ef\u9009\n\n ```JavaScript\n const putExtra = {\n fname: \"qiniu.txt\",\n mimeType: \"text\/plain\",\n customVars: { 'x:test': 'qiniu', ... },\n metadata: { 'x-qn-meta': 'qiniu', ... },\n };\n ```\n\n - fname: `string`\uff0c\u6587\u4ef6\u539f\u59cb\u6587\u4ef6\u540d\uff0c\u82e5\u672a\u6307\u5b9a\uff0c\u5219\u9b54\u6cd5\u53d8\u91cf\u4e2d\u65e0\u6cd5\u4f7f\u7528 fname\u3001ext\u3001suffix\n - customVars: `object`\uff0c\u7528\u6765\u653e\u7f6e\u81ea\u5b9a\u4e49\u53d8\u91cf\uff0c\u53d8\u91cf\u540d\u5fc5\u987b\u4ee5 `x:` \u5f00\u59cb\uff0c\u81ea\u5b9a\u4e49\u53d8\u91cf\u683c\u5f0f\u53ca\u8bf4\u660e\u8bf7\u53c2\u8003 [\u6587\u6863](https:\/\/developer.qiniu.com\/kodo\/manual\/1235\/vars)\n - metadata: `object`\uff0c\u7528\u6765\u9632\u6b62\u81ea\u5b9a\u4e49 meta\uff0c\u53d8\u91cf\u540d\u5fc5\u987b\u4ee5 `x-qn-meta-`\u5f00\u59cb\uff0c\u81ea\u5b9a\u4e49\u8d44\u6e90\u4fe1\u606f\u683c\u5f0f\u53ca\u8bf4\u660e\u8bf7\u53c2\u8003 [\u6587\u6863](https:\/\/developer.qiniu.com\/kodo\/api\/1252\/chgm)\n - mimeType: `string`\uff0c\u6307\u5b9a\u6240\u4f20\u7684\u6587\u4ef6\u7c7b\u578b\n\n### qiniu.region: object\n\n- **qiniu.region.z0**: \u4ee3\u8868\u534e\u4e1c\u533a\u57df\n- **qiniu.region.z1**: \u4ee3\u8868\u534e\u5317\u533a\u57df\n- **qiniu.region.z2**: \u4ee3\u8868\u534e\u5357\u533a\u57df\n- **qiniu.region.na0**: \u4ee3\u8868\u5317\u7f8e\u533a\u57df\n- **qiniu.region.as0**: \u4ee3\u8868\u65b0\u52a0\u5761\u533a\u57df\n\n### qiniu.getUploadUrl(config: object, token: string): Promise\n\n\u63a5\u6536\u53c2\u6570\u4e3a `config` \u5bf9\u8c61\uff0c\u8fd4\u56de\u6839\u636e `config` \u91cc\u6240\u914d\u7f6e\u4fe1\u606f\u7684\u4e0a\u4f20\u57df\u540d\n\n```JavaScript\n qiniu.getUploadUrl(config, token).then(res => {}) \/\/ res \u5373\u4e3a\u4e0a\u4f20\u7684 url\n```\n\n### qiniu.getHeadersForChunkUpload(token: string): object\n\n\u8fd4\u56de `object`\uff0c\u5305\u542b\u7528\u6765\u83b7\u5f97\u5206\u7247\u4e0a\u4f20\u8bbe\u7f6e\u7684\u5934\u4fe1\u606f\uff0c\u53c2\u6570\u4e3a `token` \u5b57\u7b26\u4e32\uff1b\u5f53\u5206\u7247\u4e0a\u4f20\u65f6\uff0c\u8bf7\u6c42\u9700\u8981\u5e26\u8be5\u51fd\u6570\u8fd4\u56de\u7684\u5934\u4fe1\u606f\n\n- **token**: \u540e\u7aef\u8fd4\u56de\u7684\u4e0a\u4f20\u9a8c\u8bc1\u4fe1\u606f\n\n ```JavaScript\n const headers = qiniu.getHeadersForChunkUpload(token)\n ```\n\n### qiniu.deleteUploadedChunks(token: string, key: stting, uploadInfo: object): Promise\n\n\u5220\u9664\u6307\u5b9a\u4e0a\u4f20\u4efb\u52a1\u4e2d\u5df2\u4e0a\u4f20\u5b8c\u6210\u7684\u7247\uff0c`key` \u4e3a\u76ee\u6807\u6587\u4ef6\u540d\uff0c`uploadInfo` \u53ef\u901a\u8fc7 `next` \u7684\u8fd4\u56de\u83b7\u53d6\uff0c`token` \u7531\u670d\u52a1\u7aef\u751f\u6210\n\n### qiniu.compressImage(file: File, options: object): Promise (\u4e0a\u4f20\u524d\u56fe\u7247\u538b\u7f29)\n\n**\u5728 v3.3.3 \u7248\u672c\u4e4b\u524d\uff0c\u8be5\u538b\u7f29\u884c\u4e3a\u4f1a\u6839\u636e\u56fe\u7247\u7684 `Orientation(\u8bbe\u5907\u89d2\u5ea6)` \u4fe1\u606f\u5bf9\u56fe\u7247\u8fdb\u884c\u65cb\u8f6c\u5904\u7406\uff0c\u8be6\u7ec6\u7684\u4fe1\u606f\u53ef\u4ee5\u53c2\u8003** [issue\uff1a\u5173\u4e8e canvas \u7ed8\u5236\u56fe\u50cf\u7684\u65b9\u5411\u517c\u5bb9\u5904\u7406](https:\/\/github.com\/qiniu\/js-sdk\/issues\/522)\n\n```JavaScript\n const imgLink = qiniu.compressImage(file, options).then(res => {\n \/\/ res : {\n \/\/ dist: \u538b\u7f29\u540e\u8f93\u51fa\u7684 Blob \u5bf9\u8c61\u6216\u539f\u59cb\u7684 File \u5bf9\u8c61\uff0c\u5177\u4f53\u770b\u4e0b\u9762\u7684 options \u914d\u7f6e\n \/\/ width: \u538b\u7f29\u540e\u7684\u56fe\u7247\u5bbd\u5ea6\n \/\/ height: \u538b\u7f29\u540e\u7684\u56fe\u7247\u9ad8\u5ea6\n \/\/ }\n }\n })\n```\n\n- file: \u8981\u538b\u7f29\u7684\u6e90\u56fe\u7247\uff0c\u4e3a `File` \u5bf9\u8c61\uff0c\u652f\u6301 `image\/png`\u3001`image\/jpeg`\u3001`image\/bmp`\u3001`image\/webp` \u8fd9\u51e0\u79cd\u56fe\u7247\u7c7b\u578b\n\n- options:\n\n \n\n ```\n object\n ```\n\n - options.quality: `number`\uff0c\u56fe\u7247\u538b\u7f29\u8d28\u91cf\uff0c\u5728\u56fe\u7247\u683c\u5f0f\u4e3a `image\/jpeg` \u6216 `image\/webp` \u7684\u60c5\u51b5\u4e0b\u751f\u6548\uff0c\u5176\u4ed6\u683c\u5f0f\u4e0d\u4f1a\u751f\u6548\uff0c\u53ef\u4ee5\u4ece 0 \u5230 1 \u7684\u533a\u95f4\u5185\u9009\u62e9\u56fe\u7247\u7684\u8d28\u91cf\u3002\u9ed8\u8ba4\u503c 0.92\n - options.maxWidh: `number`\uff0c\u538b\u7f29\u56fe\u7247\u7684\u6700\u5927\u5bbd\u5ea6\u503c\n - options.maxHeight: `number`\uff0c\u538b\u7f29\u56fe\u7247\u7684\u6700\u5927\u9ad8\u5ea6\u503c \uff08\u6ce8\u610f\uff1a\u5f53 `maxWidth` \u548c `maxHeight` \u90fd\u4e0d\u8bbe\u7f6e\u65f6\uff0c\u5219\u91c7\u7528\u539f\u56fe\u5c3a\u5bf8\u5927\u5c0f\uff09\n - options.noCompressIfLarger: `boolean`\uff0c\u4e3a `true` \u65f6\u5982\u679c\u53d1\u73b0\u538b\u7f29\u540e\u56fe\u7247\u5927\u5c0f\u6bd4\u539f\u6765\u8fd8\u5927\uff0c\u5219\u8fd4\u56de\u6e90\u56fe\u7247\uff08\u5373\u8f93\u51fa\u7684 dist \u76f4\u63a5\u8fd4\u56de\u4e86\u8f93\u5165\u7684 file\uff09\uff1b\u9ed8\u8ba4 `false`\uff0c\u5373\u4fdd\u8bc1\u56fe\u7247\u5c3a\u5bf8\u7b26\u5408\u8981\u6c42\uff0c\u4f46\u4e0d\u4fdd\u8bc1\u538b\u7f29\u540e\u7684\u56fe\u7247\u4f53\u79ef\u4e00\u5b9a\u53d8\u5c0f\n\n- CompressResult:\n\n \n\n ```\n object\n ```\n\n \uff0c\u5305\u542b\u5982\u4e0b\u5b57\u6bb5\uff1a\n\n - dist: \u538b\u7f29\u540e\u8f93\u51fa\u7684 Blob \u5bf9\u8c61\u6216\u539f\u59cb\u7684 File \u5bf9\u8c61\n - width: \u538b\u7f29\u540e\u7684\u56fe\u7247\u5bbd\u5ea6\n - height: \u538b\u7f29\u540e\u7684\u56fe\u7247\u9ad8\u5ea6\n\n### qiniu.watermark(options: object, key?: string, domain?: string): string\uff08\u6c34\u5370\uff09\n\n\u8fd4\u56de\u6dfb\u52a0\u6c34\u5370\u540e\u7684\u56fe\u7247\u5730\u5740\n\n- **key** : \u6587\u4ef6\u8d44\u6e90\u540d\n\n- **domain**: \u4e3a\u7a7a\u95f4\uff08bucket)\u5bf9\u5e94\u7684\u57df\u540d\uff0c\u9009\u62e9\u67d0\u4e2a\u7a7a\u95f4\u540e\uff0c\u53ef\u901a\u8fc7\"\u7a7a\u95f4\u8bbe\u7f6e->\u57fa\u672c\u8bbe\u7f6e->\u57df\u540d\u8bbe\u7f6e\"\u67e5\u770b\u83b7\u53d6\uff0c\u524d\u7aef\u53ef\u4ee5\u901a\u8fc7\u63a5\u53e3\u8bf7\u6c42\u540e\u7aef\u5f97\u5230\n\n ```JavaScript\n const imgLink = qiniu.watermark({\n mode: 1, \/\/ \u56fe\u7247\u6c34\u5370\n image: 'http:\/\/www.b1.qiniudn.com\/images\/logo-2.png', \/\/ \u56fe\u7247\u6c34\u5370\u7684Url\uff0cmode = 1 \u65f6 **\u5fc5\u9700**\n dissolve: 50, \/\/ \u900f\u660e\u5ea6\uff0c\u53d6\u503c\u8303\u56f41-100\uff0c\u975e\u5fc5\u9700\uff0c\u4e0b\u540c\n gravity: 'SouthWest', \/\/ \u6c34\u5370\u4f4d\u7f6e\uff0c\u4e3a\u4ee5\u4e0b\u53c2\u6570 [NorthWest\u3001North\u3001NorthEast\u3001West\u3001Center\u3001East\u3001SouthWest\u3001South\u3001SouthEast] \u4e4b\u4e00\n dx: 100, \/\/ \u6a2a\u8f74\u8fb9\u8ddd\uff0c\u5355\u4f4d:\u50cf\u7d20(px)\n dy: 100 \/\/ \u7eb5\u8f74\u8fb9\u8ddd\uff0c\u5355\u4f4d:\u50cf\u7d20(px)\n }, key, domain)\n \n \/\/ imgLink \u53ef\u4ee5\u8d4b\u503c\u7ed9 html \u7684 img \u5143\u7d20\u7684 src \u5c5e\u6027\uff0c\u4e0b\u540c\n \n \/\/ \u82e5\u672a\u6307\u5b9akey\uff0c\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u65b9\u5f0f\u83b7\u5f97\u5b8c\u6574\u7684 imgLink\uff0c\u4e0b\u540c\n \/\/ imgLink = '<domain>\/<key>?' + imgLink\n \/\/ <domain> \u4e3a\u7a7a\u95f4\uff08bucket)\u5bf9\u5e94\u7684\u57df\u540d\uff0c\u9009\u62e9\u67d0\u4e2a\u7a7a\u95f4\u540e\uff0c\u53ef\u901a\u8fc7\"\u7a7a\u95f4\u8bbe\u7f6e->\u57fa\u672c\u8bbe\u7f6e->\u57df\u540d\u8bbe\u7f6e\"\u67e5\u770b\u83b7\u53d6\n \n \/\/ \u6216\u8005\n \n const imgLink = qiniu.watermark({\n mode: 2, \/\/ \u6587\u5b57\u6c34\u5370\n text: 'hello world !', \/\/ \u6c34\u5370\u6587\u5b57\uff0cmode = 2 \u65f6 **\u5fc5\u9700**\n dissolve: 50, \/\/ \u900f\u660e\u5ea6\uff0c\u53d6\u503c\u8303\u56f41-100\uff0c\u975e\u5fc5\u9700\uff0c\u4e0b\u540c\n gravity: 'SouthWest', \/\/ \u6c34\u5370\u4f4d\u7f6e\uff0c\u540c\u4e0a\n fontsize: 500, \/\/ \u5b57\u4f53\u5927\u5c0f\uff0c\u5355\u4f4d: \u7f07\n font: '\u9ed1\u4f53', \/\/ \u6c34\u5370\u6587\u5b57\u5b57\u4f53\n dx: 100, \/\/ \u6a2a\u8f74\u8fb9\u8ddd\uff0c\u5355\u4f4d:\u50cf\u7d20(px)\n dy: 100, \/\/ \u7eb5\u8f74\u8fb9\u8ddd\uff0c\u5355\u4f4d:\u50cf\u7d20(px)\n fill: '#FFF000' \/\/ \u6c34\u5370\u6587\u5b57\u989c\u8272\uff0cRGB\u683c\u5f0f\uff0c\u53ef\u4ee5\u662f\u989c\u8272\u540d\u79f0\n }, key, domain)\n ```\n\n options\u5305\u542b\u7684\u5177\u4f53\u6c34\u5370\u53c2\u6570\u89e3\u91ca\u89c1 \u6c34\u5370\uff08watermark\uff09\n\n### qiniu.imageView2(options: object, key?: string, domain?: string): string (\u7f29\u7565)\n\n\u8fd4\u56de\u5904\u7406\u540e\u7684\u56fe\u7247url\n\n```JavaScript\n const imgLink = qiniu.imageView2({\n mode: 3, \/\/ \u7f29\u7565\u6a21\u5f0f\uff0c\u5171 6 \u79cd [0-5]\n w: 100, \/\/ \u5177\u4f53\u542b\u4e49\u7531\u7f29\u7565\u6a21\u5f0f\u51b3\u5b9a\n h: 100, \/\/ \u5177\u4f53\u542b\u4e49\u7531\u7f29\u7565\u6a21\u5f0f\u51b3\u5b9a\n q: 100, \/\/ \u65b0\u56fe\u7684\u56fe\u50cf\u8d28\u91cf\uff0c\u53d6\u503c\u8303\u56f4\uff1a1-100\n format: 'png' \/\/ \u65b0\u56fe\u7684\u8f93\u51fa\u683c\u5f0f\uff0c\u53d6\u503c\u8303\u56f4\uff1ajpg\uff0cgif\uff0cpng\uff0cwebp \u7b49\n }, key, domain)\n```\n\noptions\u5305\u542b\u7684\u5177\u4f53\u7f29\u7565\u53c2\u6570\u89e3\u91ca\u89c1 \u56fe\u7247\u57fa\u672c\u5904\u7406\uff08imageView2\uff09\n\n### qiniu.imageMogr2(options: object, key?: string, domain?: string): string (\u56fe\u50cf\u9ad8\u7ea7\u5904\u7406)\n\n\u8fd4\u56de\u5904\u7406\u540e\u7684\u56fe\u7247url\n\n```JavaScript\n const imgLink = qiniu.imageMogr2({\n \"auto-orient\": true, \/\/ \u5e03\u5c14\u503c\uff0c\u662f\u5426\u6839\u636e\u539f\u56feEXIF\u4fe1\u606f\u81ea\u52a8\u65cb\u6b63\uff0c\u4fbf\u4e8e\u540e\u7eed\u5904\u7406\uff0c\u5efa\u8bae\u653e\u5728\u9996\u4f4d\u3002\n strip: true, \/\/ \u5e03\u5c14\u503c\uff0c\u662f\u5426\u53bb\u9664\u56fe\u7247\u4e2d\u7684\u5143\u4fe1\u606f\n thumbnail: '1000x1000' \/\/ \u7f29\u653e\u64cd\u4f5c\u53c2\u6570\n crop: '!300x400a10a10', \/\/ \u88c1\u526a\u64cd\u4f5c\u53c2\u6570\n gravity: 'NorthWest', \/\/ \u88c1\u526a\u951a\u70b9\u53c2\u6570\n quality: 40, \/\/ \u56fe\u7247\u8d28\u91cf\uff0c\u53d6\u503c\u8303\u56f41-100\n rotate: 20, \/\/ \u65cb\u8f6c\u89d2\u5ea6\uff0c\u53d6\u503c\u8303\u56f41-360\uff0c\u7f3a\u7701\u4e3a\u4e0d\u65cb\u8f6c\u3002\n format: 'png', \/\/ \u65b0\u56fe\u7684\u8f93\u51fa\u683c\u5f0f\uff0c\u53d6\u503c\u8303\u56f4\uff1ajpg\uff0cgif\uff0cpng\uff0cwebp\u7b49\n blur: '3x5' \/\/ \u9ad8\u65af\u6a21\u7cca\u53c2\u6570\n }, key, domain)\n```\n\noptions\u5305\u542b\u7684\u5177\u4f53\u9ad8\u7ea7\u56fe\u50cf\u5904\u7406\u53c2\u6570\u89e3\u91ca\u89c1 \u56fe\u50cf\u9ad8\u7ea7\u5904\u7406\uff08imageMogr2\uff09\n\n### qiniu.imageInfo(key: string, domain: string): Promise\n\n```JavaScript\n qiniu.imageInfo(key, domain).then(res => {})\n```\n\n\u5177\u4f53 imageInfo \u89e3\u91ca\u89c1 \u56fe\u7247\u57fa\u672c\u4fe1\u606f\uff08imageInfo\uff09\n\n### qiniu.exif(key: string, domain: string): Promise\n\n```JavaScript\n qiniu.exif(key, domain).then(res => {})\n```\n\n\u5177\u4f53 exif \u89e3\u91ca\u89c1 \u56fe\u7247 EXIF \u4fe1\u606f\uff08exif\uff09\n\n### qiniu.pipeline(fopArr: array, key?: string, domain?: string): string\n\n```JavaScript\n const fopArr = [{\n fop: 'watermark', \/\/ \u6307\u5b9awatermark\u64cd\u4f5c\n mode: 2, \/\/ \u6b64\u53c2\u6570\u540cwatermark\u51fd\u6570\u7684\u53c2\u6570\uff0c\u4e0b\u540c\u3002\n text: 'hello world !',\n dissolve: 50,\n gravity: 'SouthWest',\n fontsize: 500,\n font : '\u9ed1\u4f53',\n dx: 100,\n dy: 100,\n fill: '#FFF000'\n },{\n fop: 'imageView2', \/\/ \u6307\u5b9aimageView2\u64cd\u4f5c\n mode: 3, \/\/ \u6b64\u53c2\u6570\u540cimageView2\u51fd\u6570\u7684\u53c2\u6570\uff0c\u4e0b\u540c\n w: 100,\n h: 100,\n q: 100,\n format: 'png'\n },{\n fop: 'imageMogr2', \/\/ \u6307\u5b9aimageMogr2\u64cd\u4f5c\n \"auto-orient\": true, \/\/ \u6b64\u53c2\u6570\u540cimageMogr2\u51fd\u6570\u7684\u53c2\u6570\uff0c\u4e0b\u540c\u3002\n strip: true,\n thumbnail: '1000x1000'\n crop: '!300x400a10a10',\n gravity: 'NorthWest',\n quality: 40,\n rotate: 20,\n format: 'png',\n blur:'3x5'\n }]\n\n \/\/ fopArr \u53ef\u4ee5\u4e3a\u4e09\u79cd\u7c7b\u578b'watermark'\u3001'imageMogr2'\u3001'imageView2'\u4e2d\u7684\u4efb\u610f1-3\u4e2a\n \/\/ \u4f8b\u5982\u53ea\u5bf9'watermark'\u3001'imageMogr2'\u8fdb\u884c\u7ba1\u9053\u64cd\u4f5c\uff0c\u5219\u5982\u4e0b\u5373\u53ef\n \/\/ const fopArr = [{\n \/\/ fop: 'watermark', \/\/ \u6307\u5b9awatermark\u64cd\u4f5c\n \/\/ mode: 2, \/\/ \u6b64\u53c2\u6570\u540cwatermark\u51fd\u6570\u7684\u53c2\u6570\uff0c\u4e0b\u540c\u3002\n \/\/ text: 'hello world !',\n \/\/ dissolve: 50,\n \/\/ gravity: 'SouthWest',\n \/\/ fontsize: 500,\n \/\/ font : '\u9ed1\u4f53',\n \/\/ dx: 100,\n \/\/ dy: 100,\n \/\/ fill: '#FFF000'\n \/\/ },{\n \/\/ fop: 'imageMogr2', \/\/ \u6307\u5b9aimageMogr2\u64cd\u4f5c\n \/\/ \"auto-orient\": true, \/\/ \u6b64\u53c2\u6570\u540cimageMogr2\u51fd\u6570\u7684\u53c2\u6570\uff0c\u4e0b\u540c\u3002\n \/\/ strip: true,\n \/\/ thumbnail: '1000x1000'\n \/\/ crop: '!300x400a10a10',\n \/\/ gravity: 'NorthWest',\n \/\/ quality: 40,\n \/\/ rotate: 20,\n \/\/ format: 'png',\n \/\/ blur:'3x5'\n \/\/ }];\n\n const imgLink = qiniu.pipeline(fopArr, key, domain))\n```\n\nfopArr\u5305\u542b\u7684\u5177\u4f53\u7ba1\u9053\u64cd\u4f5c\u89e3\u91ca\u89c1 \u7ba1\u9053\u64cd\u4f5c\n\n### \u8fd0\u884c\u793a\u4f8b\n\n1. \u8fdb\u5165 test \u76ee\u5f55\uff0c\u6309\u7167\u76ee\u5f55\u4e0b\u7684 `config.json.example` \u793a\u4f8b\uff0c\u521b\u5efa `config.json` \u6587\u4ef6\uff0c\u5176\u4e2d\uff0c`Access Key` \u548c `Secret Key` \u6309\u5982\u4e0b\u65b9\u5f0f\u83b7\u53d6\n\n 1.\u767b\u5f55\u63a7\u5236\u53f0\n\n 2.\u70b9\u51fb\u53f3\u4e0a\u89d2\uff0c\u8fdb\u5165\u5bc6\u94a5\u7ba1\u7406\u9875\u9762\u67e5\u770bAccessKey \u548c SecretKey\n\n ```javascript\n {\n \"AccessKey\": \"<Your Access Key>\",\n \"SecretKey\": \"<Your Secret Key>\",\n \"Bucket\": \"<Your Bucket Name>\",\n \"Port\": 9000,\n \"UptokenUrl\": \"<Your Uptoken_Url>\", \/\/ demo \u542f\u52a8\u540e\u4f1a\u5728\u672c\u5730 \/uptoken \u4e0a\u63d0\u4f9b\u83b7\u53d6 uptoken \u7684\u63a5\u53e3\uff0c\u6240\u4ee5\u8fd9\u91cc\u53ef\u4ee5\u586b 'token'\n \"Domain\": \"<Your Bucket Domain>\" \/\/ Bucket \u7684\u5916\u94fe\u9ed8\u8ba4\u57df\u540d\uff0c\u5728 Bucket \u7684\u5185\u5bb9\u7ba1\u7406\u91cc\u67e5\u770b\uff0c\u5982\uff1a'http:\/\/xxx.bkt.clouddn.com\/'\n }\n ```\n\n2. \u8fdb\u5165\u9879\u76ee\u6839\u76ee\u5f55\uff0c\u6267\u884c `npm install` \u5b89\u88c5\u4f9d\u8d56\u5e93\uff0c\u7136\u540e\u6253\u5f00\u4e24\u4e2a\u7ec8\u7aef\uff0c\u4e00\u4e2a\u6267\u884c `npm run serve` \u8dd1 server\uff0c \u4e00\u4e2a\u6267\u884c `npm run dev` \u8fd0\u884c\u670d\u52a1\uff1bdemo1\uff1a`http:\/\/0.0.0.0:8080\/test\/demo1`\uff1bdemo3\uff1a`http:\/\/0.0.0.0:8080\/test\/demo3`\uff1bdemo1\u4e3a\u6d4b\u8bd5\u4e0a\u4f20\u529f\u80fd\u7684\u793a\u4f8b\uff0cdemo3\u4e3a\u6d4b\u8bd5\u56fe\u7247\u538b\u7f29\u529f\u80fd\u7684\u793a\u4f8b\uff1bdemo2 \u4e3a\u6d4b\u8bd5 es6 \u8bed\u6cd5\u7684\u793a\u4f8b\uff0c\u8fdb\u5165 demo2 \u76ee\u5f55\uff0c\u6267\u884c `npm install`\uff0c\u7136\u540e `npm start` \u8fd0\u884c demo2\uff1bdemo1\u3001demo2 \u548c demo3 \u90fd\u5171\u7528\u4e00\u4e2a server\uff0c\u8bf7\u6ce8\u610f server \u6587\u4ef6\u91cc\u7684 `region` \u8bbe\u7f6e\u8ddf `config` \u91cc\u7684`region` \u8bbe\u7f6e\u8981\u4fdd\u6301\u4e00\u81f4\u3002\n\n\n\n### \u8bf4\u660e\n\n1. \u5982\u679c\u60a8\u60f3\u4e86\u89e3\u66f4\u591a\u4e0a\u4f20\u7b56\u7565\uff0c\u5efa\u8bae\u60a8\u4ed4\u7ec6\u9605\u8bfb \u4e0a\u4f20\u3002\u53e6\u5916\uff0c\u4e0a\u4f20\u7b56\u7565\u662f\u5728\u540e\u7aef\u670d\u52a1\u6307\u5b9a\u7684.\n2. \u5982\u679c\u60a8\u60f3\u4e86\u89e3\u66f4\u591a\u56fe\u7247\u5904\u7406\uff0c\u5efa\u8bae\u60a8\u4ed4\u7ec6\u9605\u8bfb \u56fe\u7247\u5904\u7406\n3. JS-SDK \u793a\u4f8b\u751f\u6210 `token` \u65f6\uff0c\u6307\u5b9a\u7684 `Bucket Name` \u4e3a\u516c\u5f00\u7a7a\u95f4\uff0c\u6240\u4ee5\u53ef\u4ee5\u516c\u5f00\u8bbf\u95ee\u4e0a\u4f20\u6210\u529f\u540e\u7684\u8d44\u6e90\u3002\u82e5\u60a8\u751f\u6210 `token` \u65f6\uff0c\u6307\u5b9a\u7684 `Bucket Name` \u4e3a\u79c1\u6709\u7a7a\u95f4\uff0c\u90a3\u60a8\u8fd8\u9700\u8981\u5728\u670d\u52a1\u7aef\u8fdb\u884c\u989d\u5916\u7684\u5904\u7406\u624d\u80fd\u8bbf\u95ee\u60a8\u4e0a\u4f20\u7684\u8d44\u6e90\u3002\u5177\u4f53\u53c2\u89c1 \u4e0b\u8f7d\u51ed\u8bc1\u3002JS-SDK \u6570\u636e\u5904\u7406\u90e8\u5206\u529f\u80fd\u4e0d\u9002\u7528\u4e8e\u79c1\u6709\u7a7a\u95f4\u3002\n\n\n\n### \u5e38\u89c1\u95ee\u9898\n\n**1. \u5173\u4e8e\u4e0a\u4f20\u6587\u4ef6\u547d\u540d\u95ee\u9898\uff0c\u53ef\u4ee5\u53c2\u8003\uff1a**\n\n1. \u4e0a\u4f20\u7684 scope \u4e3a `bucket` \u7684\u5f62\u5f0f\uff0c\u4e0a\u4f20\u540e\u6587\u4ef6\u8d44\u6e90\u540d\u4ee5\u8bbe\u7f6e\u7684 `key` \u4e3a\u4e3b\uff0c\u5982\u679c `key` \u4e3a `null` \u6216\u8005 `undefined`\uff0c\u5219\u6587\u4ef6\u8d44\u6e90\u540d\u4f1a\u4ee5 hash \u503c\u4f5c\u4e3a\u8d44\u6e90\u540d\u3002\n2. \u4e0a\u4f20\u7684 scope \u4e3a `bucket:key` \u7684\u5f62\u5f0f\uff0c\u4e0a\u4f20\u6587\u4ef6\u672c\u5730\u7684\u540d\u5b57\u9700\u8981\u548c scope \u4e2d\u7684 `key` \u662f\u4e00\u81f4\u7684\uff0c\u4e0d\u7136\u4f1a\u62a5\u9519 key doesn\u2018t match with scope\u3002\n3. \u4e0a\u4f20\u7684 scope \u4e3a `bucket`\uff0c\u4f46\u662f `token` \u4e2d\u6709\u8bbe\u5b9a `saveKey`\uff0c\u8fd9\u79cd\u5f62\u5f0f\u4e0b\u5ba2\u6237\u7aef\u7684 `key` \u5982\u679c\u8bbe\u5b9a\u4e3a `null` \u6216\u8005 `undefined`\uff0c\u5219\u4f1a\u4ee5 `saveKey` \u4f5c\u4e3a\u6587\u4ef6\u8d44\u6e90\u540d\uff0c\u5426\u5219\u4ecd\u7136\u662f\u4ee5 `key` \u503c\u4f5c\u4e3a\u8d44\u6e90\u540d\uff0c\u5e76\u4e14\u4e0a\u4f20\u7684\u672c\u5730\u6587\u4ef6\u540d\u4e5f\u662f\u9700\u8981\u548c\u8fd9\u4e2a `savekey` \u6587\u4ef6\u540d\u4e00\u81f4\u7684\u3002\n\n**2. \u9650\u5236\u4e0a\u4f20\u6587\u4ef6\u7684\u7c7b\u578b\uff1a**\n\n\u901a\u8fc7\u5728\u751f\u6210 `token` \u65f6\u6307\u5b9a \u4e0a\u4f20\u7b56\u7565 \u4e2d\u7684 `mimeLimit` \u5b57\u6bb5\u9650\u5b9a\u4e0a\u4f20\u6587\u4ef6\u7684\u7c7b\u578b\uff0c\u8be5\u529f\u80fd\u7531\u751f\u6210 `token` \u7684\u670d\u52a1\u7aef SDK \u63d0\u4f9b\uff0c\u8bf7\u67e5\u770b\u5bf9\u5e94\u7684\u670d\u52a1\u7aef SDK \u6587\u6863\u3002\n\n"}