大网数据广告活动
Web 标准与前端开发

FileSystemDirectoryHandle:getFileHandle() 方法

· 52CE 我爱测

FileSystemDirectoryHandle 接口的 **`getFileHandle()`** 方法返回一个位于调用此方法的目录句柄内带有指定名称的文件的 FileSystemFileHandle。

File System API

FileSystemDirectoryHandle 接口的 getFileHandle() 方法返回一个位于调用此方法的目录句柄内带有指定名称的文件的 FileSystemFileHandle。

语法

getFileHandle(name)
getFileHandle(name, options)

参数

  • name
    • : 一个字符串,表示你想要获得的文件的 FileSystemHandle.name。
  • options
    • : 包含以下属性的对象:
      • create
        • : Boolean,默认为 false。当设为 true 时,如果没有找到对应的文件,将会创建一个指定名称的文件并将其返回。

返回值

一个 Promise 对象,会兑现一个 FileSystemFileHandle。

异常

  • NotAllowedError DOMException
    • : 如果句柄的 PermissionStatus.state 在 readwrite 模式下不是 'granted'(如果 create 选项设置为 true),或在 read 模式下不是 'granted'(如果 create 选项设置为 false)。
  • TypeError
    • : 如果指定的名称不是一个合法的字符串或者包含会干扰本地文件系统的字符则抛出此异常。
  • TypeMismatchError DOMException
    • : 如果指定名称的条目是个目录而不是文件,则抛出此异常。
  • NotFoundError DOMException
    • : 如果未找到当前条目或文件不存在且 create 选项设置为 false,抛出该异常。

示例

下面的示例能够取得指定名称的文件句柄,如果文件不存在,则创建。

const fileName = "fileToGetName";

// 假设我们有一个目录句柄:'currentDirHandle'
const fileHandle = currentDirHandle.getFileHandle(fileName, { create: true });

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。