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

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