Clipboard.getText

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

功能说明

获取保存在剪贴板中的文本。如果剪贴板中没有文本，则返回空字符串。

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

类型

Clipboard.getText(): Promise<string>;

Params

无

Response

返回保存在剪贴板中的文本。如果没有文本，则为空字符串。

错误

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

错误类	说明
GetClipboardTextPermissionError	这是剪贴板读取权限被拒绝的情况。 Clipboard.getText.openPermissionDialog()可以重新请求。

示例代码

JavaScript

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

try {
  const text = await Clipboard.getText();
  console.log(text);
} catch (error) {
  if (error instanceof GetClipboardTextPermissionError) {
    console.warn("没有剪贴板读取权限。");
    return;
  }
  console.error(error);
}