嵌入 iframe 的复制按钮总报 NotAllowedError 权限该怎么降级

后台编辑器嵌在 iframe 里,复制分享链接的按钮点下去直接抛 NotAllowedError: Write permission denied。同一个页面单独打开是好的,嵌进 iframe 就废,用户只能手动选中再复制。

第一反应是安全上下文,确认顶层和 iframe 都是 https,不是 http 的问题。又试了 navigator.permissions.query 查 CLIpboard-write,返回 denied,说明权限确实没继承到这一层。

查到 iframe 需要 allow="Clipboard-write" 才能拿到剪贴板权限。加上之后 Chrome 124 正常,Safari 17.2 依旧抛错,它不认这个属性,只认用户手势。按钮的点击算手势,可调用链里隔了一次 await fetch,等链接回来时手势窗口已经过期。

改成点击后先同步写一个空字符串占位,把手势用掉,再发请求拿真实链接,最后用 document.execCommand 配合临时 textarea 兜底。这条老 API 在 Safari 上反而稳,代价是要自己处理选区,不能破坏用户已经选中的内容。

失败分支也补了:两种方式都失败时把链接塞进只读输入框并全选,提示长按复制,不再静默失败。埋点记 ok、exec、fail 三种结果,按天看比例。

确认:Chrome 124 上 500 次点击成功 500 次;Safari 17.2 成功 96%,剩下 4% 走兜底且都有提示;iframe 内外行为一致,顶层页面没有回归。

async function copy(text) {
  try {
    await navigator.clipboard.writeText(text);
    return 'ok';
  } 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 ? 'exec' : 'fail';
  }
}

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