ClipboardItem: types-Eigenschaft
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 schreibgeschützte types-Eigenschaft der ClipboardItem-Schnittstelle gibt ein Array von MIME-Typen zurück, die innerhalb des ClipboardItem verfügbar sind.
Wert
Ein Array der verfügbaren MIME-Typen.
Beispiele
Im untenstehenden Beispiel geben wir alle Elemente in der Zwischenablage über die Clipboard.read()-Methode zurück, überprüfen dann die types-Eigenschaft auf verfügbare Typen, bevor wir die ClipboardItem.getType()-Methode verwenden, um jedes Datenelement als Blob zurückzugeben. Wenn für den angegebenen Typ keine Inhalte in der Zwischenablage gefunden werden, wird ein Fehler zurückgegeben.
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-types |