Navigator: plugins-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die schreibgeschützte Eigenschaft plugins der Navigator-Schnittstelle gibt ein PluginArray-Objekt zurück. Dieses enthält Plugin-Objekte, die die in der Anwendung installierten Plugins beschreiben.
Die benannten Eigenschaften des zurückgegebenen Objekts sind nicht aufzählbar (außer in sehr alten Browserversionen).
Neuere Versionen der Spezifikation legen die zurückgegebene Liste fest. Wenn die Inline-Anzeige von PDF-Dateien unterstützt wird, enthält die Eigenschaft fünf Standard-Plugins. Wird die Inline-Anzeige von PDF-Dateien 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. Leiten Sie dies nicht aus dieser Eigenschaft ab.
Die „fünf Standard-Plugins“ sind diejenigen, die Entwickler am häufigsten zur Funktionserkennung der Inline-Anzeige von PDF-Dateien verwendet haben. Ihre Rückgabe stellt sicher, dass bestehender Code zuverlässiger feststellen kann, ob die Inline-Anzeige unterstützt wird. Für neuen Code wird dieser Ansatz jedoch nicht empfohlen, da diese Eigenschaft möglicherweise irgendwann entfernt wird.
Ältere Browserversionen führen auch Plugins für Adobe Flash und PDF-Viewer-Erweiterungen auf.
Wert
plugins ist ein PluginArray-Objekt, über das auf Plugin-Objekte entweder anhand ihres Namens oder als Listeneinträge zugegriffen werden kann.
Der zurückgegebene Wert ist kein JavaScript-Array, verfügt aber über die Eigenschaft length. Auf einzelne Einträge kann mit der Klammernotation (plugins[2]) sowie mit den Methoden item(index) und namedItem("name") zugegriffen werden.
Wenn die Inline-Anzeige von PDF-Dateien unterstützt wird, enthält das Objekt Einträge für die folgenden Plugins:
- "PDF Viewer"
- "Chrome PDF Viewer"
- "Chromium PDF Viewer"
- "Microsoft Edge PDF Viewer"
- "WebKit built-in PDF"
Wird die Inline-Anzeige von PDF-Dateien nicht unterstützt, wird ein leeres Objekt zurückgegeben.
Beispiele
Dieser Code zeigt, wie Sie prüfen können, ob PDF-Dateien inline angezeigt werden können:
if ("PDF Viewer" in navigator.plugins) {
// browser supports inline viewing of PDF files.
}
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-navigator-plugins |