关于js复制内容到浏览器剪贴板报错：Cannot read properties of undefined (reading ‘writeText‘)的解决方案

如果想直接看解决方案，请下滑到最后【完整代码】处

问题描述

开发「复制」功能

根据使用浏览器提供的原生功能 navigator.clipboard 返回的 Clipboard 对象的方法 writeText() 写文本到剪贴板。

在本地开发，或者说是在使用http://127.0.0.1:8088 或者 http://localhost:8088 本地调试时，是没有问题的，但是如果使用绑定 host 或者使用不安全域（域名+http）时，使用此功能，就会发生下面的报错：

bash 复制代码

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已经被官方废弃掉了】

👇「复制」功能示例：

js 复制代码

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('当前浏览器不支持复制功能，请检查更新或更换其他浏览器操作')
	}
}

完整代码

js 复制代码

 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('当前浏览器不支持复制功能，请检查更新或更换其他浏览器操作')
		}
    }
}

所有问题都解决啦～

总结

希望上面的内容对你的工作学习有所帮助！欢迎各位一键三连哦～

各位加油！

Happy coding！