FileSystemFileHandle - 表示文件系统条目的句柄

安全上下文
该功能仅在部分或所有支持的浏览器中的安全上下文(HTTPS)中可用。

FileSystemFileHandleFile System Access API 的接口,表示文件系统条目的句柄。通过 window.showOpenFilePicker() 方法访问接口。

请注意,读和写操作取决于文件访问权限,如果该源的其他标签没有打开,则该权限在页面刷新后不会继续存在。FileSystemHandle 接口的 queryPermission 方法可用于在访问文件之前验证权限状态。

属性

从其父接口 FileSystemHandle 继承了属性。

方法

从其父接口 FileSystemHandle 继承了方法。

getFile()

返回一个 File,表示句柄所表示的条目在磁盘上的状态。

createWritable()

创建可用于写入文件的 FileSystemWritableFileStream

实例

读取文件

下面的异步函数提供了一个文件选择器,一旦选择了一个文件,就会使用 getFile() 方法来检索内容。

async function getTheFile() {
  // 打开文件选择器
  [fileHandle] = await window.showOpenFilePicker(pickerOpts);

  // 获取文件内容
  const fileData = await fileHandle.getFile();
}

写入文件

以下异步函数将给定的内容写入文件句柄,从而写入磁盘。

async function writeFile(fileHandle, contents) {
  // 创建要写入的 FileSystemWritableFileStream。
  const writable = await fileHandle.createWritable();

  // 将文件的内容写入流。
  await writable.write(contents);

  // 关闭文件并将内容写入磁盘。
  await writable.close();
}

规范

规范
File System Access # api-filesystemfilehandle

桌面浏览器兼容性

暂无兼容数据

相关链接