javascript单元测试中mock clipboard api需替换navigator.clipboard为可控promise对象：在beforeeach中赋值mock方法并还原，兼容node环境需手动挂载，覆盖permissiondenied等错误场景，并确保secure context。
在 JavaScript 单元测试中 Mock Clipboard API，核心是替换全局的 navigator.clipboard 对象，使其返回可控的 Promise 行为，从而避免真实读写系统剪贴板。
手动替换 navigator.clipboard（适用于 Jest / Vitest）
最直接的方式是在测试前临时覆盖 navigator.clipboard，模拟 writeText、readText 等方法的返回值：
- 用
jest.mock()或直接赋值方式劫持navigator.clipboard - 确保 mock 方法返回
Promise.resolve()或Promise.reject()，匹配真实 API 的异步行为 - 注意：需在测试运行前设置，且建议在
beforeEach中还原，防止污染其他测试
示例（Jest）：
beforeEach(() => {
Object.assign(navigator, {
clipboard: {
writeText: jest.fn().mockResolvedValue(),
readText: jest.fn().mockResolvedValue('mocked text'),
},
});
});
afterEach(() => {
jest.clearAllMocks();
});
使用 Clipboard API 的 polyfill 或测试专用库
某些测试环境（如 Node.js）不支持 navigator.clipboard，可借助轻量工具增强兼容性：
-
clipboard-polyfill提供一致接口，可在测试中安全导入并 mock - Vitest 用户可配合
vi.mock模拟整个模块导出，更易控制内部逻辑 - 避免直接依赖浏览器全局对象，把 Clipboard 调用封装成可注入的服务，测试时传入 mock 实现
处理权限与拒绝场景
真实 Clipboard API 可能因权限被拒而抛错（如 "NotAllowedError"），Mock 时需覆盖这些边界情况：
- 让
writeText返回Promise.reject(new DOMException('Permission denied', 'NotAllowedError')) - 验证组件是否正确捕获错误、显示提示或降级处理
- 注意不同浏览器对
readText的权限要求更高，mock 时尤其要区分读/写行为
注意上下文安全性（Secure Context）限制
Clipboard API 只在 secure context（HTTPS 或 localhost）中可用。测试中若遇到 undefined，可能因环境不满足条件：
- Jest 默认运行在 Node 环境，
navigator.clipboard本就不存在，必须手动挂载 - Vitest 在浏览器模式下仍需确保测试页面以
http://localhost启动（而非file://） - 推荐统一通过
Object.defineProperty安全挂载，避免报错：
if (!navigator.clipboard) {
Object.defineProperty(navigator, 'clipboard', {
value: { writeText: jest.fn().mockResolvedValue() },
writable: true,
});
}
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
