产品经理：“一个简单的复制功能也能写出bug？”

问题

刚入职时，遇到了一个线上 bug，用户点击复制按钮没办法复制文本，产品经理震怒，“这么简单的一个功能也能出问题？当时是谁验收的？”，因为我刚来还闲着，就把我派去解决这个问题。

我在排查问题时，发现该复制方法写在了一个自定义 hook 中（这里复制方法写在 hook 里没啥意义，但是乙方交付过来的代码好像特别喜欢把工具函数写成个 hook 来用），点进去查看就是简单的一个 navigator.clipboard.writeText()的方法，本地运行我又能复制成功。于是我怀疑是手机浏览器不支持这个 api 便去搜索了一下。

Clipboard

MDN 上的解释：

剪贴板 Clipboard API 为 Navigator 接口添加了只读属性 clipboard，该属性返回一个可以读写剪切板内容的 Clipboard 对象。在 Web 应用中，剪切板 API 可用于实现剪切、复制、粘贴的功能。

只有在用户事先授予网站或应用对剪切板的访问许可之后，才能使用异步剪切板读写方法。许可操作必须通过取得权限 Permissions API (en-US) 的 "clipboard-read" 和/或 "clipboard-write" 项获得。

浏览器兼容性

使用 document.execCommand() 降级处理

这里我也不清楚用户手机浏览器的版本是多少，那么这个 api 出现之前，是用的什么方法呢？总是可以 polyfill 降级处理的吧！于是我就查到了document.execCommand()这个方法：

• 
  
• document.execCommand("copy") : 复制；
  
• document.execCommand("cut") : 剪切；
  
• document.execCommand("paste") : 粘贴。
  

对比

Clipboard 的所有方法都是异步的，返回 Promise 对象，复制较大数据时不会造成页面卡顿。但是其支持的浏览器版本较新，且只允许 https 和 localhost 这些安全网络环境可以使用，限制较多。

document.execCommand() 限制较少，使用起来相对麻烦。但是 MDN 上提到该 api 已经废弃：

浏览器很可能在某个版本弃用该 api ，不过当前 2023/12/29 ，该复制 api 还是可以正常使用的。

具体代码修改

于是我修改了一下原来的 hook：

import Toast from "~@/components/Toast";

export const useCopy = () => { 

const copy = async (text: string, toast?: string) => {

const fallbackCopyTextToClipboard = (text: string, toast?: string) => {
let textArea = document.createElement("textarea");

      textArea.value = text;

// Avoid scrolling to bottom

      textArea.style.top = "-200";

      textArea.style.left = "0";

      textArea.style.position = "fixed";

      textArea.style.opacity = "0"

document.body.appendChild(textArea);
// textArea.focus();

      textArea.select();
let msg;
try {
let successful = document.execCommand("copy");

        msg = successful ? toast ? toast : "复制成功" : "复制失败";

      } catch (err) {

        msg = "复制失败";

      }
Toast.dispatch({
content: msg,

      });
document.body.removeChild(textArea);

    }; 

const copyTextToClipboard = (text: string, toast?: string) => {
if (!navigator.clipboard || !window.isSecureContext) {
fallbackCopyTextToClipboard(text, toast);
return;

      }

      navigator.clipboard

        .writeText(text)

        .then(() => {
Toast.dispatch({
content: toast ? toast : "复制成功",

          });

        })

        .catch(() => {
fallbackCopyTextToClipboard(text, toast)

        });

    };
copyTextToClipboard(text, toast);

  };

return copy;

};

上线近一年，这个复制方法没出现异常问题。