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

瀏覽器相容性