chrome.clipboard

Beschreibung

Die chrome.clipboard API wird bereitgestellt, damit Nutzer auf Daten in der Zwischenablage zugreifen können. Dies ist eine vorübergehende Lösung für ChromeOS-Plattform-Apps, bis eine Open-Web-Alternative verfügbar ist. Sie wird eingestellt, sobald die Open-Web-Lösung verfügbar ist, was im 4. Quartal 2017 der Fall sein könnte.

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 Bildformate

Enum

"png"

"jpeg"

Methoden

setImageData()

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

Legt Bilddaten in der Zwischenablage ab.

Parameter

  • imageData

    ArrayBuffer

    Chrome 60 oder höher

    Die codierten Bilddaten.

  • Typ

    ImageType

    Der Typ des übergebenen Bildes.

  • additionalItems

    AdditionalDataItem[] optional

    Chrome 60 oder höher

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder 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 oder höher 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Wird ausgelöst, wenn sich die Daten in der Zwischenablage ändern. Erfordert die Berechtigungen „clipboard“ und „clipboardRead“, um einen Listener zum Ereignis „chrome.clipboard.onClipboardDataChanged“ hinzuzufügen. Nachdem dieses Ereignis ausgelöst wurde, sind die Daten in der Zwischenablage über den Aufruf von „document.execCommand('paste')“ verfügbar.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void