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
Typen
AdditionalDataItem
Attribute
-
Daten
String
Inhalt des zusätzlichen Datenelements. Entweder der Nur-Text-String, wenn
type
"textPlain" ist, oder der Markup-String, wenntype
"textHTML" ist. Die Daten dürfen nicht größer als 2 MB sein. -
Typ
Typ des zusätzlichen Datenelements.
DataItemType
Enum
"textPlain"
ImageType
Unterstützte Bildtypen.
Enum
"png"
"jpeg"
Methoden
setImageData()
chrome.clipboard.setImageData(
imageData: ArrayBuffer,
type: ImageType,
additionalItems?: AdditionalDataItem[],
callback?: function,
)
Setzt Bilddaten in die Zwischenablage.
Parameters
-
imageData
ArrayBuffer
Chrome 60 oder höherDie codierten Bilddaten.
-
Typ
Der Typ des zu übergebenden Bildes.
-
additionalItems
AdditionalDataItem[] optional
Chrome 60 oder höherZusä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öherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
Veranstaltungen
onClipboardDataChanged
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