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

Clipboard

· 52CE 我爱测

Clipboard API 的 **`Clipboard`** 接口提供系统剪贴板读写访问的权限。这让 Web 应用程序可以实现剪切、复制和粘贴功能。

Clipboard API

Clipboard API 的 Clipboard 接口提供系统剪贴板读写访问的权限。这让 Web 应用程序可以实现剪切、复制和粘贴功能。

系统剪贴板暴露于全局属性 Navigator.clipboard 之中。

所有 Clipboard API 方法都是异步的;它们返回一个 Promise 对象,在剪贴板访问完成后被兑现。如果剪贴板访问被拒绝,promise 也会被拒绝。

所有的方法也都需要安全上下文。使用 API 的其他要求在 API 概述主题的安全考虑部分进行了讨论。

方法

Clipboard 继承自 EventTarget 接口,因此拥有它的方法。

  • Clipboard.read()
    • : 从剪贴板读取数据(比如图片),返回一个 Promise。在检索到数据后,其将兑现为包含剪贴板数据的 ClipboardItem 对象数组。
  • Clipboard.readText()
    • : 从操作系统剪切板读取文本,返回一个 Promise,一旦数据可用,其将兑现为包含剪切板文本的字符串。
  • Clipboard.write()
    • : 写入任意数据至操作系统剪贴板,返回一个在操作完成时被兑现的 Promise。
  • Clipboard.writeText()
    • : 写入文本至操作系统剪贴板。返回一个在文本已被完全写入剪贴板后兑现的 Promise。

规范

浏览器兼容性

参见

  • Document.execCommand()

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

资料来源与适用范围

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

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

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