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) {
// browser supports inline viewing of PDF files.
}
规范
规范 |
---|
HTML 标准 # dom-navigator-plugins |
浏览器兼容性
BCD 表格仅在浏览器中加载