copyTextToClipboard

浏览器端将纯文本写入系统剪贴板（优先 Clipboard API，失败回退 execCommand('copy')）。

环境要求

• 须在浏览器环境调用（内部读取 globalThis.document / navigator.clipboard）。
• 非 HTTPS 或部分 WebView 可能无法使用 Clipboard API，将自动回退 textarea + execCommand。

函数签名

function copyTextToClipboard(text: string): Promise<boolean>

参数

参数名	类型	必填	说明
text	string	是	待复制文本；空字符串直接返回 false

返回值

类型	说明
Promise<boolean>	复制成功 true，失败 false

工作原理

1. 空文本或缺少 document.body 时返回 false。
2. 优先 navigator.clipboard.writeText(text)。
3. 失败则创建隐藏 textarea，选中全文后 document.execCommand('copy')，再移除节点。
4. 全程不抛异常，以 boolean 表示结果。

异常

无异常抛出。