Navigator
Navigator
インターフェイスは、ユーザーエージェントの状態や身元情報を表します。これにより、スクリプトがこれらの問い合わせを行ったり、アクティビティを実行するために自分自身を登録したりすることができます。
Navigator
オブジェクトは、読み取り専用の window.navigator
プロパティを使用して取得できます。
プロパティ
継承しているプロパティはありません。
標準プロパティ
- 端末のネットワーク状態の情報を提供する
NetworkInformation
オブジェクトを返します。 - Cookie への設定を無視する場合は false、それ以外は true を返します。
- ログインやログアウトの成功といったイベントが発生したときに、資格情報を要求してユーザーエージェントへ通知する手段を提供する
CredentialsContainer
(en-US) インターフェイスを返します。 - 端末のメモリーをギガバイト単位で返します。この値は 2 の累乗に最も近い値を 1024 で割った概算値です。
- ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。
- 端末の物理的な場所を取得することができる
Geolocation
オブジェクトを返します。 HID
(en-US) オブジェクトを返します。これは HID 機器の接続、接続されている HID 機器の列挙、接続されている HID 機器のイベントハンドラーなどのメソッドを提供します。- 使用可能な論理プロセッサーコアの数を返します。
Keyboard
(en-US) オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。- ユーザーにとって一番望ましい言語 (たいていはブラウザー UI の言語) の
DOMString
を返します。不明な場合にはnull
を返します。 - ユーザーが知っている言語を表す
DOMString
を、望ましい順に並べた配列を返します。 LockManager
(en-US) オブジェクトを返します。これは、新しいLock
(en-US) オブジェクトを要求したり、既存のLock
(en-US) オブジェクトをクエリしたりするためのものです。- 現在の端末で対応している同時タッチ点の最大数を返します。
- 指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる
MediaCapabilities
(en-US) オブジェクトを返します。 MediaDevices
オブジェクトへの参照を返します。これにより、使用可能なメディア端末の情報を取得する (MediaDevices.enumerateDevices()
)、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限することができるかを確認する (MediaDevices.getSupportedConstraints()
)、MediaDevices.getUserMedia()
を使用してメディアへのアクセスを要求するといったことができます。MediaSession
オブジェクトを返します。このオブジェクトは、グローバルメディア制御の UI などで、現在再生中のメディアに関する情報をブラウザーがユーザーに提示する際に使用できるメタデータを提供するために使用することができます。- 現在のブラウザーがオンラインかどうかを示す
Boolean
を返します。 Permissions
オブジェクトを返します。これは、 Permissions API が対応する API の許可状態の問い合わせや更新に使用できます。Presentation
(en-US) API への参照を返します。Serial
(en-US) オブジェクトを返します。これは、シリアルポートを制御できるようにするWeb Serial API
(en-US) のエントリーポイントを表します。ServiceWorkerContainer
オブジェクトを返します。これは、associated document のServiceWorker
オブジェクトの登録、削除、更新、通信の機能を提供します。- サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトンの
StorageManager
オブジェクトを返します。 - 現在のブラウザーのユーザーエージェントを表す文字列を返します。
- 現在のブラウザーのベンダー名を返します (例 "Netscape6")。
- ユーザーエージェントが自動で制御されているかどうかを示します。
XRSystem
オブジェクトを返します。これは WebXR API (en-US) のエントリーポイントを表します。
標準外のプロパティ
- ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では
20181001000000
となります。 ContactsManager
(en-US) インターフェイスを返します。ユーザーが連絡先リストから項目を選択し、選択した項目の限られた詳細情報をウェブサイトやアプリケーションと共有することができます。- 空文字列を返します。Netscape 4.7x では "US & CA domestic policy" または "Export policy" を返していました。
- ブラウザーをスタンドアロンモードで実行しているかを示す boolean を返します。Apple の iOS Safari だけで使用できます。
WakeLock
インターフェイスを返します。これは、画面のウェイクロックを要求したり、画面の減光、消灯、スクリーンセーバーの表示を防止したりするために利用できます。
非推奨のプロパティ
- 現在のブラウザーの内部のコードネームを返します。このプロパティが正確な値を返すことを期待しないで下さい。
- このブラウザーの公式な名前の
DOMString
を返します。このプロパティが正確な値を返すことを期待しないで下さい。 - ブラウザーのバージョンを
DOMString
で返します。このプロパティが正確な値を返すことを期待しないで下さい。 - 現在表示中である (
VRDisplay.ispresenting
がtrue
である)、すべてのVRDisplay
オブジェクトを収めた配列を返します。 - バッテリー残量などの情報を取得できる
BatteryManager
(en-US) オブジェクトを返します。 - 現在の OS を表す文字列を返します。
- 現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。
PluginArray
を返します。これはブラウザーにインストールされたプラグインを列挙します。- どのブラウザーも、常に
'Gecko'
を返します。このプロパティは、互換性だけの目的で維持されています。 - ブラウザーのビルド番号を返します (例, "20060909")。
- vendor version number を返します (例 "6.1").
メソッド
継承するメソッドはありません。
Navigator.share()
の呼び出しが成功した場合はtrue
を返します。- 現在のアプリのバッジを消去し、
undefined
に解決するPromise
を返します。 BatteryManager
(en-US) オブジェクトで解決するプロミスを返します。このオブジェクトはバッテリーの充電状態についての情報を返します。- false を返します。
- 自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。
- MediaKeySystemAccess オブジェクト用の
Promise
を返します。 - ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。
- このアプリに関連付けられたアイコンにバッジを設定し、
undefined
で解決するPromise
を返します。 - 現在のプラットフォームのネイティブ共有メカニズムを実行します。
- バイブレーションに対応している場合、端末にバイブレーションを起こします。対応していない場合は、何もしません。
非推奨のメソッド
- コンピューターに接続されて使用可能な VR 機器を表す
VRDisplay
の配列に解決されるプロミスを返します。 - ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの音声または動画ストリームを返します。
false
を返します。 JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。
仕様書
Specification |
---|
HTML Standard # the-navigator-object |
ブラウザーの互換性
BCD tables only load in the browser