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에서 import할 수 있어요.

에러 클래스	설명
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);
}