fix: browser test and listV2 docs (#901)

README.md

@@ -125,6 +125,7 @@ All operation use es7 async/await to implement. All api is async function.
 
 - [Object Operations](#object-operations)
  - [.list(query[, options])](#listquery-options)
+ - [.listV2(query[, options])](#listV2query-options)
  - [.getBucketVersions(query[, options])](#getBucketVersionsquery-options)
  - [.put(name, file[, options])](#putname-file-options)
  - [.putStream(name, stream[, options])](#putstreamname-stream-options)
@@ -2289,6 +2290,83 @@ const result = await store.list({
 console.log(result.objects);
 ```
 
+### .listV2(query[, options])
+
+List objects in the bucket.(recommended)
+
+parameters:
+
+- [query] {Object} query parameters, default is `null`
+ - [prefix] {String} search object using `prefix` key
+ - [continuationToken] {String} search start from `continuationToken`, including `continuationToken` key
+ - [delimiter] {String} delimiter search scope
+ e.g. `/` only search current dir, not including subdir
+ - [max-keys] {String|Number} max objects, default is `100`, limit to `1000`
+ - [start-after] {String} specifies the Start-after value from which to start the list. The names of objects are returned in alphabetical order.
+ - [fetch-owner] {Boolean} specifies whether to include the owner information in the response.
+- [options] {Object} optional parameters
+ - [timeout] {Number} the operation timeout
+
+Success will return objects list on `objects` properties.
+
+- objects {Array<ObjectMeta>} object meta info list
+ Each `ObjectMeta` will contains blow properties:
+ - name {String} object name on oss
+ - url {String} resource url
+ - lastModified {String} object last modified GMT date, e.g.: `2015-02-19T08:39:44.000Z`
+ - etag {String} object etag contains `"`, e.g.: `"5B3C1A2E053D763E1B002CC607C5A0FE"`
+ - type {String} object type, e.g.: `Normal`
+ - size {Number} object size, e.g.: `344606`
+ - storageClass {String} storage class type, e.g.: `Standard`
+ - owner {Object|null} object owner, including `id` and `displayName`
+- prefixes {Array<String>} prefix list
+- isTruncated {Boolean} truncate or not
+- nextContinuationToken {String} next continuation-token string
+- res {Object} response info, including
+ - status {Number} response status
+ - headers {Object} response headers
+ - size {Number} response size
+ - rt {Number} request total use time (ms)
+
+- List top 10 objects
+
+```js
+const result = await store.listV2({
+ 'max-keys': 10
+});
+console.log(result.objects);
+```
+
+- List `fun/` dir including subdirs objects
+
+```js
+const result = await store.listV2({
+ prefix: 'fun/'
+});
+console.log(result.objects);
+```
+
+- List `fun/` dir objects, not including subdirs
+
+```js
+const result = await store.listV2({
+ prefix: 'fun/',
+ delimiter: '/'
+});
+console.log(result.objects);
+```
+
+- List `a/` dir objects, after `a/b` and include `a/b`
+
+```js
+const result = await store.listV2({
+ delimiter: '/',
+ prefix: 'a/',
+ 'start-after': 'b'
+});
+console.log(result.objects);
+```
+
 ### .getBucketVersions(query[, options])
 
 List the version information of all objects in the bucket, including the delete marker (Delete Marker).

package.json

@@ -25,7 +25,7 @@
  "test-cov": "nyc --reporter=lcov node_modules/.bin/_mocha -t 60000 -r thunk-mocha -r should test/node/*.test.js test/node/**/*.test.js",
  "jshint": "jshint .",
  "autod": "autod",
- "build-test": "MINIFY=1 node browser-build.js > test/browser/build/aliyun-oss-sdk.min.js && node task/browser-test-build.js > test/browser/build/tests.js",
+ "build-test": "MINIFY=1 node browser-build.js > test/browser/build/aliyun-oss-sdk.min.js && node -r dotenv/config task/browser-test-build.js > test/browser/build/tests.js",
  "browser-test": "npm run build-test && karma start",
  "build-dist": "npm run tsc && node browser-build.js > dist/aliyun-oss-sdk.js && MINIFY=1 node browser-build.js > dist/aliyun-oss-sdk.min.js",
  "publish-to-npm": "node publish-npm-check.js && npm publish",

test/browser/browser.test.js

@@ -472,8 +472,10 @@ describe('browser', () => {
 
  describe('listV2()', () => {
  let listPrefix;
+ let store;
  before(async () => {
  listPrefix = `${prefix}ali-sdk/listV2/`;
+ store = oss(ossConfig);
  await store.put(`${listPrefix}oss.jpg`, Buffer.from('oss.jpg'));
  await store.put(`${listPrefix}fun/test.jpg`, Buffer.from('fun/test.jpg'));
  await store.put(`${listPrefix}fun/movie/001.avi`, Buffer.from('fun/movie/001.avi'));
@@ -2060,14 +2062,15 @@ describe('browser', () => {
 
  it('should succeed when put with filename', async () => {
  const name = `ali-oss-test-retry-file-${Date.now()}`;
- const res = await store.put(name, );
+ const file = new File([1, 2, 3, 4, 5, 6, 7], name);
+ const res = await store.put(name, file);
  assert.strictEqual(res.res.status, 200);
  assert.strictEqual(testRetryCount, RETRY_MAX);
  const onlineFile = await store.get(name);
  assert.strictEqual(onlineFile.content.toString(), '1234567');
  });
 
- it.only('should fail when putStream', async () => {
+ it('should fail when putStream', async () => {
  autoRestoreWhenRETRY_LIMIE = false;
  const name = `ali-oss-test-retry-file-${Date.now()}`;
  const file = new File([1, 2, 3, 4, 5, 6, 7], name);