navigator.clipboard可用需同时满足：HTTPS/localhost安全上下文、用户手势同步触发、浏览器支持；否则返回undefined或报NotAllowedError/SecurityError。
检查 navigator.clipboard 是否可用且权限正常
现代浏览器中复制粘贴功能主要依赖 navigator.clipboard，但它不是总能用——比如页面没在 HTTPS 下、不在用户手势触发上下文（如 click 事件内）、或用户禁用了剪贴板权限，都会导致 clipboard.writeText() 报错或静默失败。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 先在控制台执行
typeof navigator.clipboard，确认返回"object"；若为"undefined"，说明浏览器不支持（如 IE 或旧版 Safari） - 在用户点击等同步事件中调用，避免异步延迟后触发（例如
setTimeout或 Promise resolve 后调用会失败） - 捕获错误并打印：用
try/catch包裹clipboard.writeText()，常见错误是"NotAllowedError"（权限拒绝）或"SecurityError"（非安全上下文） - 检查地址栏是否显示锁形图标，HTTP 页面下
clipboardAPI 默认被禁用
粘贴事件监听不到？确认 paste 事件绑定位置和时机
paste 是 DOM 事件，但只在焦点元素上触发，且默认行为（插入文本）可能被阻止后导致“看似没响应”。另外，它不会冒泡到 document 外层，也不能靠委托到 body 就稳抓所有粘贴。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 把
addEventListener('paste', handler)绑定到具体可编辑元素（如contenteditable="true"的<div> 或 <code><textarea></textarea>），而非document - 确保目标元素有焦点：用
element.focus()主动聚焦，或引导用户点击该区域后再粘贴 - 别忘了调用
event.preventDefault()—— 否则你拿到event.clipboardData，但浏览器仍按默认逻辑插入内容，容易造成重复或格式错乱 - 从
event.clipboardData?.getData('text/plain')读取纯文本；若需 HTML，用'text/html'，但注意跨域图片等资源可能被过滤 - 优先降级：检测
clipboard.write是否存在，不存在就 fallback 到writeText()+ 提示“仅支持纯文本” - 构造
ClipboardItem时，Blob的 MIME 类型必须精确匹配（如'text/html'、'image/png'），错一个字母就会静默失败 - 不要直接传
new Blob([htmlString], {type: 'text/html'})—— 需确保字符串是 UTF-8 编码，否则中文变乱码；推荐加{type: 'text/html;charset=utf-8'} - 移动端 WebView（如微信内置浏览器）大概率不支持
clipboard.write()，别指望它能复制图片 - 对所有
clipboard.*()调用加.catch(console.error)，别只写.then() - 在
paste回调开头就打console.log('paste triggered')，确认事件是否到达；再检查event.clipboardData是否为null（Safari 在某些场景下会清空它） - 禁用浏览器插件临时测试——有些广告拦截或隐私扩展（如 uBlock Origin）会主动屏蔽剪贴板 API
- 用 Chrome 的 Application → Clear storage → “Clear site data” 清掉权限缓存，重试看是否从
"NotAllowedError"变成弹窗请求权限
复制内容含富文本或图片时，clipboard.write() 怎么写才兼容
单纯用 clipboard.writeText() 只能写纯文本。如果要复制带样式的 HTML、甚至截图（Blob），得用更底层的 clipboard.write()，传入 ClipboardItem 数组。但这个 API 兼容性差，Chrome 76+ 支持，Firefox 和 Safari 基本不支持或仅限部分 MIME 类型。
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
实操建议：
立即学习“前端免费学习笔记（深入）”；
调试时看不到错误？用 console.error 捕获 Promise reject 和事件中断
剪贴板操作基本都是 Promise，而 paste 事件又常被 preventDefault() 中断，这两类问题在控制台里不会自动报红，容易误判为“没触发”。
实操建议：
立即学习“前端免费学习笔记（深入）”；
真正卡住的地方往往不是 API 写错了，而是权限状态、上下文生命周期、或浏览器策略的隐式限制——比如用户点了按钮但没真正聚焦输入框，或者 HTTPS 混合了 HTTP 资源导致整个页面降权。调试时先确认“谁没动”，再查“为什么不能动”。
