navigator.clipboard.writetext() 写入失败的常见原因包括：非安全上下文（非https且非localhost）、非用户手势触发、异步延迟调用、iframe缺失allow="clipboard-write"属性、浏览器权限静默拒绝、文档未聚焦或标签页非活跃，以及safari等浏览器需额外权限声明或不支持。
Clipboard API 写入失败的常见原因
调用 navigator.clipboard.writeText() 报错 “Failed to execute 'writeText' on 'Clipboard': Document is not focused or permission denied”，基本是因为当前上下文不满足安全要求：页面必须是 HTTPS（本地 http://localhost 除外），且调用必须由用户手势（如 click、keydown）触发，不能在异步回调（如 setTimeout、fetch.then）中直接调用。
如何正确调用 writeText() 并处理拒绝情况
必须包裹在用户事件监听器中，并显式捕获 Promise 拒绝。浏览器不会自动弹出权限提示，而是静默拒绝——只有首次调用时可能触发权限请求（取决于 UA 实现），但更常见的是直接 reject。
- 使用
button.addEventListener('click', async () => { ... })，而非onload或定时器 - 必须用
try/catch或.catch()处理失败，例如用户禁用了剪贴板权限或处于 iframe 无权限上下文 - 不要假设
navigator.clipboard一定存在：Safari 13.1+ 和旧版 Android WebView 不支持，需降级到document.execCommand('copy')（仅限文本）
示例：
button.addEventListener('click', async () => {
try {
await navigator.clipboard.writeText('Hello, world!');
console.log('Copied');
} catch (err) {
console.error('Copy failed:', err.name); // 可能是 'NotAllowedError' 或 'SecurityError'
}
});
writeText() 与 execCommand('copy') 的关键区别
writeText() 是现代标准，支持跨域 iframe（若启用 clipboard-write 权限策略），而 document.execCommand('copy') 已废弃，依赖 <textarea></textarea> 临时聚焦和选中，兼容性好但行为不可靠。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
writeText()只接受字符串，不能写 HTML 或富文本；如需写 HTML，得用navigator.clipboard.write()+ClipboardItem（目前仅 Chromium 系支持较好） -
execCommand在 Firefox 87+ 和 Safari 中已完全移除，不能用于新项目 - 移动端 iOS Safari 对
writeText()支持稳定，但部分 Android WebView 仍需 fallback
权限策略与 iframe 场景下的注意事项
如果页面嵌在 iframe 中，父页面需显式声明 clipboard-write 权限，否则子 frame 调用会直接被拒：
<iframe src="child.html" allow="clipboard-write"></iframe>
另外，某些浏览器（如 Chrome）对非活跃标签页的剪贴板写入会静默失败，即使有用户手势——这意味着切换标签后立即点击复制按钮，可能因页面未“激活”而失败。可监听 visibilitychange 做状态提示，但无法绕过该限制。
真正容易被忽略的是：没有用户手势上下文时，连 await navigator.clipboard.readText() 都会失败，而写入失败往往比读取更难定位，因为错误信息太笼统，且不同浏览器返回的 err.name 不一致（'NotAllowedError'、'SecurityError'、'NotFoundError' 都可能出现）。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
