chrome.clipboard

설명

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

권한

clipboard

가용성

개발자 채널 ChromeOS만 해당

유형

AdditionalDataItem

속성

  • 데이터

    문자열

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

  • 유형

    DataItemType

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

DataItemType

열거형

'textPlain'

"textHtml"

ImageType

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

열거형

"png"

"jpeg"

메서드

setImageData()

Promise Chrome 57 이상 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

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

매개변수

  • imageData

    ArrayBuffer

    Chrome 60 이상

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

  • 유형

    ImageType

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

  • additionalItems

    AdditionalDataItem[] optional

    Chrome 60 이상

    이미지 데이터를 설명하는 추가 데이터 항목입니다. 오류가 있으면 오류 코드로 설정된 chrome.runtime.lastError와 함께 콜백이 호출됩니다. clipboard 및 clipboardWrite 권한이 필요합니다.

  • callback

    함수 선택사항

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

    () => void

반환 값

  • Promise<void>

    Chrome 91 이상

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

이벤트

onClipboardDataChanged

Chrome 56 이상 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

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

매개변수

  • callback

    함수

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

    () => void