能力
发布于
能力是让 PWA 做到原生应用之事的设备与平台 API：读写本地文件、分享内容、访问硬件、 加速图形与收款。多数能力受安全上下文、用户手势与显式权限的限制，且各引擎支持程度不一。
每个条目讲解一个 API 做什么、它的权限与安全模型、在哪里受支持，以及不受支持时的回退 方案。
File System Access APIshowOpenFilePicker()、showSaveFilePicker() 与 showDirectoryPicker() 返回指向真实文件的句柄。本页列出全部选项、它们会以哪些异常拒绝，以及没有选择器时的回退路径。
Web Share APInavigator.share() 把 URL、标题、文本或文件交给系统分享面板，canShare() 先行校验。本页列出 ShareData 全部成员、每个 DOMException 及带回退分支的示例。
Payment Request APInew PaymentRequest(methodData, details, options)、canMakePayment()、show() 与 complete()，W3C 规范定义的每个异常，以及不支持时的托管结账回退方案。
Geolocation APIgetCurrentPosition() 与 watchPosition() 在权限提示之后报告设备位置。本页列出 PositionOptions 成员、三种错误码各在何时出现，以及带回退分支的示例。
Async Clipboard APInavigator.clipboard 的 read()、readText()、write()、writeText()，ClipboardItem 的成员，规范定义的每个 DOMException，以及带回退分支的复制与粘贴示例。
Web Bluetooth APInavigator.bluetooth.requestDevice() 弹出选择器让用户选一台蓝牙低功耗设备，并暴露其 GATT 服务。本页列出过滤器成员、每个异常，以及带回退分支的示例。
Screen Wake Lock APInavigator.wakeLock.request("screen") 在页面可见期间保持屏幕常亮。WakeLockSentinel、每种 NotAllowedError、隐藏时自动释放与 iOS 例外。
WebRTC APIRTCPeerConnection 的 offer/answer、ICE 与 RTCDataChannel，getUserMedia 约束。配置成员、规范定义的每个异常与带回退的检测示例。
Idle Detection APIIdleDetector 报告用户处于活跃还是空闲、屏幕是否锁定。本页说明 idle-detection 权限模型、60 秒最小阈值、规范定义的全部异常，并给出带回退分支的可运行示例。
Contact Picker APInavigator.contacts.select() 打开由浏览器绘制的选择器，只返回用户选中的联系人与属性。本页列出成员、异常、各版本支持情况与回退方案。
Credential Management APInavigator.credentials 的 get()、store()、create()、preventSilentAccess()：选项、mediation 模式、每个 DOMException 与浏览器缺口。
Digital Goods APIwindow.getDigitalGoodsService() 让 TWA 中的 PWA 接入 Google Play Billing：getDetails()、listPurchases()、consume() 及各自的异常与回退。
Document Picture-in-Picture APIdocumentPictureInPicture.requestWindow() 打开一个承载任意 HTML 的置顶窗口。本页列出全部选项、它会以哪些异常拒绝，以及带回退分支的示例。
EyeDropper APInew EyeDropper().open() 为自定义取色器拾取屏幕上任意像素的颜色。本页列出 signal 选项、open() 会以哪些异常拒绝，以及 Firefox 与 Safari 上的回退方案。
Local Font Access APIwindow.queryLocalFonts() 在 local-fonts 权限之后以 FontData 对象列出设备上安装的字体。本页给出选项、FontData 成员、全部异常，以及带回退的示例。
Local Network AccessChrome 142 在公网页面请求本地网络或回环地址前先征求权限。本页说明地址空间、两项权限、fetch 的 targetAddressSpace 选项，以及权限提示的原文。
Media Session APInavigator.mediaSession 向系统描述正在播放的内容，并接收来自系统媒体控件的播放、暂停、跳转与切曲动作。本页列出成员、全部动作、每个 TypeError 及可运行示例。
Navigation APIwindow.navigation 把单页应用路由收拢到一处：navigate()、navigate 事件与 intercept()、HTML 标准定义的每个异常，以及 History API 回退方案。
registerProtocolHandler() 与 manifest 协议处理程序navigator.registerProtocolHandler() 与 manifest 的 protocol_handlers 成员共用一套规则：web+ 协议名单、%s 占位符，以及 SecurityError 与 SyntaxError 的触发条件。
Screen Capture API（getDisplayMedia）navigator.mediaDevices.getDisplayMedia() 让用户选择屏幕、窗口或标签页并返回 MediaStream：每个选项、W3C 规范定义的每个异常，以及带特性检测的示例。
Generic Sensor APIAccelerometer、Gyroscope、Magnetometer 等共用 Sensor 基类。构造选项、error 事件错误名、Chromium 采样频率上限与带回退的检测。
Storage Buckets APInavigator.storageBuckets.open() 创建各自带 IndexedDB、caches、配额与过期时间的命名分区。选项、命名规则、每种拒绝与 Chrome 122 行为。
VirtualKeyboard APInavigator.virtualKeyboard.overlaysContent 阻止屏幕键盘压缩视口；boundingRect、geometrychange、show()/hide()、keyboard-inset env() 变量与失效前提。
WebHID APInavigator.hid.requestDevice() 配对一台人机接口设备，HIDDevice 负责收发输入、输出与特征报告。本页列出过滤器成员、每个异常，以及带回退分支的示例。
Web Locks APInavigator.locks.request() 持有命名独占锁或共享锁期间运行回调，跨标签页协调。LockOptions 成员、每种拒绝原因与带回退的示例。
Web NFC APINDEFReader.scan() 以 reading 事件送达 NFC 标签上的 NDEF 消息，write() 把记录写入标签。本页列出记录成员、每个异常，以及带回退分支的示例。
Web Serial APInavigator.serial.requestPort() 与 SerialPort.open() 把页面接到串口设备：请求与打开选项、规范定义的每个异常，以及可运行的读写示例。
WebUSB APInavigator.usb.requestDevice() 让页面配对没有类驱动的 USB 设备：过滤器、USBDevice 的传输方法、规范定义的每个异常，以及可运行示例。
WebAuthn 与通行密钥（passkeys）navigator.credentials.create() 与 get() 搭配 publicKey 注册并验证通行密钥：每个选项成员、各个 DOMException，以及可运行的登录示例。
WebCodecs APIVideoDecoder、VideoEncoder、AudioDecoder 与 AudioEncoder 提供逐帧的编解码器访问：configure、decode、encode、flush、每个异常，以及可运行示例。
WebGPU APInavigator.gpu.requestAdapter() 与 requestDevice() 把 GPU 交给页面。适配器与设备选项、每种拒绝、设备丢失处理与 WebGL2 回退。
WebTransport APIWebTransport() 构造函数打开一条承载可靠流与不可靠数据报的 HTTP/3 会话。本页列出构造选项、规范定义的每个异常、WebTransportError，以及 WebSocket 回退。
Window Management APIwindow.getScreenDetails() 枚举设备连接的每块屏幕，让 PWA 把窗口打开、移动或全屏到指定屏幕。本页列出 ScreenDetailed 成员、window-management 权限及其 NotAllowedError 情形，以及回退方案。
← 返回参考总览。