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

FileSystemHandle:requestPermission() 方法

· 52CE 我爱测

FileSystemHandle 接口的 **`queryPermission()`** 方法用于为文件句柄请求读取或读写权限。

File System API

FileSystemHandle 接口的 queryPermission() 方法用于为文件句柄请求读取或读写权限。

语法

requestPermission(descriptor)

参数

  • descriptor
    • : 一个对象,指定需要查询的权限模式,包含以下选项:
      • 'mode'
        • : 可以是 'read' 或 'readwrite'。

返回值

一个兑现为 PermissionStatus.state 的 Promise,其值为 'granted'、'denied' 或 'prompt'。它也可能因出现以下异常而被拒绝。

异常

  • TypeError
    • : 如果没有指定参数或者 mode 的值不是 'read' 或 'readwrite',则抛出此异常。
  • SecurityError DOMException
    • : 在下列情况之一发生时抛出:
      • 该方法是在与顶级上下文不同源的上下文(例如跨源 iframe)中调用的。
      • 没有瞬态用户激活,例如按下按钮。这包括当句柄处于无法使用用户激活的非 Window 上下文(例如 Worker)中时。

安全

瞬态用户激活是必需的。用户必须与页面或 UI 元素进行交互才能使该特性正常运行。

示例

以下异步函数会在句柄没有获得授权时请求权限。

// fileHandle 是一个 FileSystemFileHandle
// withWrite 是一个布尔值,如果要求写入则需传入 true

async function verifyPermission(fileHandle, withWrite) {
  const opts = {};
  if (withWrite) {
    opts.mode = "readwrite";
  }

  // 检查是否已经拥有相应权限,如果是,返回 true。
  if ((await fileHandle.queryPermission(opts)) === "granted") {
    return true;
  }

  // 为文件请求权限,如果用户授予了权限,返回 true。
  if ((await fileHandle.requestPermission(opts)) === "granted") {
    return true;
  }

  // 用户没有授权,返回 false。
  return false;
}

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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