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 ChromeOS-Plattform-Apps, bis eine Open-Web-Alternative verfügbar ist. Sie wird eingestellt, sobald die Open-Web-Lösung verfügbar ist, etwa im 4. Quartal 2017.

Berechtigungen

clipboard

Verfügbarkeit

<ph type="x-smartling-placeholder"></ph> Entwicklerversion Nur ChromeOS

Typen

AdditionalDataItem

Attribute

  • Daten

    String

    Inhalt des zusätzlichen Datenelements. Entweder der Nur-Text-String, wenn type „textPlain“ ist oder 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()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 57 und höher 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

Setzt Bilddaten in die Zwischenablage.

Parameter

  • imageData

    ArrayBuffer

    Chrome 60 und höher

    Die codierten Bilddaten.

  • Typ

    ImageType

    Der Bildtyp, der übergeben wird.

  • additionalItems

    AdditionalDataItem[] optional

    Chrome 60 und höher

    Zusätzliche Datenelemente zum Beschreiben von Bilddaten. Der Callback wird aufgerufen, wobei chrome.runtime.lastError auf Fehlercode gesetzt ist, wenn ein Fehler vorliegt. Erfordert die Berechtigungen „Zwischenablage“ und „Zwischenablage“.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 91 und höher

    Promise-Objekte 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 Daten in der Zwischenablage ändern. Erfordert die Berechtigungen „Zwischenablage“ und „ZwischenablageRead“, um dem Ereignis „chrome.clipboard.onClipboardDataChanged“ einen Listener hinzuzufügen. Nachdem dieses Ereignis ausgelöst wurde, sind die Daten in der Zwischenablage durch Aufrufen von document.execCommand('paste') verfügbar.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void