ClipboardItem: getType()-Methode

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 getType()-Methode der ClipboardItem-Schnittstelle gibt ein Promise zurück, das mit einem Blob des angeforderten MIME-Typs aufgelöst wird, oder einen Fehler, falls der MIME-Typ nicht gefunden wird.

Syntax

js
getType(type)

Parameter

type

Ein gültiger MIME-Typ.

Rückgabewert

Ein Promise, das mit einem Blob-Objekt aufgelöst wird.

Ausnahmen

NotFoundError DOMException

Der type stimmt nicht mit einem bekannten MIME-Typ überein.

TypeError

Es wird kein Parameter angegeben oder der type entspricht nicht dem eines ClipboardItem.

Beispiele

Im folgenden Beispiel geben wir alle Elemente der Zwischenablage über die clipboard.read()-Methode zurück. Anschließend wird die ClipboardItem.types-Eigenschaft genutzt, um das getType()-Argument festzulegen und das entsprechende Blob-Objekt zurückzugeben.

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch