语法
js
writeText(newClipText)
参数
newClipText-
要写入剪贴板的字符串。
返回值
一个在剪贴板内容更新后兑现的 Promise。
异常
NotAllowedErrorDOMException-
如果不允许写入剪贴板，则抛出此异常。
安全考虑
只能在安全上下文中读取剪贴板。
其他安全要求在 API 概述主题的安全考虑一节中进行了介绍。
示例
本示例将剪贴板内容设置为字符串“<空剪切板>”。
js
button.addEventListener("click", () => writeClipboardText("<空剪切板>"));
async function writeClipboardText(text) {
try {
await navigator.clipboard.writeText(text);
} catch (error) {
console.error(error.message);
}
}
规范
| 规范 |
|---|
| Clipboard API and events # dom-clipboard-writetext |