chrome.clipboard

Beschreibung

Die chrome.clipboard API wird bereitgestellt, damit Nutzer auf Daten in der Zwischenablage zugreifen können. Dies ist eine temporäre Lösung für Apps auf der ChromeOS-Plattform, bis eine Alternative für ein offenes Web verfügbar ist. Sobald eine offene Weblösung verfügbar ist, wird sie möglicherweise im 4. Quartal 2017 eingestellt.

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"

ImageType

Unterstützte Bildtypen.

Enum

"png"

"jpeg"

Methoden

setImageData()

Versprechen Chrome 57 oder höher 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

Setzt Bilddaten in die Zwischenablage.

Parameters

  • imageData

    ArrayBuffer

    Chrome 60 oder höher

    Die codierten Bilddaten.

  • Typ

    ImageType

    Der Typ des zu übergebenden Bildes.

  • additionalItems

    AdditionalDataItem[] optional

    Chrome 60 oder höher

    Zusätzliche Datenelemente zur Beschreibung von Bilddaten. Beim Aufruf wird der Callback mit chrome.runtime.lastError auf den Fehlercode festgelegt, falls ein Fehler vorliegt. Erfordert die Berechtigungen „Zwischenablage“ und „Zwischenablageschreib“.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

Veranstaltungen

onClipboardDataChanged

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

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

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    ()=>void