推荐使用原生 Clipboard API 实现剪贴板操作,需在用户触发事件(如 click)中调用且页面处于安全上下文;readText() 读纯文本,writeText() 写文本,均返回 Promise 并需异常处理,兼容性方面 writeText() 优于 readText(),iOS Safari 对后者支持较晚。

JavaScript 实现剪贴板操作,现在主流且推荐的方式是使用原生的 Clipboard API,它基于 Promise,安全、简洁,无需依赖 Flash 或 document.execCommand(已废弃)。关键点是:必须在用户触发的事件(如 click、input)中调用,且页面需处于安全上下文(HTTPS 或 localhost)。
读取剪贴板内容(text/plain)
用 navigator.clipboard.readText() 获取纯文本。浏览器会自动请求权限(首次调用时弹出提示)。
- 只支持 text/plain 类型;若要读图片或 HTML,需用更底层的
read()方法(兼容性较差) - 必须在用户手势内调用,比如按钮点击里,不能在 setTimeout 或 fetch 回调里直接调
- 示例:
document.getElementById('pasteBtn').addEventListener('click', async () => {
try {
const text = await navigator.clipboard.readText();
document.getElementById('output').textContent = '粘贴内容:' + text;
} catch (err) {
console.error('读取失败:', err);
}
});
写入文本到剪贴板
用 navigator.clipboard.writeText(),比旧的 execCommand 更可靠,也无需聚焦元素。
- 同样需要用户触发,比如点击“复制”按钮
- 返回 Promise,成功无返回值,失败抛错(如用户拒绝权限、非安全上下文)
- 示例:
try {
await navigator.clipboard.writeText('Hello, Clipboard!');
alert('已复制');
} catch (err) {
console.error('复制失败:', err);
}
});
处理权限与兼容性
不是所有浏览器都完全支持 Clipboard API,尤其 iOS Safari 对 readText() 支持有限(iOS 16.4+ 才较稳定),writeText() 兼容性好得多。
立即学习“Java免费学习笔记(深入)”;
- 检查是否可用:
if ('clipboard' in navigator) - 检测权限状态:
navigator.permissions.query({ name: 'clipboard-read' })或'clipboard-write' - 降级方案:对不支持的环境,可 fallback 到创建临时 textarea + execCommand(仅限写入,且需 focus)
注意安全限制和常见错误
浏览器强制要求“用户激活”,所以以下写法会失败:
- 页面加载完自动复制(没用户交互)
- 在 fetch.then() 或 setTimeout 中调用 clipboard 方法
- iframe 中调用但未设置
allow="clipboard-write"属性 - HTTP 网站(非 HTTPS/localhost)尝试调用
基本上就这些。用好 Clipboard API 的核心就是:等用户点一下,再调用,捕获异常,留好降级路。











