Clipboard API
Clipboard 接口的 writeText() 方法用于将指定文本写入系统剪贴板,并返回一个在剪贴板内容更新后兑现的 Promise。
语法
writeText(newClipText)
参数
newClipText- : 要写入剪贴板的字符串。
返回值
一个在剪贴板内容更新后兑现的 Promise。
异常
NotAllowedErrorDOMException- : 如果不允许写入剪贴板,则抛出此异常。
安全考虑
只能在安全上下文中读取剪贴板。
其他安全要求在 API 概述主题的安全考虑一节中进行了介绍。
示例
本示例将剪贴板内容设置为字符串“<空剪切板>”。
button.addEventListener("click", () => writeClipboardText("<空剪切板>"));
async function writeClipboardText(text) {
try {
await navigator.clipboard.writeText(text);
} catch (error) {
console.error(error.message);
}
}
规范
浏览器兼容性
参见
- Clipboard API
- web.dev 上的解锁剪贴板权限
- Clipboard.write()
- Clipboard.read()
- Clipboard.readText()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
