ClipboardItem: types-Eigenschaft

Baseline 2024

Newly available

Since June 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte types-Eigenschaft des ClipboardItem-Interfaces gibt ein Array der im ClipboardItem verfügbaren MIME-Typen zurück.

Wert

Ein Array der verfügbaren MIME-Typen.

Beispiele

Im unten stehenden Beispiel geben wir alle Einträge in der Zwischenablage über die Clipboard.read()-Methode zurück. Dann prüfen wir die types-Eigenschaft auf verfügbare Typen, bevor wir die ClipboardItem.getType()-Methode nutzen, um das Blob-Objekt zurückzugeben. Wenn keine Zwischenspeicherinhalte für den angegebenen Typ gefunden werden, wird ein Fehler zurückgegeben.

js
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

Specification
Clipboard API and events
# dom-clipboarditem-types

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch