javascript剪贴板API如何使用_如何读取和写入剪贴板?

JavaScript剪贴板API需在HTTPS或localhost安全上下文中,由用户手势触发;writeText()和readText()均返回Promise,支持文本读写,Chrome 115+实验性支持图片写入,Safari读取受限,建议检查权限并兼容降级。

javascript剪贴板api如何使用_如何读取和写入剪贴板?

JavaScript 剪贴板 API(navigator.clipboard)可以安全地读写系统剪贴板,但必须在安全上下文(HTTPS 或 localhost)中运行,且需要用户主动触发(比如点击事件),不能自动执行。

写入文本到剪贴板

调用 clipboard.writeText() 方法,返回 Promise:

成功时 resolve,无返回值 失败时 reject(如权限被拒、非用户手势触发)

示例:

button.addEventListener('click', async () => {  try {    await navigator.clipboard.writeText('Hello, world!');    console.log('已复制到剪贴板');  } catch (err) {    console.error('复制失败:', err);  }});

读取文本内容

使用 clipboard.readText(),同样返回 Promise:

立即学习“Java免费学习笔记(深入)”;

仅支持纯文本,不支持 HTML 或富文本(除非手动解析) 部分浏览器(如 Safari)可能限制读取,需明确用户授权

示例:

button.addEventListener('click', async () => {  try {    const text = await navigator.clipboard.readText();    console.log('剪贴板内容:', text);  } catch (err) {    console.error('读取失败:', err);  }});

处理权限与兼容性

不是所有浏览器都默认允许剪贴板访问,建议检查权限状态:

navigator.permissions.query({ name: 'clipboard-read' })'clipboard-write' 查询 Chrome/Edge 94+ 支持无提示写入(只要在用户手势内);读取仍可能弹权限请求 Safari 对 readText() 限制较严,有时会静默拒绝 旧版可用 document.execCommand('copy') 降级(需配合 操作,已废弃但仍有兼容价值)

写入图片(实验性支持)

Chrome 115+ 支持 clipboard.write() 写入图片 Blob:

需构造 ClipboardItem,传入 { 'image/png': blob } 等格式 目前仅限 PNG/JPEG,且需用户手势 + 安全上下文 暂不推荐生产环境依赖,可用作增强体验

示例片段:

const blob = await fetch('logo.png').then(r => r.blob());await navigator.clipboard.write([  new ClipboardItem({ 'image/png': blob })]);

基本上就这些。核心原则:用户触发、HTTPS、处理 Promise 异常、兼顾老浏览器可选降级。不复杂但容易忽略上下文和权限细节。

以上就是javascript剪贴板API如何使用_如何读取和写入剪贴板?的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1543544.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月21日 15:08:16
下一篇 2025年12月11日 11:42:12

相关推荐

发表回复

登录后才能评论
关注微信