From 56b87cef8d83ef2b8aa7f6ab085eba8d4c001727 Mon Sep 17 00:00:00 2001 From: BSPR0002 <42113148+BSPR0002@users.noreply.github.com> Date: Sat, 9 Sep 2023 07:18:41 +0800 Subject: [PATCH 1/5] Init `FileSystemDirectoryHandle` --- .../entries/index.md | 45 +++++++ .../getdirectoryhandle/index.md | 63 +++++++++ .../getfilehandle/index.md | 65 ++++++++++ .../api/filesystemdirectoryhandle/index.md | 120 ++++++++++++++++++ .../filesystemdirectoryhandle/keys/index.md | 45 +++++++ .../removeentry/index.md | 67 ++++++++++ .../resolve/index.md | 68 ++++++++++ .../filesystemdirectoryhandle/values/index.md | 45 +++++++ 8 files changed, 518 insertions(+) create mode 100644 files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md create mode 100644 files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md create mode 100644 files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md create mode 100644 files/zh-cn/web/api/filesystemdirectoryhandle/index.md create mode 100644 files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md create mode 100644 files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md create mode 100644 files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md create mode 100644 files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md new file mode 100644 index 00000000000000..ac8e79929682db --- /dev/null +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md @@ -0,0 +1,45 @@ +--- +title: FileSystemDirectoryHandle：entries() 方法 +slug: Web/API/FileSystemDirectoryHandle/entries +--- + +{{securecontext_header}}{{APIRef("File System API")}} + +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`entries()`** 方法返回一个异步迭代器，用于迭代给定对象自身可枚举属性`[键, 值]`对，迭代顺序与 [`for...in`](/zh-CN/docs/Web/JavaScript/Reference/Statements/for...in) 循环的迭代顺序一致（不同之处在于 for-in 循环还会枚举原型链中的属性）。 + +## 语法 + +```js-nolint +entries() +``` + +### 参数 + +无。 + +### 返回值 + +迭代给定的 `FileSystemDirectoryHandle` 对象自身可枚举属性`[键, 值]`对的异步迭代器。 + +## 示例 + +```js +const dirHandle = await window.showDirectoryPicker(); + +for await (const [key, value] of dirHandle.entries()) { + console.log({ key, value }); +} +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [文件系统 API](/zh-CN/docs/Web/API/File_System_API) +- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md new file mode 100644 index 00000000000000..74f4b4d60cfc58 --- /dev/null +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md @@ -0,0 +1,63 @@ +--- +title: FileSystemDirectoryHandle：getDirectoryHandle() 方法 +slug: Web/API/FileSystemDirectoryHandle/getDirectoryHandle +--- + +{{securecontext_header}}{{APIRef("File System API")}} + +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`getDirectoryHandle()`** 方法返回一个位于调用此方法的目录句柄内带有指定名称的子目录的 {{domxref('FileSystemDirectoryHandle')}}。 + +## 语法 + +```js-nolint +getDirectoryHandle(name) +getDirectoryHandle(name, options) +``` + +### 参数 + +- `name` + - : 一个字符串，表示你想要获得的子目录的 {{domxref('FileSystemHandle.name')}}。 +- `options` {{optional_inline}} + + - : 包含要获得的子目录的选项的可选对象，选项如下： + + - `create` + - : 布尔值，默认为 `false`。当设为 `true` 时，如果没有找到对应的目录，将会创建一个指定名称的目录并将其返回。 + +### 返回值 + +一个 {{jsxref('Promise')}} 对象，兑现一个 {{domxref('FileSystemDirectoryHandle')}}。 + +### 异常 + +- `NotAllowedError` {{domxref("DOMException")}} + - : 如果 {{domxref('PermissionStatus')}} 不为 'granted' 则抛出此异常。 +- `TypeMismatchError` {{domxref("DOMException")}} + - : 如果将返回的条目是个文件而不是目录时会抛出此异常。 +- `NotFoundError` {{domxref("DOMException")}} + - : 如果目录不存在，并且 `create` 选项被设为 `false` 时会抛出此异常。 + +## 示例 + +下面的示例能够取得指定名称的目录句柄，如果目录不存在，则创建。 + +```js +const dirName = "directoryToGetName"; + +// 假设我们有一个目录句柄：'currentDirHandle' +const subDir = currentDirHandle.getDirectoryHandle(dirName, { create: true }); +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [文件系统 API](/zh-CN/docs/Web/API/File_System_API) +- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md new file mode 100644 index 00000000000000..ee548df96c68b3 --- /dev/null +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md @@ -0,0 +1,65 @@ +--- +title: FileSystemDirectoryHandle：getFileHandle() 方法 +slug: Web/API/FileSystemDirectoryHandle/getFileHandle +--- + +{{securecontext_header}}{{APIRef("File System API")}} + +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`getFileHandle()`** 方法返回一个位于调用此方法的目录句柄内带有指定名称的文件的 {{domxref('FileSystemFileHandle')}}。 + +## 语法 + +```js-nolint +getFileHandle(name) +getFileHandle(name, options) +``` + +### 参数 + +- `name` + - : 一个字符串，表示你想要获得的文件的 {{domxref('FileSystemHandle.name')}}。 +- `options` {{optional_inline}} + + - : 包含以下属性的对象： + + - `create` + - : 布尔值，默认为 `false`。当设为 `true` 时，如果没有找到对应的文件，将会创建一个指定名称的文件并将其返回。 + +### 返回值 + +一个 {{jsxref('Promise')}} 对象，兑现一个 {{domxref('FileSystemFileHandle')}}。 + +### 异常 + +- `NotAllowedError` {{domxref("DOMException")}} + - : 如果 {{domxref('PermissionStatus')}} 不为 'granted' 则抛出此异常。 +- {{jsxref("TypeError")}} + - : 如果指定的名称不是一个合法的字符串或者包含会干扰本地文件系统的字符则抛出此异常。 +- `TypeMismatchError` {{domxref("DOMException")}} + - : 如果指定名称的条目是个目录而不是文件，则抛出此异常。 +- `NotFoundError` {{domxref("DOMException")}} + - : 如果文件不存在，并且 `create` 选项被设为 `false` 时会抛出此异常。 + +## 示例 + +下面的示例能够取得指定名称的文件句柄，如果文件不存在，则创建。 + +```js +const fileName = "fileToGetName"; + +// 假设我们有一个目录句柄：'currentDirHandle' +const fileHandle = currentDirHandle.getFileHandle(fileName, { create: true }); +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [文件系统 API](/zh-CN/docs/Web/API/File_System_API) +- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md new file mode 100644 index 00000000000000..8f12ca72b2c15e --- /dev/null +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md @@ -0,0 +1,120 @@ +--- +title: FileSystemDirectoryHandle +slug: Web/API/FileSystemDirectoryHandle +--- + +{{securecontext_header}}{{APIRef("File System API")}} + +{{domxref("File System API", "File System API", "", "nocode")}} 的 **`FileSystemDirectoryHandle`** 接口提供指向一个文件系统目录的句柄。 + +这个接口可以通过 {{domxref('window.showDirectoryPicker()')}}、{{domxref('StorageManager.getDirectory()')}}、{{domxref('DataTransferItem.getAsFileSystemHandle()')}} 和 {{domxref('FileSystemDirectoryHandle.getDirectoryHandle()')}} 这些方法访问。 + +{{InheritanceDiagram}} + +## 实例属性 + +_从父接口 {{DOMxRef("FileSystemHandle")}} 继承属性。_ + +## 实例方法 + +_从父接口 {{DOMxRef("FileSystemHandle")}} 继承方法。_ + +常规方法： + +- {{domxref('FileSystemDirectoryHandle.getDirectoryHandle()')}} + - : 返回一个 {{jsxref('Promise')}}，兑现一个调用此方法的目录句柄内指定名称的子目录的 {{domxref('FileSystemDirectoryHandle')}}。 +- {{domxref('FileSystemDirectoryHandle.getFileHandle()')}} + - : 返回一个 {{jsxref('Promise')}}，兑现一个调用此方法的目录句柄内指定名称的文件的 {{domxref('FileSystemFileHandle')}}。 +- {{domxref('FileSystemDirectoryHandle.removeEntry()')}} + - : 如果目录句柄包含一个名为指定名称的文件或目录，则尝试异步将其移除。 +- {{domxref('FileSystemDirectoryHandle.resolve()')}} + - : 返回一个 {{jsxref('Promise')}} 对象，兑现一个包含从父目录前往指定子条目中间的目录的名称的{{jsxref('Array', '数组', '', 'nocode')}}。数组的最后一项是子条目的名称。 + +[异步迭代器](/zh-CN/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols)方法: + +- {{domxref('FileSystemDirectoryHandle.entries()')}} + - : 返回一个新的迭代给定对象自身可枚举属性`[键, 值]`对的*异步迭代器*。 +- {{domxref('FileSystemDirectoryHandle.keys()')}} + - : 返回一个新的迭代 `FileSystemDirectoryHandle` 对象内每个项的键的*异步迭代器*。 +- {{domxref('FileSystemDirectoryHandle.values()')}} + - : 返回一个新的迭代 `FileSystemDirectoryHandle` 对象内每个索引的值的*异步迭代器*。 +- [`FileSystemDirectoryHandle[@@asyncIterator]()`](/zh-CN/docs/Web/API/FileSystemDirectoryHandle/entries) + - : 默认情况下返回 `entries` 函数。 + +## 示例 + +### 返回目录句柄 + +下面的示例返回一个指定名称的目录句柄，如果对应的目录不存在则创建。 + +```js +const dirName = "directoryToGetName"; + +// 假设我们有一个目录句柄：'currentDirHandle' +const subDir = currentDirHandle.getDirectoryHandle(dirName, { create: true }); +``` + +### 返回文件路径 + +下面的异步函数使用 `resolve()` 来查找被选择文件相对于指定目录句柄的路径。 + +```js +async function returnPathDirectories(directoryHandle) { + // 通过显示文件选择器来获得一个文件句柄 + const [handle] = await self.showOpenFilePicker(); + if (!handle) { + // 如果用户取消了选择或者打开文件失败 + return; + } + + // 检查文件句柄是否存在于目录句柄的目录中 + const relativePaths = await directoryHandle.resolve(handle); + + if (relativePaths === null) { + // 不在目录句柄中 + } else { + // relativePaths 是一个包含名称的数组，指示相对路径 + + for (const name of relativePaths) { + // 打印数组的每个元素 + console.log(name); + } + } +} +``` + +### 返回目录中所有文件的句柄 + +下面的示例会递归地扫描一个目录，以返回目录中每个文件的 {{domxref('FileSystemFileHandle')}} 对象： + +```js +async function* getFilesRecursively(entry) { + if (entry.kind === "file") { + const file = await entry.getFile(); + if (file !== null) { + file.relativePath = getRelativePath(entry); + yield file; + } + } else if (entry.kind === "directory") { + for await (const handle of entry.values()) { + yield* getFilesRecursively(handle); + } + } +} +for await (const fileHandle of getFilesRecursively(directoryHandle)) { + console.log(fileHandle); +} +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [文件系统 API](/zh-CN/docs/Web/API/File_System_API) +- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md new file mode 100644 index 00000000000000..96fe153c6ef0fe --- /dev/null +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md @@ -0,0 +1,45 @@ +--- +title: FileSystemDirectoryHandle：keys() 方法 +slug: Web/API/FileSystemDirectoryHandle/keys +--- + +{{securecontext_header}}{{APIRef("File System API")}} + +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`keys()`** 方法返回一个异步迭代器，用于迭代 `FileSystemDirectoryHandle` 内每个项的键。 + +## 语法 + +```js-nolint +FileSystemDirectoryHandle.keys() +``` + +### 参数 + +无。 + +### 返回值 + +一个新的 `FileSystemDirectoryIterator`。 + +## 示例 + +```js +const dirHandle = await window.showDirectoryPicker(); + +for await (const key of dirHandle.keys()) { + console.log(key); +} +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [文件系统 API](/zh-CN/docs/Web/API/File_System_API) +- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md new file mode 100644 index 00000000000000..2c2d6b6f2eba5b --- /dev/null +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md @@ -0,0 +1,67 @@ +--- +title: FileSystemDirectoryHandle：removeEntry() 方法 +slug: Web/API/FileSystemDirectoryHandle/removeEntry +--- + +{{securecontext_header}}{{APIRef("File System API")}} + +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`removeEntry()`** 方法用于尝试将目录句柄内名为指定名称的文件或目录移除。 + +## 语法 + +```js-nolint +removeEntry(name) +removeEntry(name, options) +``` + +### 参数 + +- `name` + - : 一个字符串，表示你想要移除的条目的 {{domxref('FileSystemHandle.name')}}。 +- `options` {{optional_inline}} + + - : 一个包含以下选项的可选对象： + + - `recursive` + - : 布尔值，默认为 `false`。当设为 `true` 时，条目将会被递归移除。 + +### 返回值 + +一个 {{jsxref('Promise')}} 对象，兑现 `undefined`。 + +### 异常 + +- {{jsxref("TypeError")}} + - : 如果 `name` 不是一个合法的字符串或者包含不允许出现在文件系统中的字符时，抛出此异常。 +- `NotAllowedError` {{domxref("DOMException")}} + - : 如果 {{domxref('PermissionStatus')}} 不为 'granted' 则抛出此异常。 +- `InvalidModificationError` {{domxref("DOMException")}} + - : 如果 `recursive` 被设为 `false`，而对应的条目又有子条目时，抛出此异常。 +- `NotFoundError` {{domxref("DOMException")}} + - : 如果没有找到指定名称的条目，抛出此异常。 + +## 示例 + +下面的示例演示移除目录句柄内的一个条目。 + +```js +const entryName = "entryToRemove"; + +// 假设我们有一个目录句柄：'currentDirHandle' +currentDirHandle.removeEntry(entryName).then(() => { +// 成功移除后要运行的代码 +}); +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [文件系统 API](/zh-CN/docs/Web/API/File_System_API) +- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md new file mode 100644 index 00000000000000..647b8f0ac4ccf9 --- /dev/null +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md @@ -0,0 +1,68 @@ +--- +title: FileSystemDirectoryHandle：resolve() 方法 +slug: Web/API/FileSystemDirectoryHandle/resolve +--- + +{{securecontext_header}}{{APIRef("File System API")}} + +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`resolve()`** 方法返回一个 {{jsxref('Promise')}} 对象，兑现一个包含从父目录前往指定子条目中间的目录的名称的{{jsxref('Array', '数组', '', 'nocode')}}。数组的最后一项是子条目的名称。 + +## 语法 + +```js-nolint +resolve(possibleDescendant) +``` + +### 参数 + +- `possibleDescendant` + - : 要返回其相对路径的 {{domxref('FileSystemHandle')}}。 + +### 返回值 + +一个 {{jsxref('Promise')}} 对象，兑现一个包含字符串的{{jsxref('Array', '数组', '', 'nocode')}}，或者当参数 `possibleDescendant` 不是此 {{domxref('FileSystemDirectoryHandle')}} 的后代时，兑现 `null`。 + +### 异常 + +不抛出异常。 + +## 示例 + +下面的异步函数使用 `resolve()` 来查找被选择文件相对于指定目录句柄的路径。 + +```js +async function returnPathDirectories(directoryHandle) { + // 通过显示文件选择器来获得一个文件句柄 + const [handle] = await self.showOpenFilePicker(); + if (!handle) { + // 如果用户取消了选择或者打开文件失败 + return; + } + + // 检查文件句柄是否存在于目录句柄的目录中 + const relativePaths = await directoryHandle.resolve(handle); + + if (relativePaths === null) { + // 不在目录句柄中 + } else { + // relativePaths 是一个包含名称的数组，指示相对路径 + for (const name of relativePaths) { + // 打印数组的每个元素 + console.log(name); + } + } +} +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [文件系统 API](/zh-CN/docs/Web/API/File_System_API) +- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md new file mode 100644 index 00000000000000..657356adb6e545 --- /dev/null +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md @@ -0,0 +1,45 @@ +--- +title: FileSystemDirectoryHandle：values() 方法 +slug: Web/API/FileSystemDirectoryHandle/values +--- + +{{securecontext_header}}{{APIRef("File System API")}} + +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`values()`** 方法返回一个异步迭代器，用于迭代 `FileSystemDirectoryHandle` 对象内每个索引的值。 + +## 语法 + +```js-nolint +values() +``` + +### 参数 + +无。 + +### 返回值 + +一个新的 `FileSystemDirectoryIterator`。 + +## 示例 + +```js +const dirHandle = await window.showDirectoryPicker(); + +for await (const value of dirHandle.values()) { + console.log(value); +} +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [文件系统 API](/zh-CN/docs/Web/API/File_System_API) +- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) From a2de209157bf224b47ff256ec596501fbac89b95 Mon Sep 17 00:00:00 2001 From: Fina <42113148+BSPR0002@users.noreply.github.com> Date: Sat, 9 Sep 2023 07:36:55 +0800 Subject: [PATCH 2/5] Apply suggestions from code review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- files/zh-cn/web/api/filesystemdirectoryhandle/index.md | 2 +- .../web/api/filesystemdirectoryhandle/removeentry/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md index 8f12ca72b2c15e..8fe874d48d68e5 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md @@ -30,7 +30,7 @@ _从父接口 {{DOMxRef("FileSystemHandle")}} 继承方法。_ - {{domxref('FileSystemDirectoryHandle.resolve()')}} - : 返回一个 {{jsxref('Promise')}} 对象，兑现一个包含从父目录前往指定子条目中间的目录的名称的{{jsxref('Array', '数组', '', 'nocode')}}。数组的最后一项是子条目的名称。 -[异步迭代器](/zh-CN/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols)方法: +[异步迭代器](/zh-CN/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols)方法： - {{domxref('FileSystemDirectoryHandle.entries()')}} - : 返回一个新的迭代给定对象自身可枚举属性`[键, 值]`对的*异步迭代器*。 diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md index 2c2d6b6f2eba5b..a318a26614f8eb 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md @@ -49,7 +49,7 @@ const entryName = "entryToRemove"; // 假设我们有一个目录句柄：'currentDirHandle' currentDirHandle.removeEntry(entryName).then(() => { -// 成功移除后要运行的代码 + // 成功移除后要运行的代码 }); ``` From 504a135b68acbf3acec415dbff071191e9d5d696 Mon Sep 17 00:00:00 2001 From: BSPR0002 <42113148+BSPR0002@users.noreply.github.com> Date: Mon, 6 Nov 2023 22:32:07 +0800 Subject: [PATCH 3/5] Update translation --- .../web/api/filesystemdirectoryhandle/entries/index.md | 6 ++++-- files/zh-cn/web/api/filesystemdirectoryhandle/index.md | 8 ++++---- .../zh-cn/web/api/filesystemdirectoryhandle/keys/index.md | 6 ++++-- .../web/api/filesystemdirectoryhandle/values/index.md | 6 ++++-- 4 files changed, 16 insertions(+), 10 deletions(-) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md index ac8e79929682db..fd6ec4593629be 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md @@ -5,7 +5,7 @@ slug: Web/API/FileSystemDirectoryHandle/entries {{securecontext_header}}{{APIRef("File System API")}} -{{domxref("FileSystemDirectoryHandle")}} 接口的 **`entries()`** 方法返回一个异步迭代器，用于迭代给定对象自身可枚举属性`[键, 值]`对，迭代顺序与 [`for...in`](/zh-CN/docs/Web/JavaScript/Reference/Statements/for...in) 循环的迭代顺序一致（不同之处在于 for-in 循环还会枚举原型链中的属性）。 +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`entries()`** 方法返回一个异步迭代器，用于迭代调用此方法的 `FileSystemDirectoryHandle` 中的条目的键值对。键值对是一个 `[键, 值]` 形式的数组。 ## 语法 @@ -19,10 +19,12 @@ entries() ### 返回值 -迭代给定的 `FileSystemDirectoryHandle` 对象自身可枚举属性`[键, 值]`对的异步迭代器。 +一个新的包含 `FileSystemDirectoryHandle` 中每个条目的键值对的异步迭代器。 ## 示例 +使用 `for await...of` 循环能够简化迭代过程。 + ```js const dirHandle = await window.showDirectoryPicker(); diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md index 8fe874d48d68e5..6b63bb8efcb5e6 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md @@ -30,14 +30,14 @@ _从父接口 {{DOMxRef("FileSystemHandle")}} 继承方法。_ - {{domxref('FileSystemDirectoryHandle.resolve()')}} - : 返回一个 {{jsxref('Promise')}} 对象，兑现一个包含从父目录前往指定子条目中间的目录的名称的{{jsxref('Array', '数组', '', 'nocode')}}。数组的最后一项是子条目的名称。 -[异步迭代器](/zh-CN/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols)方法： +[异步迭代器](/zh-CN/docs/Web/JavaScript/Reference/Iteration_protocols#异步迭代器和异步可迭代协议)方法： - {{domxref('FileSystemDirectoryHandle.entries()')}} - - : 返回一个新的迭代给定对象自身可枚举属性`[键, 值]`对的*异步迭代器*。 + - : 返回一个新的迭代 `FileSystemDirectoryHandle` 对象内每个条目的键值对的异步迭代器。 - {{domxref('FileSystemDirectoryHandle.keys()')}} - - : 返回一个新的迭代 `FileSystemDirectoryHandle` 对象内每个项的键的*异步迭代器*。 + - : 返回一个新的迭代 `FileSystemDirectoryHandle` 对象内每个条目的键的异步迭代器。 - {{domxref('FileSystemDirectoryHandle.values()')}} - - : 返回一个新的迭代 `FileSystemDirectoryHandle` 对象内每个索引的值的*异步迭代器*。 + - : 返回一个新的迭代 `FileSystemDirectoryHandle` 对象内每个条目的句柄的异步迭代器。 - [`FileSystemDirectoryHandle[@@asyncIterator]()`](/zh-CN/docs/Web/API/FileSystemDirectoryHandle/entries) - : 默认情况下返回 `entries` 函数。 diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md index 96fe153c6ef0fe..009b867825dfe1 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md @@ -5,7 +5,7 @@ slug: Web/API/FileSystemDirectoryHandle/keys {{securecontext_header}}{{APIRef("File System API")}} -{{domxref("FileSystemDirectoryHandle")}} 接口的 **`keys()`** 方法返回一个异步迭代器，用于迭代 `FileSystemDirectoryHandle` 内每个项的键。 +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`keys()`** 方法返回一个异步迭代器，用于迭代调用此方法的 `FileSystemDirectoryHandle` 中的条目的键。 ## 语法 @@ -19,10 +19,12 @@ FileSystemDirectoryHandle.keys() ### 返回值 -一个新的 `FileSystemDirectoryIterator`。 +一个新的包含 `FileSystemDirectoryHandle` 中每个条目的键的异步迭代器。 ## 示例 +使用 `for await...of` 循环能够简化迭代过程。 + ```js const dirHandle = await window.showDirectoryPicker(); diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md index 657356adb6e545..91a0917bb784bd 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md @@ -5,7 +5,7 @@ slug: Web/API/FileSystemDirectoryHandle/values {{securecontext_header}}{{APIRef("File System API")}} -{{domxref("FileSystemDirectoryHandle")}} 接口的 **`values()`** 方法返回一个异步迭代器，用于迭代 `FileSystemDirectoryHandle` 对象内每个索引的值。 +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`values()`** 方法返回一个异步迭代器，用于迭代调用此方法的 `FileSystemDirectoryHandle` 中的条目的值。 ## 语法 @@ -19,10 +19,12 @@ values() ### 返回值 -一个新的 `FileSystemDirectoryIterator`。 +一个新的包含 `FileSystemDirectoryHandle` 中每个条目的句柄的异步迭代器。 ## 示例 +使用 `for await...of` 循环能够简化迭代过程。 + ```js const dirHandle = await window.showDirectoryPicker(); From 30ace50836dfe958f3fadf801b93591c04510d31 Mon Sep 17 00:00:00 2001 From: Allo Date: Tue, 7 Nov 2023 19:08:39 +0800 Subject: [PATCH 4/5] fix the broken links to web.dev --- files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md | 2 +- .../api/filesystemdirectoryhandle/getdirectoryhandle/index.md | 2 +- .../web/api/filesystemdirectoryhandle/getfilehandle/index.md | 2 +- files/zh-cn/web/api/filesystemdirectoryhandle/index.md | 2 +- files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md | 2 +- .../web/api/filesystemdirectoryhandle/removeentry/index.md | 2 +- files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md | 2 +- files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md | 2 +- 8 files changed, 8 insertions(+), 8 deletions(-) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md index fd6ec4593629be..f5ece7a7b7b554 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/entries/index.md @@ -44,4 +44,4 @@ for await (const [key, value] of dirHandle.entries()) { ## 参见 - [文件系统 API](/zh-CN/docs/Web/API/File_System_API) -- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) +- [文件系统访问 API：简化本地文件访问](https://developer.chrome.com/articles/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md index 74f4b4d60cfc58..98d26fe946e8f5 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md @@ -60,4 +60,4 @@ const subDir = currentDirHandle.getDirectoryHandle(dirName, { create: true }); ## 参见 - [文件系统 API](/zh-CN/docs/Web/API/File_System_API) -- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) +- [文件系统访问 API：简化本地文件访问](https://developer.chrome.com/articles/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md index ee548df96c68b3..b0e2c6952cbf7d 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md @@ -62,4 +62,4 @@ const fileHandle = currentDirHandle.getFileHandle(fileName, { create: true }); ## 参见 - [文件系统 API](/zh-CN/docs/Web/API/File_System_API) -- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) +- [文件系统访问 API：简化本地文件访问](https://developer.chrome.com/articles/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md index 6b63bb8efcb5e6..fe410f189e793a 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md @@ -117,4 +117,4 @@ for await (const fileHandle of getFilesRecursively(directoryHandle)) { ## 参见 - [文件系统 API](/zh-CN/docs/Web/API/File_System_API) -- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) +- [文件系统访问 API：简化本地文件访问](https://developer.chrome.com/articles/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md index 009b867825dfe1..17795f0a203b82 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/keys/index.md @@ -44,4 +44,4 @@ for await (const key of dirHandle.keys()) { ## 参见 - [文件系统 API](/zh-CN/docs/Web/API/File_System_API) -- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) +- [文件系统访问 API：简化本地文件访问](https://developer.chrome.com/articles/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md index a318a26614f8eb..952e9b13a93334 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md @@ -64,4 +64,4 @@ currentDirHandle.removeEntry(entryName).then(() => { ## 参见 - [文件系统 API](/zh-CN/docs/Web/API/File_System_API) -- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) +- [文件系统访问 API：简化本地文件访问](https://developer.chrome.com/articles/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md index 647b8f0ac4ccf9..1743c06549730f 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md @@ -65,4 +65,4 @@ async function returnPathDirectories(directoryHandle) { ## 参见 - [文件系统 API](/zh-CN/docs/Web/API/File_System_API) -- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) +- [文件系统访问 API：简化本地文件访问](https://developer.chrome.com/articles/file-system-access/) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md index 91a0917bb784bd..60dde11f4d4186 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/values/index.md @@ -44,4 +44,4 @@ for await (const value of dirHandle.values()) { ## 参见 - [文件系统 API](/zh-CN/docs/Web/API/File_System_API) -- [文件系统访问 API：简化本地文件访问](https://web.dev/file-system-access/) +- [文件系统访问 API：简化本地文件访问](https://developer.chrome.com/articles/file-system-access/) From 07548cf7ef21f447a93434b2ed6a876571e9f7cd Mon Sep 17 00:00:00 2001 From: Fina <42113148+BSPR0002@users.noreply.github.com> Date: Tue, 7 Nov 2023 19:30:48 +0800 Subject: [PATCH 5/5] Apply suggestions from code review Co-authored-by: A1lo --- .../filesystemdirectoryhandle/getdirectoryhandle/index.md | 4 ++-- .../api/filesystemdirectoryhandle/getfilehandle/index.md | 4 ++-- files/zh-cn/web/api/filesystemdirectoryhandle/index.md | 6 +++--- .../web/api/filesystemdirectoryhandle/removeentry/index.md | 2 +- .../web/api/filesystemdirectoryhandle/resolve/index.md | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md index 98d26fe946e8f5..bf34c75dec664f 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/getdirectoryhandle/index.md @@ -27,12 +27,12 @@ getDirectoryHandle(name, options) ### 返回值 -一个 {{jsxref('Promise')}} 对象，兑现一个 {{domxref('FileSystemDirectoryHandle')}}。 +一个 {{jsxref('Promise')}} 对象，会兑现一个 {{domxref('FileSystemDirectoryHandle')}}。 ### 异常 - `NotAllowedError` {{domxref("DOMException")}} - - : 如果 {{domxref('PermissionStatus')}} 不为 'granted' 则抛出此异常。 + - : 如果 {{domxref('PermissionStatus')}} 不为“granted”则抛出此异常。 - `TypeMismatchError` {{domxref("DOMException")}} - : 如果将返回的条目是个文件而不是目录时会抛出此异常。 - `NotFoundError` {{domxref("DOMException")}} diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md index b0e2c6952cbf7d..13d3378d575c25 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/getfilehandle/index.md @@ -27,12 +27,12 @@ getFileHandle(name, options) ### 返回值 -一个 {{jsxref('Promise')}} 对象，兑现一个 {{domxref('FileSystemFileHandle')}}。 +一个 {{jsxref('Promise')}} 对象，会兑现一个 {{domxref('FileSystemFileHandle')}}。 ### 异常 - `NotAllowedError` {{domxref("DOMException")}} - - : 如果 {{domxref('PermissionStatus')}} 不为 'granted' 则抛出此异常。 + - : 如果 {{domxref('PermissionStatus')}} 不为“granted”则抛出此异常。 - {{jsxref("TypeError")}} - : 如果指定的名称不是一个合法的字符串或者包含会干扰本地文件系统的字符则抛出此异常。 - `TypeMismatchError` {{domxref("DOMException")}} diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md index fe410f189e793a..a6f96bb2107c68 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/index.md @@ -22,13 +22,13 @@ _从父接口 {{DOMxRef("FileSystemHandle")}} 继承方法。_ 常规方法： - {{domxref('FileSystemDirectoryHandle.getDirectoryHandle()')}} - - : 返回一个 {{jsxref('Promise')}}，兑现一个调用此方法的目录句柄内指定名称的子目录的 {{domxref('FileSystemDirectoryHandle')}}。 + - : 返回一个 {{jsxref('Promise')}}，会兑现一个调用此方法的目录句柄内指定名称的子目录的 {{domxref('FileSystemDirectoryHandle')}}。 - {{domxref('FileSystemDirectoryHandle.getFileHandle()')}} - - : 返回一个 {{jsxref('Promise')}}，兑现一个调用此方法的目录句柄内指定名称的文件的 {{domxref('FileSystemFileHandle')}}。 + - : 返回一个 {{jsxref('Promise')}}，会兑现一个调用此方法的目录句柄内指定名称的文件的 `FileSystemFileHandle`。 - {{domxref('FileSystemDirectoryHandle.removeEntry()')}} - : 如果目录句柄包含一个名为指定名称的文件或目录，则尝试异步将其移除。 - {{domxref('FileSystemDirectoryHandle.resolve()')}} - - : 返回一个 {{jsxref('Promise')}} 对象，兑现一个包含从父目录前往指定子条目中间的目录的名称的{{jsxref('Array', '数组', '', 'nocode')}}。数组的最后一项是子条目的名称。 + - : 返回一个 {{jsxref('Promise')}} 对象，会兑现一个包含从父目录前往指定子条目中间的目录的名称的{{jsxref('Array', '数组', '', 'nocode')}}。数组的最后一项是子条目的名称。 [异步迭代器](/zh-CN/docs/Web/JavaScript/Reference/Iteration_protocols#异步迭代器和异步可迭代协议)方法： diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md index 952e9b13a93334..b8107bfc5d946f 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/removeentry/index.md @@ -34,7 +34,7 @@ removeEntry(name, options) - {{jsxref("TypeError")}} - : 如果 `name` 不是一个合法的字符串或者包含不允许出现在文件系统中的字符时，抛出此异常。 - `NotAllowedError` {{domxref("DOMException")}} - - : 如果 {{domxref('PermissionStatus')}} 不为 'granted' 则抛出此异常。 + - : 如果 {{domxref('PermissionStatus')}} 不为“granted”则抛出此异常。 - `InvalidModificationError` {{domxref("DOMException")}} - : 如果 `recursive` 被设为 `false`，而对应的条目又有子条目时，抛出此异常。 - `NotFoundError` {{domxref("DOMException")}} diff --git a/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md b/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md index 1743c06549730f..69995f24549467 100644 --- a/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md +++ b/files/zh-cn/web/api/filesystemdirectoryhandle/resolve/index.md @@ -5,7 +5,7 @@ slug: Web/API/FileSystemDirectoryHandle/resolve {{securecontext_header}}{{APIRef("File System API")}} -{{domxref("FileSystemDirectoryHandle")}} 接口的 **`resolve()`** 方法返回一个 {{jsxref('Promise')}} 对象，兑现一个包含从父目录前往指定子条目中间的目录的名称的{{jsxref('Array', '数组', '', 'nocode')}}。数组的最后一项是子条目的名称。 +{{domxref("FileSystemDirectoryHandle")}} 接口的 **`resolve()`** 方法返回一个 {{jsxref('Promise')}} 对象，会兑现一个包含从父目录前往指定子条目中间的目录的名称的{{jsxref('Array', '数组', '', 'nocode')}}。数组的最后一项是子条目的名称。 ## 语法 @@ -20,7 +20,7 @@ resolve(possibleDescendant) ### 返回值 -一个 {{jsxref('Promise')}} 对象，兑现一个包含字符串的{{jsxref('Array', '数组', '', 'nocode')}}，或者当参数 `possibleDescendant` 不是此 {{domxref('FileSystemDirectoryHandle')}} 的后代时，兑现 `null`。 +一个 {{jsxref('Promise')}} 对象，会兑现一个包含字符串的{{jsxref('Array', '数组', '', 'nocode')}}，或者当参数 `possibleDescendant` 不是此 {{domxref('FileSystemDirectoryHandle')}} 的后代时，兑现 `null`。 ### 异常