Navigator

ここへジャンプ:

プロパティ
メソッド
ブラウザ実装状況

Navigator インターフェイスは、ユーザーエージェントの状態や身元情報を表します。スクリプトからその情報を問い合わる、および活動を続けるためにそれら自体を登録することができます。

Navigator オブジェクトは、読み取り専用の window.navigator プロパティを使用して取得できます。

プロパティ

継承するプロパティはありませんが、NavigatorID、NavigatorLanguage、NavigatorOnLine、NavigatorContentUtils、NavigatorStorage、NavigatorStorageUtils、NavigatorConcurrentHardware、NavigatorPlugins、NavigatorUserMedia で定義されているプロパティを実装します。

標準プロパティ

Navigator.activeVRDisplays 読取専用: 現在表示中 (VRDisplay.ispresenting が true) である、すべての VRDisplay オブジェクトを収めた配列を返します。
NavigatorID.appCodeName 読取専用: 現在のブラウザーの内部のコードネームを返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorID.appName 読取専用: このブラウザーの公式な名前の DOMString を返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorID.appVersion 読取専用: ブラウザーのバージョンを DOMString で返します。このプロパティが正確な値を返すことを期待しないで下さい。
Navigator.battery 読取専用: バッテリー残量などの情報を取得できる BatteryManager オブジェクトを返します。
Navigator.connection 読取専用: デバイスのネットワーク状態の情報を提供する NetworkInformation オブジェクトを返します。
Navigator.cookieEnabled 読取専用: cookie へのセットが無視される場合 false、それ以外は true を返します。
Navigator.geolocation 読取専用: デバイスの物理的な場所を取得することができる Geolocation オブジェクトを返します。
NavigatorConcurrentHardware.hardwareConcurrency 読取専用: 使用可能な論理プロセッサーコアの数を返します。
NavigatorPlugins.javaEnabled 読取専用: このブラウザーで Java がサポートされているかどうかを Boolean で返します。
NavigatorLanguage.language 読取専用: ユーザーにとって一番望ましい言語 (たいていはブラウザーUI の言語) の DOMString を返します。不明な場合には null を返します。
NavigatorLanguage.languages 読取専用: ユーザーが知っている言語を表す DOMString を、望ましい順に並べた配列を返します。
NavigatorPlugins.mimeTypes 読取専用: ブラウザーがサポートしている MIME types のリストを MimeTypeArray で返します。
NavigatorOnLine.onLine 読取専用: 現在のブラウザーがオンラインかどうかを示す Boolean を返します。
Navigator.oscpu: 現在の OS を表す文字列を返します。
Navigator.permissions 読取専用: Permissions API が対応する API の許可状態の問い合わせや更新に使用できる、Permissions オブジェクトを返します。
NavigatorID.platform 読取専用: 現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorPlugins.plugins 読取専用: 現在のブラウザーにインストールされている配列の PluginArray を返します。
NavigatorID.product 読取専用: どのブラウザーも、常に 'Gecko' を返します。このプロパティは、互換性のために限って維持されています。
Navigator.serviceWorker 読取専用: ServiceWorkerContainer オブジェクトを返します。これは、associated document の ServiceWorker オブジェクトの登録、削除、更新、通信の機能を提供します。
Navigator.storage 読取専用: サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトン StorageManager オブジェクトを返します。
NavigatorID.userAgent 読取専用: 現在のブラウザーのユーザーエージェントを表す文字列を返します。

非標準プロパティ

Firefox OS デバイスには、さらに多くの非標準プロパティがあります。Firefox OS Navigator 拡張の記事で、それらを確認できます。

Navigator.buildID: ブラウザーのビルド識別子を返します (例, "2006090803")。
Navigator.cookieEnabled: ブラウザーで Cookie が有効か否かを示す boolean を返します。
Navigator.credentials: ログインやログアウトの成功といったイベントが発生したときに資格情報を要求してユーザーエージェントへ通知する手段を提供する、CredentialsContainer インターフェイスを返します。
Navigator.deviceMemory 読取専用: 端末のメモリーをギガバイト単位で返します。この値は 2 の階乗の最も近い値を 1024 で割った概算値です。
Navigator.doNotTrack: ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。
Navigator.mediaDevices: 使用可能なメディアデバイスの情報を取得する (MediaDevices.enumerateDevices())、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限できるかを確認する (MediaDevices.getSupportedConstraints())、MediaDevices.getUserMedia() を使用してメディアへのアクセスを要求するといったことができる、MediaDevices オブジェクトへの参照を返します。
Navigator.mozNotification 非推奨 Gecko 22 Navigator.webkitNotification: ウェブアプリからユーザーへ通知を送るために使用できる、notification オブジェクトを返します。
Navigator.mozSocial: navigator.mozSocial プロパティが返すオブジェクトは、ソーシャルメディアプロバイダーのパネル内で、それらが必要とする機能を提供するために使用できます。
Navigator.presentation: Presentation API への参照を返します。
Navigator.productSub: ブラウザーのビルド番号を返します (例, "20060909")。
Navigator.securitypolicy: 空文字列を返します。Netscape 4.7x では "US & CA domestic policy" または "Export policy" を返していました。
Navigator.standalone: ブラウザーをスタンドアロンモードで実行しているかを示す boolean を返します。Apple の iOS Safari だけで使用できます。
Navigator.storageQuota 読取専用: 記憶域の使用量やクォータ情報の問い合わせや要求の手段を提供する、StorageQuota インターフェイスを返します。
Navigator.vendor: 現在のブラウザのベンダーネームを返します (例 "Netscape6")。
Navigator.vendorSub: vendor version number を返します (例 "6.1").
Navigator.webkitPointer: Mouse Lock API の PointerLock オブジェクトを返します。

