chrome.clipboard

설명

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

권한

clipboard

지원 대상

개발자 채널 ChromeOS만 해당

유형

AdditionalDataItem

속성

  • 데이터

    string

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

  • 유형

    DataItemType

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

DataItemType

열거형

"textPlain"

ImageType

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

열거형

"png"

"jpeg"

방법

setImageData()

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

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

매개변수

  • imageData

    ArrayBuffer

    Chrome 60 이상

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

  • 유형

    ImageType

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

  • additionalItems

    AdditionalDataItem[] 선택사항

    Chrome 60 이상

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    Chrome 91 이상

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

이벤트

onClipboardDataChanged

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

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

매개변수

  • 콜백

    기능

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

    ()=>void