improve

mdn · Oct 14, 2023 · 01044b4 · 01044b4
1 parent 3af7e25
commit 01044b4
Show file tree

Hide file tree

Showing 3 changed files with 6 additions and 24 deletions.
diff --git a/files/en-us/web/api/filesystemdirectoryhandle/entries/index.md b/files/en-us/web/api/filesystemdirectoryhandle/entries/index.md
@@ -11,7 +11,7 @@ browser-compat: api.FileSystemDirectoryHandle.entries
 The **`entries()`** method of the
 {{domxref("FileSystemDirectoryHandle")}} interface returns a new asynchronous iterator
 for the iteration of the key-value pairs of the entries within the `FileSystemDirectoryHandle`
-on which this method is called. The order of iteration is uncertain. The key-value pairs are
+on which this method is called. The order of iteration is vague. The key-value pairs are
 in the form of an array like `[key, value]`.
 
 ## Syntax
@@ -26,13 +26,7 @@ None.
 
 ### Return value
 
-A new asynchronous iterator provides a {{jsxref('Promise')}} which fulfills with
-an object with the following properties:
-
-- `done`
-  - : A boolean value, representing if the iteration has ended.
-- `value`
-  - : An array, representing a key-value pair of an entry. The first element is a string representing the key of the entry. The second element is the {{domxref("FileSystemHandle")}} of the entry. If the iteration has ended, this property would be `undefined`.
+A new asynchronous iterator containing the key-value pairs of each entry within the `FileSystemDirectoryHandle`.
 
 ## Examples
 

diff --git a/files/en-us/web/api/filesystemdirectoryhandle/keys/index.md b/files/en-us/web/api/filesystemdirectoryhandle/keys/index.md
@@ -11,7 +11,7 @@ browser-compat: api.FileSystemDirectoryHandle.keys
 The **`keys()`** method of the
 {{domxref("FileSystemDirectoryHandle")}} interface returns a new asynchronous iterator
 for the iteration of the key of the entries within the `FileSystemDirectoryHandle`
-on which this method is called. The order of iteration is uncertain.
+on which this method is called. The order of iteration is vague.
 
 ## Syntax
 
@@ -25,13 +25,7 @@ None.
 
 ### Return value
 
-A new asynchronous iterator provides a {{jsxref('Promise')}} which fulfills with
-an object with the following properties:
-
-- `done`
-  - : A boolean value, representing if the iteration has ended.
-- `value`
-  - : A string, representing the key of an entry. If the iteration has ended, this property would be `undefined`.
+A new asynchronous iterator containing the key of each entry within the `FileSystemDirectoryHandle`.
 
 ## Examples
 

diff --git a/files/en-us/web/api/filesystemdirectoryhandle/values/index.md b/files/en-us/web/api/filesystemdirectoryhandle/values/index.md
@@ -11,7 +11,7 @@ browser-compat: api.FileSystemDirectoryHandle.values
 The **`values()`** method of the
 {{domxref("FileSystemDirectoryHandle")}} interface returns a new asynchronous iterator
 for the iteration of the value of the entries within the `FileSystemDirectoryHandle`
-on which this method is called. The order of iteration is uncertain.
+on which this method is called. The order of iteration is vague.
 
 ## Syntax
 
@@ -25,13 +25,7 @@ None.
 
 ### Return value
 
-A new asynchronous iterator provides a {{jsxref('Promise')}} which fulfills with
-an object with the following properties:
-
-- `done`
-  - : A boolean value, representing if the iteration has ended.
-- `value`
-  - : A {{domxref("FileSystemHandle")}} object. The handle of the entry. If the iteration has ended, this property would be `undefined`.
+A new asynchronous iterator containing the handles of each entry within the `FileSystemDirectoryHandle`.
 
 ## Examples