클립보드 (clipboard)

🚀 추가된 버전 : v1.4.0 v1.4.0 v1.4.0
🔔 최신화 일자: 2026-03-18

개요

clipboard 네임스페이스는 디바이스의 네이티브 클립보드에 텍스트를 복사하거나, 현재 저장된 텍스트를 가져오는 기능을 제공합니다.

이 기능을 사용하여 사용자 인터페이스와 클립보드 간에 데이터를 효율적으로 공유할 수 있습니다.

주의

일부 디바이스 또는 특정 OS 버전에서는 클립보드 접근이 제한될 수 있습니다.

클립보드 기능은 SDK ver.1.6.3부터 Android, iOS 앱과 Web 플랫폼 모두 사용 가능합니다.

---

메서드 목록

메서드	설명	추가된 버전	수정된 버전
getText(callback)	네이티브 클립보드에 저장된 텍스트를 반환합니다.	v1.4.0	v1.6.3
setText(text, callback?)	텍스트를 네이티브 클립보드에 저장합니다.	v1.4.0	v1.6.3

---

메서드 상세

getText(callback)

• since : v1.4.0
• lastupdated : v1.6.3 - Web 플랫폼 지원 추가

타입 정의

function getText(callback: (text: string) => void): void;

설명

디바이스의 네이티브 클립보드에 저장된 텍스트를 가져옵니다.
해당 메서드는 콜백 함수로 복사한 텍스트 값을 전달합니다.

getText 메서드는 SDK ver.1.6.3부터 Android, iOS 앱과 Web 플랫폼 모두 사용 가능합니다.

참고

MDN - Clipboard: readText( ) method

지원 플랫폼

getText 메서드는 App과 Web 모든 환경을 지원합니다.

플랫폼	지원 여부	비고
	✅	네이티브 Clipboard 사용
	✅	네이티브 Clipboard 사용
	✅	Web Clipboard API 사용

매개변수

이름	타입	필수 여부	설명
callback	(text: string) => void	✅	클립보드에 저장된 텍스트 반환 함수

반환 값

해당 메서드는 반환 값을 가지지 않으며, 텍스트는 callback을 통해 비동기적으로 제공됩니다.

사용 예제

// 네이티브 클립보드에서 텍스트를 가져옵니다.
Nachocode.clipboard.getText(text => {
  console.log('클립보드 내용:', text);
  alert(`클립보드에서 가져온 텍스트: ${text}`);
});

---

setText(text, callback?)

• since : v1.4.0
• lastupdated : v1.6.3 - Web 플랫폼 지원 추가

타입 정의

function setText(
  text: string,
  callback?: (status: 'success' | 'error', message: string) => void
): void;

설명

입력된 텍스트를 네이티브 클립보드에 저장합니다.
선택적으로 콜백 함수를 통해 복사 성공 여부와 메시지를 전달받을 수 있습니다.

setText 메서드는 SDK ver.1.6.3부터 Android, iOS 앱과 Web 플랫폼 모두 사용 가능합니다.

참고

MDN - Clipboard: writeText( ) method

지원 플랫폼

setText 메서드는 App과 Web 모든 환경을 지원합니다.

플랫폼	지원 여부	비고
	✅	네이티브 Clipboard 사용
	✅	네이티브 Clipboard 사용
	✅	Web Clipboard API 사용

매개변수

이름	타입	필수 여부	설명
text	string	✅	클립보드에 저장할 텍스트
callback	(status: 'success' | 'error', message: string) => void	❌	복사 결과 및 메시지를 반환하는 함수

• status: 복사 성공 여부 (success 또는 error)
• message: 복사 성공 또는 오류 메시지

반환 값

해당 메서드는 반환 값을 가지지 않으며, 결과는 callback을 통해 비동기적으로 제공됩니다.

사용 예제

// 네이티브 클립보드에 텍스트를 저장합니다.
Nachocode.clipboard.setText('Hello nachocode!', (status, message) => {
  if (status === 'success') {
    console.log('클립보드에 텍스트가 성공적으로 복사되었습니다.');
  } else {
    console.error('클립보드에 복사 실패: ', message);
  }
});

---