17370845950

navigator.clipboard.writeText()是现代浏览器复制文本的首选方案，需在安全上下文和用户手势中调用，失败时可降级至document.execCommand('copy')。

使用 navigator.clipboard.writeText() 复制文本是最直接的方式

现代浏览器（Chrome 66+、Firefox 63+、Edge 79+、Safari 13.1+）支持 navigator.clipboard API，它比旧的 document.execCommand('copy') 更可靠、更安全，且无需聚焦输入框或创建临时 DOM 元素。

但必须注意：该 API 只在安全上下文（https:// 或 localhost）中可用，且调用必须由用户手势（如 click、keydown）触发，否则会抛出 "Permission denied" 错误。

• 直接调用 navigator.clipboard.writeText('hello') 会返回一个 Promise，成功则 resolve，失败则 reject
• 不能在定时器、网络回调或异步任务中“悄悄”调用——哪怕只是延迟 1ms 的 setTimeout，也会被浏览器拒绝
• 若页面未获得焦点（例如后台标签页），部分浏览器（如 Safari）可能静默失败，不抛错也不复制

button.addEventListener('click', async () => {
  try {
    await navigator.clipboard.writeText('复制成功的内容');
    console.log('已写入剪贴板');
  } catch (err) {
    console.error('复制失败:', err.name, err.message);
    // 常见错误：NotAllowedError（非用户手势）、SecurityError（非安全上下文）
  }
});

兼容老浏览器需降级到 document.execCommand('copy')

IE11 和部分旧版移动端浏览器不支持 navigator.clipboard，此时可回退到基于 execCommand 的方案。但它要求目标文本必须出现在可选中的 DOM 节点中，且该节点需处于 focus 状态。

这个方法已被标记为废弃（deprecated），且在 Chrome 94+ 中默认禁用（除非启用实验性 flag），因此只建议作为最小兼容兜底，不推荐新项目主用。

• 必须先将文本插入一个 或 ，设置 readonly 避免干扰用户输入
• 调用 .select() 选中内容，再执行 document.execCommand('copy')
• 复制后应立即移除或重置该临时元素，避免影响布局或屏幕阅读器
• 某些安卓 WebView（如微信内置浏览器）对 execCommand 支持极差，可能始终返回 false

function fallbackCopyText(text) {
  const textarea = document.createElement('textarea');
  textarea.value = text;
  textarea.setAttribute('readonly', '');
  textarea.style.position = 'absolute';
  textarea.style.left = '-9999px';
  document.body.appendChild(textarea);
  textarea.select();
  const success = document.execCommand('copy');
  document.body.removeChild(textarea);
  return success;
}

读取剪贴板内容需显式请求权限且受严格限制

navigator.clipboard.readText() 比写入更敏感，不仅需要安全上下文和用户手势，还要求页面已获得 'clipboard-read' 权限。浏览器通常不会自动授予，首次调用会弹出权限提示（类似摄像头请求）。

多数场景下，读取剪贴板不是刚需；若只是为了粘贴校验或快捷填充，建议改用监听 paste 事件更稳妥、更符合用户预期。

• 调用 readText() 前可先用 navigator.permissions.query({ name: 'clipboard-read' }) 检查当前状态（granted / denied / prompt）
• 即使权限为 granted，某些浏览器（如 Safari）仍可能因隐私策略限制仅允许在粘贴事件中读取
• 不要在页面加载时自动读取——既无意义，也大概率被拦截

安全风险与常见陷阱

剪贴板是跨应用共享的数据通道，浏览器对其访问做了多层防护。开发者容易忽略的点不是“怎么写”，而是“为什么没写成”。

• 开发时用 http://localhost 可以，但用 http://127.0.0.1 或文件协议（file://）会直接报 SecurityError
• Vue/React 中绑定在非原生事件（如自定义指令、computed setter）上的复制逻辑，往往脱离用户手势链，导致静默失败
• 在 iframe 中操作父页面剪贴板？不行。跨 origin iframe 默认无权访问父级 navigator.clipboard
• 复制长文本（> 1MB）在部分浏览器（尤其是 iOS Safari）可能触发截断或拒绝，无明确报错，需自行分段或降级提示

实际项目里，最稳的模式是：优先用 navigator.clipboard.writeText()，捕获 NotAllowedError 后尝试 execCommand 降级，同时确保所有调用都扎根在真实的 click 或 keydown 回调里。其他花招，基本都绕不开这个前提。