clipboard.writeText()

把 guest 已有的有界文本交给系统剪贴板。

Syntax

await host.clipboard.writeText(text, options?);

Parameters

• text: string：UTF-8 编码后不超过 clipboard.maxTextBytes 的纯文本。
• options?: CallOptions：可选取消信号。

Return value

无。成功只表示系统剪贴板已接受文本。

Examples

copyButton.onclick = () => host.clipboard.writeText(editor.selectedText());

Errors

特有错误：denied、activation-required、cancelled、invalid-data、limit-exceeded。取消先于系统剪贴板提交点时不得写入；提交先发生则成功，后到的取消不回滚。

Requirements

• 能力：host:clipboard.writeText
• 每次可信用户激活：必须
• 可取消：是；取消与系统剪贴板提交点线性排序
• 信任档位：green；长度、速率、纯文本形状和逐次审计是实现符合 v0.1 的强制条件

See also

clipboard.readText()、clipboard