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 встроенный PDF"

Если просмотр PDF-файлов в строке не поддерживается, возвращается пустой объект.

Примеры

Этот код показывает, как проверить, можно ли отображать PDF-файлы в строке:

if ("PDF Viewer" in navigator.plugins) {
  // browser supports inline viewing of PDF files.
}

Спецификации

Спецификация
HTML # dom-navigator-plugins

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`plugins`	1	12	1	≤12.1	1	18	4	≤12.1	1	1.0	4.4
`returns_plugins`	1–94	12–94	1–99	≤12.1–80	1	18–94	4–99	≤12.1–66	1	1.0	4.4–94

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigator/plugins