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

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 entspricht keinem bekannten MIME-Typ.

TypeError

Kein Parameter ist angegeben oder der type entspricht nicht dem eines ClipboardItem.

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.

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