chrome.clipboard

Beschreibung

Die chrome.clipboard API ermöglicht Nutzern den Zugriff auf Daten der Zwischenablage. Dies ist eine vorübergehende Lösung für ChromeOS-Plattform-Apps, bis eine Open-Web-Alternative verfügbar ist. Es wird eingestellt, sobald eine Open-Web-Lösung verfügbar ist. Das könnte im 4. Quartal 2017 der Fall sein.

Berechtigungen

clipboard

Verfügbarkeit

Entwicklerversion Nur ChromeOS

Typen

AdditionalDataItem

Attribute

  • Daten

    String

    Inhalt des zusätzlichen Datenelements. Entweder der Nur-Text-String, wenn type „textPlain“ ist, oder der Markup-String, wenn type „textHtml“ ist. Die Daten dürfen nicht größer als 2 MB sein.

  • Typ des zusätzlichen Datenelements.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Unterstützte Bildtypen

Enum

"png"

"jpeg"

Methoden

setImageData()

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

Legt Bilddaten in der Zwischenablage fest.

Parameter

  • imageData

    ArrayBuffer

    Chrome 60 und höher

    Die codierten Bilddaten.

  • Typ

    ImageType

    Der Typ des übergebenen Bildes.

  • additionalItems

    AdditionalDataItem[] optional

    Chrome 60 und höher

    Zusätzliche Datenelemente zur Beschreibung von Bilddaten. Der Callback wird mit chrome.runtime.lastError auf den Fehlercode gesetzt aufgerufen, wenn ein Fehler auftritt. Erfordert die Berechtigungen „clipboard“ und „clipboardWrite“.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onClipboardDataChanged

Chrome 56 und höher 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Wird ausgelöst, wenn sich die Zwischenablagedaten ändern. Erfordert die Berechtigungen „clipboard“ und „clipboardRead“ zum Hinzufügen eines Listeners für das Ereignis „chrome.clipboard.onClipboardDataChanged“. Nachdem dieses Ereignis ausgelöst wurde, sind die Zwischenablagedaten durch Aufrufen von document.execCommand('paste') verfügbar.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void