メソッド

継承するメソッドはありませんが、NavigatorID、NavigatorContentUtils、NavigatorUserMedia、NavigatorStorageUtils で定義されているメソッドを継承します。

標準メソッド

Navigator.getVRDisplays(): コンピューターに接続されて使用可能な VR デバイスを表す VRDisplay の配列に解決される promise を返します。
Navigator.getUserMedia(): ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの audio または video ストリームを返します。
Navigator.registerContentHandler() Gecko 59 で廃止: ウェブサイトが自分自身を、ある MIME タイプのハンドラーとして登録できるようにします。
Navigator.registerContentHandler(): ウェブサイトが、指定した MIME type 向けに使用できるハンドラーとして自身を登録することができます。
Navigator.registerProtocolHandler(): 自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。
Navigator.requestMediaKeySystemAccess(): MediaKeySystemAccess オブジェクト用の Promise を返します。
Navigator.sendBeacon(): ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。
Navigator.share(): 現在のプラットフォームのネイティブ共有メカニズムを実行します。
NavigatorID.taintEnabled() 非推奨 Gecko 1.7.8 Gecko 9.0 で廃止: false を返します。JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。
Navigator.vibrate(): バイブレーションがサポートされている場合、デバイスにバイブレーションを起こします。サポートされていない場合、何もしません。

非標準メソッド

Firefox OS デバイスには、さらに多くの非標準メソッドがあります。Firefox OS Navigator 拡張の記事で、それらを確認できます。

Navigator.mozIsLocallyAvailable(): 指定した URL のドキュメントが、ネットワーク接続がない状態で使用できるかを確認できます。
Navigator.mozPay(): アプリ内で支払いできます。

機能	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari
基本対応	あり	あり	あり	あり	あり	あり
`authentication`	67¹	なし	なし	なし	?	なし
`clipboard`	?	?	?	?	?	?
`mediaSession`	なし	?	?	?	なし	?
`serviceWorker`	40	17	44³	なし	27	11.1

機能	Android webview	Chrome for Android	Edge mobile	Firefox for Android	Opera Android	iOS Safari	Samsung Internet
基本対応	あり	あり	あり	あり	あり	あり	あり
`authentication`	67²	67¹	なし	なし	?	なし	なし
`clipboard`	?	?	?	?	?	?	?
`mediaSession`	なし	57	?	?	なし	?	?
`serviceWorker`	40	40	17	44	27	11.1	?

1. From version 67: this feature is behind the WebAuth preference. To change preferences in Chrome, visit chrome://flags.

2. From version 67: this feature is behind the WebAuth preference.

3. Service Workers have been disabled in the Firefox 45 and 52 Extended Support Releases

	デスクトップ						モバイル
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Android 版 Chrome	Edge Mobile	Android 版 Firefox	Android 版 Opera	iOS 版 Safari	Samsung Internet
基本対応	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり	完全対応あり
`authentication`	完全対応 67 無効完全対応 67 無効無効 From version 67: this feature is behind the `WebAuth` preference. To change preferences in Chrome, visit chrome://flags.	未対応なし	未対応なし	未対応なし	?	未対応なし	完全対応 67 無効完全対応 67 無効無効 From version 67: this feature is behind the `WebAuth` preference.	完全対応 67 無効完全対応 67 無効無効 From version 67: this feature is behind the `WebAuth` preference. To change preferences in Chrome, visit chrome://flags.	未対応なし	未対応なし	?	未対応なし	未対応なし
`clipboard`	?	?	?	?	?	?	?	?	?	?	?	?	?
`mediaSession` 実験的非標準	未対応なし	?	?	?	未対応なし	?	未対応なし	完全対応 57	?	?	未対応なし	?	?
`serviceWorker`	完全対応 40	完全対応 17	完全対応 44 補足完全対応 44 補足補足 Service Workers have been disabled in the Firefox 45 and 52 Extended Support Releases	未対応なし	完全対応 27	完全対応 11.1	完全対応 40	完全対応 40	完全対応 17	完全対応 44	完全対応 27	完全対応 11.1	?

凡例

完全対応: 完全対応
未対応: 未対応
実装状況不明: 実装状況不明
実験的。動作が変更される可能性があります。: 実験的。動作が変更される可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。: 非標準。ブラウザー間の互換性が低い可能性があります。
実装ノートを参照してください。: 実装ノートを参照してください。
ユーザーが明示的にこの機能を有効にしなければなりません。: ユーザーが明示的にこの機能を有効にしなければなりません。

ドキュメントのタグと貢献者

タグ:

このページの貢献者: Uemmra3, yyss, lv7777, fscholz

最終更新者: Uemmra3, 2018/04/05 4:59:38