JavaScript Clipboard API 需在安全上下文运行且写入操作须用户手势触发；writeText() 和 readText() 是常用方法，但读取限制更多、移动端兼容性差；高级用法如 write() 支持多格式但仅 Chromium 稳定支持；需检测 API 存在并降级处理。
javascript 的 clipboard api 提供了在浏览器中读写系统剪贴板的能力，但必须在安全上下文（https 或 localhost）中运行，且多数写入操作需用户手势触发（如 click、tap），不能自动执行。
写入文本到剪贴板
使用 navigator.clipboard.writeText() 是最常用方式，返回 Promise，成功则无返回值，失败会抛出异常。
- 确保调用发生在用户交互事件内（例如 button 的 click 回调）
- 建议包裹 try/catch 处理权限拒绝或写入失败
- 示例：await navigator.clipboard.writeText("Hello World");
读取剪贴板中的文本
navigator.clipboard.readText() 可获取当前剪贴板文本内容，同样需用户手势触发，并要求页面有焦点。
- 部分浏览器（如 Safari）对 readText 支持有限，可能需要额外权限声明或降级方案
- 读取前可先检查权限：const perm = await navigator.permissions.query({name: "clipboard-read"});
- 注意：读取操作比写入更受限制，移动端兼容性较差
处理富文本或图片（高级用法）
通过 navigator.clipboard.write() 写入多种格式数据（如 HTML、image/png），需构造 ClipboardItem 对象。
- 仅 Chromium 内核浏览器（Chrome、Edge）稳定支持，Firefox 和 Safari 支持度低
- 图片需转为 Blob，再传入 ClipboardItem：new ClipboardItem({"image/png": blob})
- HTML 格式常配合纯文本 fallback 使用，提升兼容性
权限与兼容性注意事项
Clipboard API 不是全平台开箱即用，实际使用需兼顾降级和提示。
立即学习“Java免费学习笔记（深入）”；
- 检查 API 是否存在：if (!navigator.clipboard) { /* 降级用 document.execCommand */ }
- 旧版方案可用 document.execCommand("copy")（已废弃但仍有支持），需配合
<textarea>临时聚焦 - 移动端需注意：iOS Safari 直到 16.4 才支持 writeText，且 readText 基本不可用
