Clipboard.setText

函数式 API setClipboardText也可以这样使用同样的功能。

功能说明

将文本复制到剪贴板。用户可以在其他应用中粘贴。

如果没有剪贴板写入权限 SetClipboardTextPermissionError会发生。 Clipboard.setText.getPermission()来确认权限状态，并且 Clipboard.setText.openPermissionDialog()可以重新请求权限。

类型

Clipboard.setText(text: string): Promise<void>;

Params

这是要复制到剪贴板的文本。

Response

无。

错误

错误会以类的形式抛出 — error instanceof SetClipboardTextPermissionError来识别。该类可在 @apps-in-toss/web-framework中导入。

错误类	说明
SetClipboardTextPermissionError	这是在剪贴板写入权限被拒绝时的情况。 Clipboard.setText.openPermissionDialog()可以重新请求。

示例代码

JavaScript

import {
  Clipboard,
  SetClipboardTextPermissionError,
} from "@apps-in-toss/web-framework";

try {
  await Clipboard.setText("要复制的文本");
} catch (error) {
  if (error instanceof SetClipboardTextPermissionError) {
    console.warn("没有剪贴板写入权限。");
    return;
  }
  console.error(error);
}