chrome.clipboard

설명

chrome.clipboard API는 사용자가 클립보드의 데이터에 액세스할 수 있도록 제공됩니다. 이는 오픈 웹 대안을 사용할 수 있을 때까지 chromeos 플랫폼 앱을 위한 임시 솔루션입니다. 오픈 웹 솔루션이 출시되면(2017년 4분기에 제공 예정) 지원이 중단될 예정입니다.

권한

clipboard

가용성

<ph type="x-smartling-placeholder"></ph> 개발자 채널 에서 확인하세요. ChromeOS만 해당

유형

AdditionalDataItem

속성

  • 데이터

    문자열

    추가 데이터 항목의 콘텐츠입니다. type가 'textPlain'인 경우 일반 텍스트 문자열입니다. type이 'textHTML'인 경우 마크업 문자열 데이터는 2MB를 초과할 수 없습니다.

  • 유형

    DataItemType

    추가 데이터 항목의 유형입니다.

DataItemType

열거형

"textPlain"

'textHTML'

ImageType

지원되는 이미지 유형입니다.

열거형

"png"

"jpeg"

메서드

setImageData()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 57 이상 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

이미지 데이터를 클립보드에 설정합니다.

매개변수

  • imageData

    배열 버퍼

    Chrome 60 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    인코딩된 이미지 데이터입니다.

  • 유형

    ImageType

    전달되는 이미지의 유형입니다.

  • additionalItems

    AdditionalDataItem[] 선택사항

    Chrome 60 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    이미지 데이터를 설명하기 위한 추가 데이터 항목입니다. 콜백은 오류가 있는 경우 오류 코드로 설정된 chrome.runtime.lastError를 사용하여 호출됩니다. 클립보드 및 클립보드 쓰기 권한이 필요합니다.

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 프로미스<void>

    Chrome 91 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

이벤트

onClipboardDataChanged

Chrome 56 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

클립보드 데이터가 변경되면 실행됩니다. chrome.clipboard.onClipboardDataChanged 이벤트에 리스너를 추가하려면 클립보드 및 클립보드 읽기 권한이 필요합니다. 이 이벤트가 실행된 후 document.execCommand('paste')를 호출하여 클립보드 데이터를 사용할 수 있습니다.

매개변수

  • 콜백

    함수

    callback 매개변수는 다음과 같습니다. 

    () => void