Navigator: plugins 属性

返回一个 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) {
  // browser supports inline viewing of PDF files.
}

规范

规范
HTML
# dom-navigator-plugins

浏览器兼容性