现代浏览器支持 navigator.clipboard.writeText() 复制文本，但必须由用户手势触发、运行在 HTTPS 环境下；失败时需 try/catch 捕获，旧版浏览器可回退到 document.execCommand('copy') 并临时创建隐藏 textarea。
点击按钮触发 navigator.clipboard.writeText() 复制
现代浏览器（Chrome 66+、Firefox 63+、Edge 79+、Safari 13.1+）支持原生剪贴板 API，navigator.clipboard.writeText() 是最直接的实现方式。它返回 Promise，成功时无返回值，失败时抛出异常。
常见错误：直接调用该方法但未在用户手势（如 click）中触发，会报 NotAllowedError: Write permission denied —— 浏览器强制要求复制操作必须由用户主动行为启动。
实操建议：
- 绑定到
button或带role="button"的元素的click事件里，不能放在DOMContentLoaded或定时器中自动执行 - 务必加
try/catch捕获拒绝情形（如用户禁用权限、页面非安全上下文（HTTP）、iframe 无权限等） - 复制内容建议先
.trim()，避免意外空格或换行干扰粘贴效果
<button id="copyBtn">复制文本</button>
<span id="status"></span>
<script>
document.getElementById('copyBtn').addEventListener('click', async () => {
try {
await navigator.clipboard.writeText('Hello, world!');
document.getElementById('status').textContent = '已复制！';
} catch (err) {
console.error('复制失败:', err);
document.getElementById('status').textContent = '复制失败';
}
});
</script>
兼容旧版浏览器：回退到 document.execCommand('copy')
IE 和部分老版本 Chrome/Firefox 不支持 navigator.clipboard，需用已废弃但广泛兼容的 document.execCommand('copy')。它依赖临时创建并聚焦一个 <textarea>，再选中内容执行命令。
立即学习“前端免费学习笔记（深入）”；
关键限制：该方法仅在页面处于激活状态（document.hasFocus() === true）且元素可聚焦时有效；Safari 13.1+ 已移除支持，所以不是万能兜底。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
实操建议：
- 只在
navigator.clipboard不可用时启用此方案（用if (!navigator.clipboard)判断） -
<textarea>必须添加style="position: absolute; left: -9999px;"隐藏，且不能设display: none或visibility: hidden（否则无法选中） - 执行前要先
.select()再.setSelectionRange(0, 999999)（兼容移动端 Safari）
从指定 DOM 元素读取文本而非硬编码
实际场景中，要复制的文本往往来自页面某段 <p>、<pre> 或 <code> 标签，而不是写死在 JS 里。直接取 .innerText 最稳妥，它忽略样式、脚本、注释，只提取视觉上可见的纯文本。
注意点：
- 避免用
.textContent—— 它会把<script>、注释、display: none元素的内容也拉进来 - 若目标是代码块（如
<pre><code>），可能需要额外处理缩进或行首空格，.innerText会保留换行和合理空白，通常够用 - 若元素含富文本（如内联
<strong>），.innerText仍能正确拼接，比正则解析 HTML 安全得多
<pre id="codeBlock"><code>fetch('/api').then(r => r.json());</code></pre>
<button onclick="copyFromEl('codeBlock')">复制代码</button>
<script>
function copyFromEl(id) {
const el = document.getElementById(id);
if (!el) return;
const text = el.innerText;
navigator.clipboard.writeText(text).catch(() => {
// 回退逻辑...
});
}
</script>
HTTPS 环境与 iframe 权限限制
navigator.clipboard 在非 HTTPS 页面（http://）下会被完全禁用，控制台报 SecurityError: Clipboard API denied。本地开发用 file:// 协议也会失败 —— 必须通过本地服务器（如 python3 -m http.server）访问。
如果页面嵌在 <iframe> 中，还需检查其 sandbox 属性是否包含 "allow-scripts allow-same-origin"，否则剪贴板 API 不可用。
容易被忽略的点：即使你写了完整的 try/catch，只要页面没走 HTTPS 或运行在 file 协议下，Promise 就永远不会 resolve，也不会进入 catch —— 它直接被浏览器拦截，静默失败。调试时务必先确认地址栏是 https:// 或 localhost。
