FileSystemFileEntry：file() 方法

FileSystemFileEntry 接口的 file() 方法返回一个 File 对象，该对象可用于读取目录条目所表示的文件中的数据。

语法

js
file(successCallback)
file(successCallback, errorCallback)

参数

successCallback

当 File 成功创建时调用的回调函数；File 作为唯一参数传递到回调函数中。

errorCallback 可选

如果提供，则必须是尝试创建 File 时发生错误时调用的方法。此回调函数接收一个 DOMException 对象作为输入，该对象描述了错误。

返回值

无 (undefined).

示例

此示例建立了一个方法 readFile()，读取一个文本文件并在读取完成后使用指定的回调函数调用接收到的文本（以字符串形式）。如果发生错误，则会调用指定的（可选）错误回调函数。

js
function readFile(entry, successCallback, errorCallback) {
  entry.file((file) => {
    let reader = new FileReader();

    reader.onload = () => {
      successCallback(reader.result);
    };

    reader.onerror = () => {
      errorCallback(reader.error);
    };

    reader.readAsText(file);
  }, errorCallback);
}

此函数调用 file()，并将其成功回调指定为一个方法，该方法继续使用 FileReader 将文件读取为文本。FileReader 的 load 事件处理程序被设置为将加载的字符串传递给调用 readFile() 方法时指定的 successCallback；类似地，其 error 处理程序被设置为调用指定的 errorCallback。

规范

规范
文件和目录条目 API
# dom-filesystemfileentry-file

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