ClipboardItem: getType() Methode
Baseline
2024
Neu verfügbar
Seit June 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die getType() Methode des ClipboardItem Interfaces gibt ein Promise zurück, das mit einem Blob des angeforderten MIME-Typs oder einem Fehler aufgelöst wird, wenn der MIME-Typ nicht gefunden wird.
Syntax
getType(type)
Parameter
Rückgabewert
Ausnahmen
NotFoundErrorDOMException-
Der
typeentspricht keinem bekannten MIME-Typ. TypeError-
Kein Parameter ist angegeben oder der
typeentspricht nicht dem einesClipboardItem.
Beispiele
Im folgenden Beispiel geben wir alle Elemente in der Zwischenablage über die clipboard.read() Methode zurück. Für jedes Element übergeben wir die ClipboardItem.types Eigenschaft an die getType() Methode, die das entsprechende Blob Objekt zurückgibt.
async function getClipboardContents() {
try {
const clipboardItems = await navigator.clipboard.read();
for (const clipboardItem of clipboardItems) {
for (const type of clipboardItem.types) {
const blob = await clipboardItem.getType(type);
// we can now use blob here
}
}
} catch (err) {
console.error(err.name, err.message);
}
}
Spezifikationen
| Spezifikation |
|---|
| Clipboard API and events # dom-clipboarditem-gettype |