Navigator: plugins-Eigenschaft

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Gibt ein PluginArray-Objekt zurück, das die Plugin-Objekte auflistet, die die in der Anwendung installierten Plugins beschreiben. Benannte Eigenschaften des zurückgegebenen Objekts sind nicht aufzählbar (außer in sehr alten Browserversionen).

Neuere Versionen der Spezifikation kodieren die zurückgegebene Liste fest. Wenn die Inline-Anzeige von PDF-Dateien unterstützt wird, listet die Eigenschaft fünf Standard-Plugins auf. Wird die Inline-PDF-Anzeige nicht unterstützt, wird eine leere Liste zurückgegeben.

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

Die "fünf Standard-Plugins" sind diejenigen, die Entwickler am häufigsten verwendet haben, um die Inline-PDF-Anzeige zu erkennen. Die Rückgabe dieser stellt sicher, dass Legacy-Code zuverlässiger feststellen kann, ob die Inline-Anzeige unterstützt wird. Dieser Ansatz wird jedoch für neuen Code nicht empfohlen, da diese Eigenschaft möglicherweise irgendwann entfernt wird.

Ältere Browserversionen listen auch Plugins für Adobe Flash und PDF-Viewer-Erweiterungen auf.

Wert

plugins ist ein PluginArray-Objekt, das verwendet wird, um auf Plugin-Objekte entweder nach Name oder als Liste von Elementen zuzugreifen.

Der zurückgegebene Wert ist kein JavaScript-Array, hat aber die Eigenschaft length und unterstützt den Zugriff auf einzelne Elemente mit der Klammer-Notation (plugins[2]) sowie über die Methoden item(index) und namedItem("name").

Wenn die Inline-Anzeige von PDFs unterstützt wird, enthält dies Einträge für die folgenden Plugins:

  • "PDF Viewer"
  • "Chrome PDF Viewer"
  • "Chromium PDF Viewer"
  • "Microsoft Edge PDF Viewer"
  • "WebKit built-in PDF"

Wenn die Inline-Anzeige von PDFs nicht unterstützt wird, wird ein leeres Objekt zurückgegeben.

Beispiele

Dieser Code zeigt, wie überprüft wird, ob PDF-Dateien inline angezeigt werden können:

js
if ("PDF Viewer" in navigator.plugins) {
  // browser supports inline viewing of PDF files.
}

Spezifikationen

Specification
HTML Standard
# dom-navigator-plugins

Browser-Kompatibilität

BCD tables only load in the browser