navigator.clipboard 复制失败报 NotAllowedError 非 HTTPS 页面怎么兜底

现象

按钮里调用 navigator.CLIpboard.writeText 复制邀请码,本地开发正常,上线后部分用户点击没有任何反应。控制台报 NotAllowedError: Document is not focused 或 Write permission denied,而手动选中文字按复制却完全正常。

原因

剪贴板 API 要求安全上下文,http 页面直接不可用。它还必须在用户手势的调用栈里执行,经过 await 或者 setTimeout 之后手势已经失效,调用会被拒绝。页面处于 iframe 且没有 allow=Clipboard-write 权限时同样会失败。

解决步骤

第一步,先判断能力,再降级到 execCommand。失败时不要抛错给用户看,用隐藏的 textarea 选中文本执行复制,这条路在 http 页面也能用。

async function copy(text) {
  if (navigator.clipboard && window.isSecureContext) {
    try {
      await navigator.clipboard.writeText(text);
      return true;
    } catch (e) {}
  }
  const ta = document.createElement("textarea");
  ta.value = text;
  ta.style.position = "fixed";
  ta.style.opacity = "0";
  document.body.appendChild(ta);
  ta.select();
  const ok = document.execCommand("copy");
  ta.remove();
  return ok;
}

第二步,不要在手势之外调用。点击事件里同步执行复制,不要先 await 一个接口再写剪贴板;确实要请求数据时,提前把文本准备好,或者让用户再点一次。

第三步,iframe 场景加权限。嵌入方在 iframe 上写 allow="clipboard-write",否则子页面怎么调都会被拒绝,这一点经常被忽略。

验证

在 http 测试域名和 https 正式域名各点一次,确认都能复制成功;再在微信内置浏览器里长按粘贴,结果应与邀请码完全一致,没有多余空格。

小结

复制失败多半是安全上下文和手势时效的问题。先走 clipboard API,失败降级 execCommand,注意调用时机和 iframe 权限,覆盖率就能拉满。

您可以还会对下面的文章感兴趣: