商品海报生成器点「复制图片」,Chrome 121 控制台抛 NotAllowedError: The request is not allowed by the user agent or the platform in the current context。同一次点击里纯文本复制是好的,换成图片一定失败。
第一反应是权限,查 permissions.query 的 CLIpboard-write 状态是 granted,页面也是 https。把 write 换成 readText 试,同样报错,说明问题不在内容类型上。
拿掉中间的 await 才暴露原因:原代码先 await fetch 拿模板图,再 await canvas.toBlob,最后才调 navigator.Clipboard.write。Chrome 的用户手势有效期很短,几次异步之后手势已经消费掉,剪贴板写入被判定不是用户主动触发。文本能过,是因为它在第一个 await 之前就同步写完了。
试过让按钮先同步写一个空字符串占位,异步回来再补图片,第二次仍然报错。剪贴板 API 一次手势只认一次写入,占位这招没用。
改成把 Promise 直接塞进 ClipboardItem:new ClipboardItem({'image/png': blobPromise})。构造函数接收 Promise,浏览器在手势还有效时发起写入,后面的 await 只是等内容兑现。Chrome 121 上通过,Safari 17.2 本来就只支持 Promise 的写法,一套代码两边都能跑。
兜底留在 catch 里:写失败就把 blob 转成 objectURL 触发下载,提示改成「图片已下载」。上线一周看埋点,Chrome 成功率 98.6%,剩下 1.4% 是用户关了剪贴板权限,走下载分支后没再收到投诉。
btn.onclick = () => {
const png = fetch('/tpl.png')
.then((r) => r.blob())
.then((b) => toPng(b));
navigator.clipboard
.write([new ClipboardItem({ 'image/png': png })])
.catch(() => download(png));
}; 