From abc5bce97fef007536e59b52be62964b4755af90 Mon Sep 17 00:00:00 2001 From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> Date: Thu, 12 Sep 2024 01:16:05 +0800 Subject: [PATCH] Apply suggestions from code review Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- files/zh-cn/web/api/blob/index.md | 2 +- files/zh-cn/web/api/file/lastmodified/index.md | 2 +- files/zh-cn/web/api/filelist/index.md | 2 +- files/zh-cn/web/api/filereader/readastext/index.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/web/api/blob/index.md b/files/zh-cn/web/api/blob/index.md index e7d0867b66a417..758c1541942451 100644 --- a/files/zh-cn/web/api/blob/index.md +++ b/files/zh-cn/web/api/blob/index.md @@ -34,7 +34,7 @@ Blob 表示的不一定是 JavaScript 原生格式的数据。{{DOMxRef("File")} - {{DOMxRef("Blob.arrayBuffer()")}} - : 返回一个 promise，其会兑现一个包含 `Blob` 所有内容的二进制格式的 {{jsxref("ArrayBuffer")}}。 - {{DOMxRef("Blob.bytes()")}} - - : Returns a promise that resolves with an {{jsxref("Uint8Array")}} containing the contents of the `Blob`.返回一个兑现一个包含 `Blob` 内容的 {{jsxref("Uint8Array")}} 的 promise。 + - : 返回一个 promise，其会兑现一个包含 `Blob` 内容的 {{jsxref("Uint8Array")}}。 - {{DOMxRef("Blob.slice()")}} - : 返回一个新的 `Blob` 对象，其中包含调用它的 blob 的指定字节范围内的数据。 - {{DOMxRef("Blob.stream()")}} diff --git a/files/zh-cn/web/api/file/lastmodified/index.md b/files/zh-cn/web/api/file/lastmodified/index.md index a281cc782a9505..b0438bd2cb5553 100644 --- a/files/zh-cn/web/api/file/lastmodified/index.md +++ b/files/zh-cn/web/api/file/lastmodified/index.md @@ -59,7 +59,7 @@ filepicker.addEventListener("change", (event) => { ### 动态创建文件 -如果文件是动态创建的，可以在 {{domxref("File.File()", "File()")}} 构造函数中提供最后修改时间。如果未提供则会继承文件对象被创建时的 {{jsxref("Date.now()")}}。 +如果文件是动态创建的，可以在 {{domxref("File.File()", "File()")}} 构造函数中提供最后修改时间。如果未提供该参数，`lastModified` 将会继承文件对象被创建时的时间（来自 {{jsxref("Date.now()")}}）。 ```js const fileWithDate = new File([], "file.bin", { diff --git a/files/zh-cn/web/api/filelist/index.md b/files/zh-cn/web/api/filelist/index.md index 26a8b4a96a4d10..e1c2f781e54b83 100644 --- a/files/zh-cn/web/api/filelist/index.md +++ b/files/zh-cn/web/api/filelist/index.md @@ -21,7 +21,7 @@ l10n: const file = document.getElementById("fileItem").files[0]; ``` -此接口是[尝试创建不可修改的列表](https://stackoverflow.com/questions/74630989/why-use-domstringlist-rather-than-an-array/74641156#74641156)，并且继续支持它只是为了不破坏已经使用它的代码。现代 API 使用基于 JavaScript [数组](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array)的类型来表示列表结构，从而提供许多数组方法，同时对其使用施加额外的语义（例如使其项目为只读）。 +此接口[试图创建不可修改的列表](https://stackoverflow.com/questions/74630989/why-use-domstringlist-rather-than-an-array/74641156#74641156)，为了不破坏已经使用该接口的代码，才继续支持该接口。现代 API 使用基于 JavaScript [数组](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array)的类型来表示列表结构，从而提供许多数组方法，同时对其使用施加额外的语义（例如使其项目为只读）。 这些历史原因并不意味着你作为开发人员应该避免使用 `FileList`。你不会自己创建 `FileList` 对象，而是从诸如 {{domxref("HTMLInputElement.files")}} 之类的 API 获取它们，并且这些 API 并未弃用。但是，请注意与真实数组的语义差异。 diff --git a/files/zh-cn/web/api/filereader/readastext/index.md b/files/zh-cn/web/api/filereader/readastext/index.md index 8cb0bd0f2a4f24..68f819e1de52ef 100644 --- a/files/zh-cn/web/api/filereader/readastext/index.md +++ b/files/zh-cn/web/api/filereader/readastext/index.md @@ -5,7 +5,7 @@ l10n: sourceCommit: d8f04d843dd81ab8cea1cfc0577ae3c5c9b77d5c --- -{{APIRef("File API")}} +{{APIRef("File API")}}{{AvailableInWorkers}} {{domxref("FileReader")}} 接口的 **`readAsText()`** 方法用于读取指定的 {{domxref("Blob")}} 或 {{domxref("File")}} 对象的内容。当读操作完成时，{{domxref("FileReader.readyState","readyState")}} 属性更改为 `DONE`，并触发 {{domxref("FileReader/loadend_event", "loadend")}} 事件，并且 {{domxref("FileReader.result","result")}} 属性包含表示文件内容的文本字符串。