Update reference.ts

Author: fredzqm

packages/storage/src/reference.ts

@@ -206,15 +206,15 @@ export class Reference {
   /**
    * List all items (files) and prefixes (folders) under this storage reference.
    *
-   * This is a helper method for calling list() repeatedly until there are no
-   * more results. The default pagination size is 1000.
-   *
-   * Note: The results may not be a consistent snapshot if objects are changed
-   * between paginating requests.
-   *
    * This is a helper method for calling list() repeatedly until there are
    * no more results. The default pagination size is 1000.
    *
+   * Note: The results may not be consistent if objects are changed while this
+   * operation is running.
+   *
+   * Warning: listAll may potentially consume too many resources if there are
+   * too many results.
+   *
    * @return A Promise that resolves with all the items and prefixes under
    *      the current storage reference. `prefixes` contains references to
    *      sub-directories and `items` contains references to objects in this
@@ -244,15 +244,15 @@ export class Reference {
       await this.listAllHelper(accumulator, nextPage.nextPageToken);
     }
   }
-
+  
   /**
    * List items (files) and prefixes (folders) under this storage reference.
    *
    * GCS is a key-blob store. Firebase Storage imposes the semantic of '/'
    * delimited folder structure.
    * Refer to GCS's List API if you want to learn more.
    *
-   * To adhere to Firebase Rules's Semantics, Firebase storage does not
+   * To adhere to Firebase Rules's Semantics, Firebase Storage does not
    * support objects whose paths end with "/" or contain two consecutive
    * "/"s. Firebase Storage List API will filter these unsupported objects.
    * list() may fail if there are too many unsupported objects in the bucket.
@@ -262,7 +262,7 @@ export class Reference {
    *      Use the nextPageToken to retrieve more objects.
    * @param options.pageToken The `nextPageToken` from a previous call to
    *      list(). If provided, listing is resumed from the previous position.
-   * @return A promise that resolves with the items and prefixes.
+   * @return A Promise that resolves with the items and prefixes.
    *      `prefixes` contains references to sub-folders and `items`
    *      contains references to objects in this folder. `nextPageToken`
    *      can be used to get the rest of the results.