Navigator: plugins プロパティ

非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

アプリケーションにインストールされているプラグインを記述した Plugin オブジェクトが含まれている PluginArray オブジェクトを返します。 返されたオブジェクトの名前付きプロパティは列挙できません(非常に古いバージョンのブラウザーを除く)。

最近のバージョンの仕様では、返されるリストがハードコードされています。 PDF ファイルのインライン表示に対応している場合、プロパティには 5 つの標準プラグインが掲載されています。 インライン PDF 表示に対応していない場合は、空のリストが返されます。

メモ: PDF ファイルのインライン表示に対応しているかどうかを判断するには、Navigator.pdfViewerEnabled を使用してください。このプロパティから推測しないでください。

「5 つの標準プラグイン」とは、開発者がインライン PDF 表示の機能検出に使用できる最も一般的なプラグインです。 これらのプロパティを返すことで、古いコードでもインライン表示が対応しているかどうかをより確実に判断することができます。 ただし、このプロパティは将来的に削除される可能性があるため、新しいコードではこの手法は推奨されません。

古いバージョンのブラウザーには、Adobe Flash のプラグインや PDF ビューアーの拡張機能も含まれます。

plugins は、名前付きまたはアイテムのリストとして Plugin オブジェクトにアクセスするために使用する PluginArray オブジェクトです。

返値は 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 Standard
# dom-navigator-plugins

ブラウザーの互換性

BCD tables only load in the browser