javascript clipboard api 需在安全上下文运行且写入操作须用户手势触发;writetext() 和 readtext() 是常用方法,但读取限制更多、移动端兼容性差;高级用法如 write() 支持多格式但仅 chromium 稳定支持;需检测 api 存在并降级处理。
javascript 的 clipboard api 提供了在浏览器中读写系统剪贴板的能力,但必须在安全上下文(https 或 localhost)中运行,且多数写入操作需用户手势触发(如 click、tap),不能自动执行。
写入文本到剪贴板
使用 navigator.clipboard.writeText() 是最常用方式,返回 Promise,成功则无返回值,失败会抛出异常。
- 确保调用发生在用户交互事件内(例如 button 的 click 回调)
- 建议包裹 try/catch 处理权限拒绝或写入失败
- 示例:await navigator.clipboard.writeText("Hello World");
读取剪贴板中的文本
navigator.clipboard.readText() 可获取当前剪贴板文本内容,同样需用户手势触发,并要求页面有焦点。
- 部分浏览器(如 Safari)对 readText 支持有限,可能需要额外权限声明或降级方案
- 读取前可先检查权限:const perm = await navigator.permissions.query({name: "clipboard-read"});
- 注意:读取操作比写入更受限制,移动端兼容性较差
处理富文本或图片(高级用法)
通过 navigator.clipboard.write() 写入多种格式数据(如 HTML、image/png),需构造 ClipboardItem 对象。
- 仅 Chromium 内核浏览器(Chrome、Edge)稳定支持,Firefox 和 Safari 支持度低
- 图片需转为 Blob,再传入 ClipboardItem:new ClipboardItem({"image/png": blob})
- HTML 格式常配合纯文本 fallback 使用,提升兼容性
权限与兼容性注意事项
Clipboard API 不是全平台开箱即用,实际使用需兼顾降级和提示。
- 检查 API 是否存在:if (!navigator.clipboard) { /* 降级用 document.execCommand */ }
- 旧版方案可用 document.execCommand("copy")(已废弃但仍有支持),需配合
<textarea></textarea>临时聚焦 - 移动端需注意:iOS Safari 直到 16.4 才支持 writeText,且 readText 基本不可用
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











