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 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.

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