Copies an image to the clipboard. The image is re-encoded before it is written to the clipboard. If the image is invalid, the clipboard is not modified.
The image is provided as an
ArrayBuffer
containing the encoded image. JPEG and PNG formats are supported.
Although this API is based on Chrome's
clipboard.setImageData()
API, there are some differences:
"clipboardWrite"
permission, while the Chrome version also requires the
"clipboard"
permission.
additionalItems
参数。
This is an asynchronous function that returns a
Promise
.
browser.clipboard.setImageData(imageData, imageType)
imageData
An
ArrayBuffer
containing the encoded image data to copy to the clipboard.
imageType
A
DOMString
indicating the type of image contained in
imageData
:
"png"
or
"jpeg"
.
A
Promise
that will be resolved with no arguments if the operation succeeded, or rejected if there was an error (for example, because the data did not represent a valid image).
BCD tables only load in the browser
Copy a remote image:
// 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'));
Copy an image that was bundled with the extension:
// requires the API permission "clipboardWrite"
fetch(browser.runtime.getURL('image.png'))
.then(response => response.arrayBuffer())
.then(buffer => browser.clipboard.setImageData(buffer, 'png'));
注意：
This API is based on Chromium's
chrome.clipboard
API。
最后修改： , 由 MDN 贡献者