Navigator: mimeTypes-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Gibt ein MimeTypeArray-Objekt zurück, das eine Liste von MimeType-Objekten enthält, welche die vom Browser erkannten und unterstützten MIME-Typen repräsentieren. Das Array kann abgefragt werden, um Informationen über das aktivierte Plugin zu erhalten, das verwendet wird, um eine Datei des angegebenen Typs zu handhaben. Benannte Eigenschaften des zurückgegebenen Objekts sind nicht aufzählbar (außer in sehr alten Browserversionen).

In neueren Versionen der Spezifikation ist die zurückgegebene Menge von MIME-Typen fest kodiert. Wenn PDF-Dateien inline angezeigt werden können, dann werden application/pdf und text/pdf aufgelistet. Andernfalls wird eine leere Liste zurückgegeben.

Hinweis: Verwenden Sie Navigator.pdfViewerEnabled, um festzustellen, ob die Inline-Anzeige von PDF-Dateien unterstützt wird. Leiten Sie dies nicht von dieser Eigenschaft ab.

Ältere Browserversionen kodieren die von der Eigenschaft zurückgegebene Liste nicht fest und könnten andere MIME-Typen zurückgeben.

Wert

Ein MimeTypeArray-Objekt, das eine length-Eigenschaft sowie die Methoden item(index) und namedItem(name) hat.

Wenn die Inline-Anzeige von PDF unterstützt wird, enthält dies Einträge für die MIME-Typen application/pdf und text/pdf. Andernfalls wird ein leeres MimeTypeArray zurückgegeben. Die Beschreibung und Dateisuffixe, die von aktivierten Plugins unterstützt werden, sind fest auf 'pdf' und 'Portable Document Format' kodiert.

Beispiele

Der unten stehende Code testet, ob PDF-Dateien inline angezeigt werden können, und gibt dann die Beschreibung des Plugins und die von ihm unterstützten Dateisuffixe aus.

js
if ("application/pdf" in navigator.mimeTypes) {
  // browser supports inline viewing of PDF files.

  const { description, suffixes } = navigator.mimeTypes["application/pdf"];
  console.log(`Description: ${description}, Suffix: ${suffixes}`);
  // expected output: Description: Portable Document Format, Suffix: pdf
}

Beachten Sie, dass der obige Code zwar auf application/pdf testet, Sie ebenso text/pdf prüfen könnten. (Entweder beide oder keiner der MIME-Typen wird wahr sein.) Zudem müssen Sie in aktuellen Browsern die Plugin-Beschreibung und Suffixe nicht tatsächlich abrufen, da diese Informationen ebenfalls fest kodiert sind.

Spezifikationen

Specification
HTML Standard
# dom-navigator-mimetypes

Browser-Kompatibilität

BCD tables only load in the browser