跳转到内容

Async Clipboard API 浏览器支持

发布于

navigator.clipboard 暴露 read()、write() 以及仅处理文本的 readText()、writeText(),让页面可以用脚本复制和粘贴,而不必依赖 document.execCommand('copy')。

下表覆盖 MDN browser-compat-data 记录的 Clipboard 接口。各引擎对读取的限制不同(clipboard-read 权限、用户手势处理函数或粘贴提示),具体以各行脚注为准。

  • 图例
  • 支持
  • 部分支持
  • 需开启标志
  • 不支持
  • 未知
浏览器 / 平台支持版本置信度来源备注
Chrome (Desktop)支持76高来源1
Chrome (Android)支持76高来源23
Edge (Desktop)支持79高来源45
Firefox (Desktop)支持127高来源678
Firefox (Android)支持127高来源9101112
Safari (macOS)支持13.1高来源—
Safari (iOS)支持13.4高来源13
Samsung Internet支持12.0高来源1415
WebView (Android)支持76高来源1617
  1. 用户必须授予 `clipboard-read` 权限。
  2. 用户必须授予 `clipboard-read` 权限。
  3. 由 browser-compat-data 镜像自 Chrome 的数据推导。
  4. 用户必须授予 `clipboard-read` 权限。
  5. 由 browser-compat-data 镜像自 Chrome 的数据推导。
  6. 此方法必须在用户手势事件的处理函数内调用。
  7. 读取剪贴板时会显示粘贴提示;若剪贴板内容来自同源,则不显示该提示。
  8. manifest 中声明了 `clipboardRead` 权限的 Web 扩展可以不经粘贴提示直接读取数据。Firefox 147 之前,没有该权限的扩展无法读取剪贴板数据。
  9. 此方法必须在用户手势事件的处理函数内调用。
  10. 读取剪贴板时会显示粘贴提示;若剪贴板内容来自同源,则不显示该提示。
  11. manifest 中声明了 `clipboardRead` 权限的 Web 扩展可以不经粘贴提示直接读取数据。Firefox 147 之前,没有该权限的扩展无法读取剪贴板数据。
  12. 由 browser-compat-data 镜像自 Firefox 的数据推导。
  13. 由 browser-compat-data 镜像自 Safari 的数据推导。
  14. 用户必须授予 `clipboard-read` 权限。
  15. 由 browser-compat-data 镜像自 Chrome Android 的数据推导。
  16. 用户必须授予 `clipboard-read` 权限。
  17. 由 browser-compat-data 镜像自 Chrome Android 的数据推导。

源数据: /compatibility/clipboard.json · 全球使用占比: 93 % (StatCounter 2026-05)

来源: 规范 · MDN · 最近核验 2026-10-03 · 置信度: 高 (由来源计算)