H5调用uni.setClipboardData没反应，因其仅支持App和小程序；H5必须降级用navigator.clipboard.writeText（需HTTPS+用户手势同步触发）或document.execCommand兜底。
网页版（H5）在 uni-app 中调用剪贴板 API 失败，根本原因不是 uni-app 本身的问题，而是浏览器策略限制——navigator.clipboard 必须运行在安全上下文 + 用户手势触发的同步上下文中，缺一不可。
为什么 H5 调用 uni.setClipboardData 没反应？
因为 uni.setClipboardData 在 H5 平台压根不生效，它只对 App 和小程序起作用。H5 端必须降级使用原生 navigator.clipboard.writeText 或兜底方案 document.execCommand。直接调用 uni.setClipboardData 会静默失败，控制台无报错、无回调，这是最常被忽略的第一步。
- 检查当前环境是否为 H5：
process.env.UNI_PLATFORM === 'h5' - 别在
onLoad、mounted或setTimeout里调用剪贴板操作 -
data参数必须是字符串，传number或object会被转成空串
H5 复制必须满足的三个硬性条件
浏览器不会给你商量余地，三者缺一不可：
-
window.isSecureContext必须为true：即页面必须通过 HTTPS 或localhost访问；http://127.0.0.1或局域网 IP（如http://192.168.x.x）均不满足 - 调用必须在用户手势事件的同步执行流中：比如
@click回调函数体内，不能在Promise.then、async/await后续语句、或任何异步回调里 - 部分安卓 WebView（尤其是旧版 UC、QQ 浏览器）根本不支持
navigator.clipboard，得 fallback 到document.execCommand
怎么写一个兼容性可靠的 H5 复制函数？
不要只依赖 navigator.clipboard.writeText，要分层检测 + 渐进降级：
- 先判断：
if (navigator.clipboard && window.isSecureContext) - 再尝试
navigator.clipboard.writeText(text)，用try/catch捕获NotAllowedError - 失败后创建临时
<textarea>，调用select()和execCommand('copy')；注意 iOS Safari 要加setSelectionRange(0, text.length) - 最后移除临时 DOM 节点，避免内存泄漏
function copyToClipboard(text) {
if (!text || typeof text !== 'string') return Promise.reject('invalid input');
if (navigator.clipboard && window.isSecureContext) {
return navigator.clipboard.writeText(text);
}
return new Promise((resolve, reject) => {
const textarea = document.createElement('textarea');
textarea.value = text;
document.body.appendChild(textarea);
textarea.select();
if (textarea.setSelectionRange) {
textarea.setSelectionRange(0, text.length);
}
try {
document.execCommand('copy');
resolve();
} catch (e) {
reject(e);
} finally {
document.body.removeChild(textarea);
}
});
}
读取剪贴板在 H5 是不可能的
uni.getClipboardData 在 H5 平台完全不可用，浏览器禁止网页主动读取剪贴板内容——这不是配置或权限问题，是策略封死。所谓“自动粘贴”在 H5 里不存在，只能靠用户手动 Ctrl+V。如果你看到某段代码在 H5 里“读取成功”，大概率是用了错误的测试方式（比如本地文件协议打开、或误判了 mock 数据）。
真正容易被忽略的是：iOS Safari 对 document.execCommand('copy') 的兼容性极差，且对 textarea 的聚焦和选中极其敏感；而很多开发者在 H5 环境下仍试图调用 uni.getClipboardData，结果永远拿到空字符串或 pending Promise，却没意识到这是平台能力缺失，不是代码写错了。
