剪贴板

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,在一些或所有 支持的浏览器中。

Clipboard剪贴板 API 的接口,提供对系统剪贴板内容的读写访问权限。这使 Web 应用程序能够实现剪切、复制和粘贴功能。

EventTarget Clipboard

系统剪贴板通过全局的 Navigator.clipboard 属性公开。

所有剪贴板 API 方法都是异步操作;它们返回一个 Promise,当剪贴板访问完成时,该承诺将得到解决。如果拒绝剪贴板访问,则该承诺将被拒绝。

所有方法都需要 安全上下文。API 使用的其他要求在 API 概述主题的 安全注意事项 部分中讨论。

实例方法

Clipboard 基于 EventTarget 接口,并包含其方法。

read()

从剪贴板请求任意数据(如图像),返回一个 Promise,该承诺将在剪贴板内容可用时通过包含剪贴板内容的 ClipboardItem 对象数组得到解决。

readText()

从系统剪贴板请求文本,返回一个 Promise,该承诺将在文本可用时通过包含剪贴板文本的字符串得到解决。

write()

将任意数据写入系统剪贴板,返回一个 Promise,该承诺在操作完成后得到解决。

writeText()

将文本写入系统剪贴板,返回一个 Promise,该承诺在文本完全复制到剪贴板后得到解决。

规范

规范
剪贴板 API 和事件
# clipboard-interface

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

参见