关于js复制内容到浏览器剪贴板报错:Cannot read properties of undefined (reading ‘writeText‘)的解决方案
作者:八了个戒
如果想直接看解决方案,请下滑到最后【完整代码】处
问题描述
开发「复制」功能
根据使用浏览器提供的原生功能 navigator.clipboard
返回的 Clipboard
对象的方法 writeText()
写文本到剪贴板。
在本地开发,或者说是在使用http://127.0.0.1:8088
或者 http://localhost:8088
本地调试时,是没有问题的,但是如果使用绑定 host 或者使用不安全域(域名+http)时,使用此功能,就会发生下面的报错:
Uncaught TypeError: Cannot read properties of undefined (reading 'writeText')
原因分析
安全问题
想必各位小伙伴或多或少会做过这样的操作,复制一下自己的个人信息然后粘贴到其他地方,看是所谓的方便如果遇到恶意有毒的钓鱼网站,那存在剪切板的信息就会一览无余,网络信息安全一直都是重中之重,所以在这方面上 navigator.clipboard
算是做足了防备。
SO~ 原因就是 浏览器禁用了非安全域的 navigator.clipboard
对象。
安全域包括本地访问与开启TLS安全认证的地址,如 https 协议的地址、127.0.0.1 或 localhost 。
问题解决
所以要解决这个问题就是要做一个兼容的写法,当我们处于在安全域下使用 navigator.clipboard
提升效率,非安全域时退回到 document.execCommand('copy')
保证我们的复制功能一直可用。
document.execCommand
这里先说一下 document.execCommand
写过原生 Editor 编辑器大家应该都知道这个API吧,API 里面有很多方法,如:加粗/斜体/字号/字体颜色/插入图片/插入链接/复制/剪切/撤销… 具体可以看 MDN【但是这个API已经被官方废弃掉了】
「复制」功能示例:
function copy(text = ''){ let input = document.createElement('input') input.style.position = 'fixed' input.style.top = '-10000px' input.style.zIndex = '-999' document.body.appendChild(input) input.value = text input.focus() input.select() try { let result = document.execCommand('copy') document.body.removeChild(input) if (!result || result === 'unsuccessful') { console.log('复制失败') } else { console.log('复制成功') } } catch (e) { document.body.removeChild(input) alert('当前浏览器不支持复制功能,请检查更新或更换其他浏览器操作') } }
完整代码
function copyToClipboard(textToCopy) { // navigator clipboard 需要https等安全上下文 if (navigator.clipboard && window.isSecureContext) { // navigator clipboard 向剪贴板写文本 return navigator.clipboard.writeText(textToCopy); } else { // document.execCommand('copy') 向剪贴板写文本 let input = document.createElement('input') input.style.position = 'fixed' input.style.top = '-10000px' input.style.zIndex = '-999' document.body.appendChild(input) input.value = textToCopy input.focus() input.select() try { let result = document.execCommand('copy') document.body.removeChild(input) if (!result || result === 'unsuccessful') { console.log('复制失败') } else { console.log('复制成功') } } catch (e) { document.body.removeChild(input) alert('当前浏览器不支持复制功能,请检查更新或更换其他浏览器操作') } } }
所有问题都解决啦~
总结
以上就是关于js复制内容到浏览器剪贴板报错:Cannot read properties of undefined (reading ‘writeText‘)的解决方案的详细内容,更多关于js复制内容到浏览器剪贴板报错的资料请关注脚本之家其它相关文章!