/** * [INPUT]: 依赖浏览器 navigator.clipboard 与 document.execCommand('copy') * [OUTPUT]: 对外提供 copyText(text) → Promise——复制成功为 true,两条路都失败为 false * [POS]: lib 的剪贴板单一入口,v0.4.0 起归设计系统:MarkdownNotes 的代码块复制键依赖它,消费方的复制键也只走这里。 * 主路 Clipboard API;被拒(文档未聚焦、权限策略、微信等内置浏览器、非安全上下文)时回退隐藏 textarea + execCommand。 * 调用方据返回值给「已复制 / 复制失败」反馈,不静默吞错。只在点击时触碰浏览器对象,构建期服务端渲染安全。 * [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md */ export async function copyText(text) { try { window.focus() // 播放器 iframe 会抢走焦点,Clipboard API 要求文档已聚焦 await navigator.clipboard.writeText(text) return true } catch { // 降级:隐藏 textarea 选中后 execCommand } const ta = document.createElement('textarea') try { ta.value = text ta.setAttribute('readonly', '') ta.style.position = 'fixed' ta.style.top = '0' ta.style.opacity = '0' document.body.appendChild(ta) ta.focus() ta.select() return document.execCommand('copy') } catch { return false } finally { ta.remove() } }