chore: develop to master by xutao

README.md

@@ -1666,7 +1666,7 @@ parameters:
 - name {String} object name store on OSS
 - file {String|Buffer|ReadStream|File(only support Browser)|Blob(only support Browser)} object local path, content buffer or ReadStream content instance use in Node, Blob and html5 File
 - [options] {Object} optional parameters
- - [timeout] {Number} the operation timeout
+ - [timeout] {Number} the operation timeout (ms)
  - [mime] {String} custom mime, will send with `Content-Type` entity header
  - [meta] {Object} user meta, will send with `x-oss-meta-` prefix string
  e.g.: `{ uid: 123, pid: 110 }`
@@ -4557,7 +4557,29 @@ Each error return by OSS server will contains these properties:
  you can send this request id to OSS engineer to find out what's happend.
 - hostId {String} OSS cluster name for this request
 
-The following table lists the OSS error codes:
+### ResponseTimeoutError
+
+The default timeout is 60 seconds. Please set the timeout as needed. The timeout unit is milliseconds.
+
+```javascript
+client.get('example.txt', { timeout: 60000 * 2 });
+
+client.get('example.txt', { headers: { Range: `bytes=0-${1024 * 1024 * 100}` } }); // Download the first 100MB
+```
+
+### ConnectionTimeoutError
+
+The network link timed out. Please check the network status. If there is no problem with the network, please reduce the partSize or increase the timeout.
+
+```javascript
+const client = new OSS({ ak, sk, retryMax: 10 });
+
+client.multipartUpload('example.txt', { timeout: 60000 * 2 });
+
+client.multipartUpload('example.txt', { partSize: 1024 * 512 }); // partSize 512KB
+```
+
+### The following table lists the OSS error codes:
 
 [More code info](https://help.aliyun.com/knowledge_detail/32005.html)
 

lib/client.js

@@ -223,7 +223,14 @@ async function request(params) {
  }
 
  if (err.name === 'ResponseTimeoutError') {
- err.message = `${err.message.split(',')[0]}, please increase the timeout or use multipartDownload.`;
+ err.message = `${
+ err.message.split(',')[0]
+ }, please increase the timeout, see more details at https://github.com/ali-sdk/ali-oss#responsetimeouterror`;
+ }
+ if (err.name === 'ConnectionTimeoutError') {
+ err.message = `${
+ err.message.split(',')[0]
+ }, please increase the timeout or reduce the partSize, see more details at https://github.com/ali-sdk/ali-oss#connectiontimeouterror`;
  }
  throw err;
  }

lib/common/object/head.js

@@ -1,3 +1,4 @@
+const { checkEnv } = require('../utils/checkEnv');
 const proto = exports;
 /**
  * head
@@ -7,6 +8,9 @@ const proto = exports;
  */
 
 proto.head = async function head(name, options = {}) {
+ checkEnv(
+ 'Because HeadObject has gzip enabled, head cannot get the file size correctly. If you need to get the file size, please use getObjectMeta'
+ );
  options.subres = Object.assign({}, options.subres);
  if (options.versionId) {
  options.subres.versionId = options.versionId;

lib/common/utils/checkEnv.d.ts

@@ -0,0 +1 @@
+export declare function checkEnv(msg: string): void;

lib/common/utils/checkEnv.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkEnv = void 0;
+function checkEnv(msg) {
+ if (process.browser) {
+ console.warn(msg);
+ }
+}
+exports.checkEnv = checkEnv;

lib/common/utils/checkEnv.ts

@@ -0,0 +1,5 @@
+export function checkEnv(msg: string) {
+ if (process.browser) {
+ console.warn(msg);
+ }
+}

lib/common/utils/createRequest.js

@@ -11,6 +11,7 @@ const { encoder } = require('./encoder');
 const { isIP } = require('./isIP');
 const { setRegion } = require('./setRegion');
 const { getReqUrl } = require('../client/getReqUrl');
+const { isDingTalk } = require('./isDingTalk');
 function getHeader(headers, name) {
  return headers[name] || headers[name.toLowerCase()];
 }
@@ -43,6 +44,9 @@ function createRequest(params) {
  if (params.mime && params.mime.indexOf('/') > 0) {
  headers['Content-Type'] = params.mime;
  }
+ else if (isDingTalk()) {
+ headers['Content-Type'] = 'application/octet-stream';
+ }
  else {
  headers['Content-Type'] = mime.getType(params.mime || path.extname(params.object || ''));
  }

lib/common/utils/createRequest.ts

@@ -8,6 +8,7 @@ const { encoder } = require('./encoder');
 const { isIP } = require('./isIP');
 const { setRegion } = require('./setRegion');
 const { getReqUrl } = require('../client/getReqUrl');
+const { isDingTalk } = require('./isDingTalk');
 
 interface Headers {
  [propName: string]: any;
@@ -58,6 +59,8 @@ export function createRequest(this: any, params) {
  if (!getHeader(headers, 'Content-Type')) {
  if (params.mime && params.mime.indexOf('/') > 0) {
  headers['Content-Type'] = params.mime;
+ } else if (isDingTalk()) {
+ headers['Content-Type'] = 'application/octet-stream';
  } else {
  headers['Content-Type'] = mime.getType(params.mime || path.extname(params.object || ''));
  }

lib/common/utils/isDingTalk.d.ts

@@ -0,0 +1 @@
+export declare function isDingTalk(): boolean;

lib/common/utils/isDingTalk.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDingTalk = void 0;
+function isDingTalk() {
+ if (process.browser && window.navigator.userAgent.toLowerCase().includes('aliapp(dingtalk')) {
+ return true;
+ }
+ return false;
+}
+exports.isDingTalk = isDingTalk;

lib/common/utils/isDingTalk.ts

@@ -0,0 +1,6 @@
+export function isDingTalk() {
+ if (process.browser && window.navigator.userAgent.toLowerCase().includes('aliapp(dingtalk')) {
+ return true;
+ }
+ return false;
+}

test/browser/browser.test.js

@@ -726,9 +726,6 @@ describe('browser', () => {
  timeout: 300
  };
  try {
- setTimeout(() => {
- options.timeout = 60000;
- }, 200);
  await store.put(name, body, options);
  assert(false);
  } catch (error) {