Navigator:plugins 属性

已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它,但也许已从相关的 web 标准中移除,也许正准备移除或出于兼容性而保留。请尽量不要使用该特性,并更新现有的代码;参见本页面底部的兼容性表格以指导你作出决定。请注意,该特性随时可能无法正常工作。

返回一个 PluginArray 对象,列出描述应用程序中已安装插件的 Plugin 对象。返回对象的命名属性不可枚举(除非在非常旧的浏览器版本中)。

最新版本的规范对返回的列表进行了硬编码。如果支持内联查看 PDF 文件,则该属性列出五个标准插件。如果不支持内联查看 PDF,则返回空列表。

备注: 使用 Navigator.pdfViewerEnabled 来确定是否支持内联查看 PDF 文件。不要从该属性中推断。“五个标准插件”是开发人员最常用于特征检测内联 PDF 查看的插件。返回这些插件可确保旧代码更可靠地确定是否支持内联查看。但是,这种方法不建议用于新代码,因为此属性可能最终会被删除。

旧版本的浏览器还列出了 Adobe Flash 和 PDF 查看器扩展的插件。

plugins 是一个 PluginArray 对象,用于通过名称或项列表访问 Plugin 对象。

返回的值不是一个 JavaScript 数组,但其包含 length 属性,并支持使用方括号语法(plugins[2])以及 item(index)namedItem("name") 方法访问单个项。

如果支持内联查看 PDF 文件,则该列表将包含以下插件的条目:

  • “PDF Viewer”
  • “Chrome PDF Viewer”
  • “Chromium PDF Viewer”
  • “Microsoft Edge PDF Viewer”
  • “WebKit built-in PDF”

如果 PDF 内联查看不受支持,则返回一个空对象。

示例

该代码演示了如何检查是否可以内联显示 PDF 文件:

js
if ("PDF Viewer" in navigator.plugins) {
  // 浏览器支持内联显示 PDF 文件。
}

规范

Specification
HTML
# dom-navigator-plugins

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
plugins
Deprecated
Returns plugins rather than hard-coded PDF plugin values
DeprecatedNon-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.