剪贴板
Clipboard
是 剪贴板 API 的接口,提供对系统剪贴板内容的读写访问权限。这使 Web 应用程序能够实现剪切、复制和粘贴功能。
系统剪贴板通过全局的 Navigator.clipboard
属性公开。
所有剪贴板 API 方法都是异步操作;它们返回一个 Promise
,当剪贴板访问完成时,该承诺将得到解决。如果拒绝剪贴板访问,则该承诺将被拒绝。
实例方法
Clipboard
基于 EventTarget
接口,并包含其方法。
read()
-
从剪贴板请求任意数据(如图像),返回一个
Promise
,该承诺将在剪贴板内容可用时通过包含剪贴板内容的ClipboardItem
对象数组得到解决。 readText()
-
从系统剪贴板请求文本,返回一个
Promise
,该承诺将在文本可用时通过包含剪贴板文本的字符串得到解决。 write()
-
将任意数据写入系统剪贴板,返回一个
Promise
,该承诺在操作完成后得到解决。 writeText()
-
将文本写入系统剪贴板,返回一个
Promise
,该承诺在文本完全复制到剪贴板后得到解决。
规范
规范 |
---|
剪贴板 API 和事件 # clipboard-interface |
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。