JavaScript 操作剪贴板主要使用异步的 navigator.clipboard API，需在 HTTPS/localhost 安全上下文及用户手势（如 click）中调用 writeText() 或 readText()，旧版浏览器可降级使用 document.execCommand('copy')。

JavaScript 中操作剪贴板主要依靠 navigator.clipboard API，它提供了异步的复制（writeText()）和粘贴（readText()）能力，安全、现代且无需依赖 Flash 或 document.execCommand（已废弃）。

复制文本到剪贴板

调用 navigator.clipboard.writeText() 即可将字符串写入系统剪贴板。该方法返回 Promise，需在用户手势（如点击）触发的上下文中执行，否则会被浏览器拒绝。

• 确保代码运行在 HTTPS 环境或 localhost（非安全上下文下 clipboard API 不可用）
• 必须由用户交互事件（如 click、keydown）直接触发，不能放在 setTimeout 或异步回调中延迟调用
• 示例：

document.getElementById('copyBtn').addEventListener('click', async () => {
  try {
    await navigator.clipboard.writeText('Hello, clipboard!');
    console.log('复制成功');
  } catch (err) {
    console.error('复制失败:', err);
  }
});

从剪贴板读取文本内容

使用 navigator.clipboard.readText() 获取当前剪贴板中的纯文本。同样需用户手势触发，且页面需处于前台（焦点状态）。

• 读取前建议先检查权限：navigator.permissions.query({ name: 'clipboard-read' })
• 部分浏览器（如 Safari）对 readText() 限制更严格，可能要求用户主动授权或仅允许在粘贴事件中读取
• 示例（配合粘贴事件更稳妥）：

document.addEventListener('paste', async (e) => {
  e.preventDefault();
  try {
    const text = await navigator.clipboard.readText();
    console.log('粘贴内容：', text);
    // 插入到编辑区域等后续处理
  } catch (err) {
    console.error('读取剪贴板失败:', err);
  }
});

兼容旧版浏览器的降级方案

对于不支持 navigator.clipboard 的环境（如 IE 或较老版本 Edge），可回退到 document.execCommand('copy') 方案，但需借助临时 元素并手动聚焦选中。

• 创建隐藏的 ，设置值并选中全部文本
• 调用 document.execCommand('copy')，之后立即移除元素
• 注意：该方法已废弃，仅作兼容用，不推荐新项目依赖

注意事项与常见问题

剪贴板操作受浏览器策略强约束，实际开发中需关注以下几点：

• 权限模型：Chrome 66+ 默认要求用户手势 + 安全上下文；Firefox 需显式请求 clipboard-read 权限
• 移动端支持良好，但 iOS Safari 对 readText() 支持有限（通常只响应 paste 事件）
• 避免在无交互场景下静默调用，否则会抛出 NotAllowedError
• 敏感内容（如密码）不建议自动复制，应明确提示用户确认