clipboard.setImageData()
Kopiert ein Bild in die Zwischenablage. Das Bild wird neu kodiert, bevor es in die Zwischenablage geschrieben wird. Wenn das Bild ungültig ist, wird die Zwischenablage nicht verändert.
Das Bild wird als ArrayBuffer
bereitgestellt, der das kodierte Bild enthält. JPEG- und PNG-Formate werden unterstützt.
Obwohl diese API auf der clipboard.setImageData()
API von Chrome basiert, gibt es einige Unterschiede:
- Die Chrome-API ist nur für Apps, nicht für Erweiterungen.
- Diese API erfordert nur die Berechtigung
"clipboardWrite"
, während die Chrome-Version auch die Berechtigung"clipboard"
erfordert. - Die Chrome-API verwendet Callbacks, und diese API unterstützt nur Promises.
- Diese API unterstützt den Parameter
additionalItems
nicht.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
browser.clipboard.setImageData(imageData, imageType)
Parameter
imageData
-
Ein
ArrayBuffer
, der die zu kopierenden Bilddaten in die Zwischenablage enthält. imageType
-
Ein String, der den Typ des im
imageData
enthaltenen Bildes angibt:"png"
oder"jpeg"
.
Rückgabewert
Ein Promise
, das ohne Argumente erfüllt wird, wenn das Vorhaben erfolgreich war, oder abgelehnt wird, wenn ein Fehler aufgetreten ist (zum Beispiel, weil die Daten kein gültiges Bild darstellten).
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Ein entferntes Bild kopieren:
// requires:
// * the host permission for "https://cdn.mdn.mozilla.net/*"
// * the API permission "clipboardWrite"
fetch("https://cdn.mdn.mozilla.net/static/img/favicon144.png")
.then((response) => response.arrayBuffer())
.then((buffer) => browser.clipboard.setImageData(buffer, "png"));
Ein Bild kopieren, das mit der Erweiterung gebündelt wurde:
// requires the API permission "clipboardWrite"
fetch(browser.runtime.getURL("image.png"))
.then((response) => response.arrayBuffer())
.then((buffer) => browser.clipboard.setImageData(buffer, "png"));
Hinweis: Diese API basiert auf der chrome.clipboard
API von Chromium.