Navigator

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

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

プロパティ

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

標準プロパティ

Navigator.connection 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
デバイスのネットワーク状態の情報を提供する NetworkInformation オブジェクトを返します。
Navigator.cookieEnabled 読取専用
cookie へのセットが無視される場合 false、それ以外は true を返します。
Navigator.credentials 読取専用
ログインやログアウトの成功といったイベントが発生したときに資格情報を要求してユーザーエージェントへ通知する手段を提供する、CredentialsContainer (en-US) インターフェイスを返します。
Navigator.deviceMemory 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
端末のメモリーをギガバイト単位で返します。この値は 2 の階乗の最も近い値を 1024 で割った概算値です。
Navigator.doNotTrack 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。
Navigator.geolocation 読取専用
デバイスの物理的な場所を取得することができる Geolocation オブジェクトを返します。
NavigatorConcurrentHardware.hardwareConcurrency 読取専用
使用可能な論理プロセッサーコアの数を返します。
NavigatorPlugins.javaEnabled 読取専用
このブラウザーで Java が利用できるかどうかを Boolean で返します。
Navigator.keyboard 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
Keyboard (en-US) オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。
NavigatorLanguage.language 読取専用
ユーザーにとって一番望ましい言語 (たいていはブラウザー UI の言語) の DOMString を返します。不明な場合には null を返します。
NavigatorLanguage.languages 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
ユーザーが知っている言語を表す DOMString を、望ましい順に並べた配列を返します。
Navigator.locks 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
新しい Lock (en-US) オブジェクトを要求したり、既存の Lock (en-US) オブジェクトをクエリしたりするための LockManager (en-US) オブジェクトを返します。
Navigator.maxTouchPoints 読取専用
現在の端末で対応している同時タッチ点の最大数を返します。
Navigator.mediaCapabilities 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる MediaCapabilities (en-US) オブジェクトを返します。
Navigator.mediaDevices 読取専用
使用可能なメディアデバイスの情報を取得する (MediaDevices.enumerateDevices())、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限できるかを確認する (MediaDevices.getSupportedConstraints())、MediaDevices.getUserMedia() を使用してメディアへのアクセスを要求するといったことができる、MediaDevices オブジェクトへの参照を返します。
Navigator.mediaSession (en-US) 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
Returns MediaSession object which can be used to provide metadata that can be used by the browser to present information about the currently-playing media to the user, such as in a global media controls UI.
NavigatorPlugins.mimeTypes 読取専用
ブラウザーが対応している MIME タイプのリストを MimeTypeArray (en-US) で返します。
Navigator.onLine (en-US) 読取専用
現在のブラウザーがオンラインかどうかを示す Boolean を返します。
Navigator.permissions 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
Permissions API が対応する API の許可状態の問い合わせや更新に使用できる、Permissions オブジェクトを返します。
NavigatorPlugins.plugins 読取専用
現在のブラウザーにインストールされているプラグインをリストした PluginArray を返します。
Navigator.presentation 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
Presentation (en-US) API への参照を返します。
Navigator.serviceWorker 読取専用
ServiceWorkerContainer オブジェクトを返します。これは、associated documentServiceWorker オブジェクトの登録、削除、更新、通信の機能を提供します。
NavigatorStorage.storage 読取専用
サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトン StorageManager オブジェクトを返します。
NavigatorID.userAgent 読取専用
現在のブラウザーのユーザーエージェントを表す文字列を返します。
Navigator.vendor 読取専用
現在のブラウザーのベンダーネームを返します (例 "Netscape6")。
Navigator.webdriver 読取専用   これは実験段階の API です。製品内のコードで使用しないようご注意ください。
ユーザーエージェントが自動で制御されているかどうかを示します。
Navigator.xr 読取専用 これは実験段階の API です。製品内のコードで使用しないようご注意ください。
Returns XR (en-US) object, which represents the entry point into the WebXR API.

標準外プロパティ

Navigator.buildID この API は標準化されていません。
ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では 20181001000000 となります。
Navigator.securitypolicy この API は標準化されていません。
空文字列を返します。Netscape 4.7x では "US & CA domestic policy" または "Export policy" を返していました。
Navigator.standalone この API は標準化されていません。
ブラウザーをスタンドアロンモードで実行しているかを示す boolean を返します。Apple の iOS Safari だけで使用できます。
Navigator.wakeLock (en-US) 読取専用 この API は標準化されていません。
Returns a WakeLock (en-US) interface you can use to request screen wake locks and prevent screen from dimming, turning off, or showing a screen saver.

非推奨のプロパティ

NavigatorID.appCodeName 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
現在のブラウザーの内部のコードネームを返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorID.appName 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
このブラウザーの公式な名前の DOMString を返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorID.appVersion 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
ブラウザーのバージョンを DOMString で返します。このプロパティが正確な値を返すことを期待しないで下さい。
Navigator.activeVRDisplays 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
現在表示中 (VRDisplay.ispresentingtrue) である、すべての VRDisplay オブジェクトを収めた配列を返します。
Navigator.battery 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
バッテリー残量などの情報を取得できる BatteryManager (en-US) オブジェクトを返します。
Navigator.oscpu 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
現在の OS を表す文字列を返します。
NavigatorID.platform 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorID.product 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
どのブラウザーも、常に 'Gecko' を返します。このプロパティは、互換性のために限って維持されています。
Navigator.productSub 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
ブラウザーのビルド番号を返します (例, "20060909")。
Navigator.storageQuota 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
記憶域の使用量やクォータ情報の問い合わせや要求の手段を提供する、StorageQuota (en-US) インターフェイスを返します。
Navigator.vendorSub 読取専用 これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
vendor version number を返します (例 "6.1").

メソッド

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

Navigator.canShare() (en-US)
Returns true if a call to Navigator.share() would succeed.
Navigator.registerProtocolHandler()
自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。
Navigator.requestMediaKeySystemAccess() (en-US)
MediaKeySystemAccess オブジェクト用の Promise を返します。
Navigator.sendBeacon()
ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。
Navigator.share()
現在のプラットフォームのネイティブ共有メカニズムを実行します。
Navigator.vibrate()
バイブレーションがサポートされている場合、デバイスにバイブレーションを起こします。サポートされていない場合、何もしません。

非推奨のメソッド

Navigator.getVRDisplays() これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
コンピューターに接続されて使用可能な VR デバイスを表す VRDisplay の配列に解決される promise を返します。
Navigator.getUserMedia() これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの audio または video ストリームを返します。
Navigator.registerContentHandler() これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
ウェブサイトが自分自身を、ある MIME タイプのハンドラーとして登録できるようにします。
NavigatorID.taintEnabled() (en-US) これは非推奨の API です。まだ動作しているかもしれませんが、もう使用するべきではありません。
false を返します。JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。

仕様書

仕様書 状態 備考
HTML Living Standard
the Navigator object の定義
現行の標準

ブラウザーの互換性

BCD tables only load in the browser