Navigator

Navigator インターフェイスは、ユーザーエージェントの状態や身元情報を表します。これにより、スクリプトがこれらの問い合わせを行ったり、アクティビティを実行するために自分自身を登録したりすることができます。

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

インスタンスプロパティ

継承しているプロパティはありません。

標準プロパティ

システムクリップボードへの読み書きアクセスを提供する Clipboard オブジェクトです。

端末のネットワーク状態の情報を提供する NetworkInformation オブジェクトを返します。

Cookie への設定を無視する場合は false、それ以外は true を返します。

ログインやログアウトの成功といったイベントが発生したときに、資格情報を要求してユーザーエージェントへ通知する手段を提供する CredentialsContainer (en-US) インターフェイスを返します。

端末のメモリーをギガバイト単位で返します。この値は 2 の累乗に最も近い値を 1024 で割った概算値です。

端末の物理的な場所を取得することができる Geolocation オブジェクトを返します。

現在の閲覧コンテキストの GPU オブジェクトを返します。 WebGPU API のエントリーポイントです。

HID オブジェクトを返します。これは HID 機器の接続、接続されている HID 機器の列挙、接続されている HID 機器のイベントハンドラーなどのメソッドを提供します。

使用可能な論理プロセッサーコアの数を返します。

現在の文書の Ink (en-US) オブジェクトを返し、 インク API (en-US) の機能へのアクセスを提供します。

Keyboard オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。

ユーザーにとって一番望ましい言語(たいていはブラウザー UI の言語)の文字列を返します。不明な場合には null を返します。

ユーザーが知っている言語を表す文字列を、望ましい順に並べた配列を返します。

LockManager オブジェクトを返します。これは、新しい Lock オブジェクトを要求したり、既存の Lock オブジェクトをクエリしたりするためのものです。

現在の端末で対応している同時タッチ点の最大数を返します。

指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる MediaCapabilities (en-US) オブジェクトを返します。

MediaDevices オブジェクトへの参照を返します。これにより、使用可能なメディア端末の情報を取得する (MediaDevices.enumerateDevices())、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限することができるかを確認する (MediaDevices.getSupportedConstraints())、MediaDevices.getUserMedia() を使用してメディアへのアクセスを要求するといったことができます。

MediaSession オブジェクトを返します。このオブジェクトは、グローバルメディア制御の UI などで、現在再生中のメディアに関する情報をブラウザーがユーザーに提示する際に使用できるメタデータを提供するために使用することができます。

現在のブラウザーがオンラインかどうかを示す論理値を返します。

ブラウザーが PDF に移動したときにインラインで表示できるのであれば true を、そうでなければ false を返します。

Permissions オブジェクトを返します。これは、権限 API が対応する API の許可状態の問い合わせや更新に使用できます。

Presentation (en-US) API への参照を返します。

Serial オブジェクトを返します。これは、シリアルポートを制御できるようにする Web Serial API のエントリーポイントを表します。

ServiceWorkerContainer オブジェクトを返します。これは、関連付けれた文書ServiceWorker オブジェクトの登録、削除、更新、通信の機能を提供します。

現在の文書の Scheduling (en-US) オブジェクトを返します。

サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトンの StorageManager オブジェクトを返します。

現在のウィンドウのユーザー起動状態に関する情報を格納した UserActivation オブジェクトを返します。

現在のブラウザーのユーザーエージェントを表す文字列を返します。

ユーザーのブラウザーとオペレーティングシステムに関する情報にアクセスするための NavigatorUAData オブジェクトを返します。

画面上の仮想キーボードを制御するための VirtualKeyboard (en-US) API への参照を返します。

ユーザーエージェントが自動で制御されているかどうかを示します。

デスクトッププログレッシブウェブアプリケーションにおけるタイトルバーのジオメトリーに関する情報と、それが変更されるたびに知るためのイベントを公開する WindowControlsOverlay (en-US) インターフェイスを返します。

XRSystem オブジェクトを返します。これは WebXR API (en-US) のエントリーポイントを表します。

標準外のプロパティ

ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では 20181001000000 となります。

ContactsManager インターフェイスを返します。ユーザーが連絡先リストから項目を選択し、選択した項目の限られた詳細情報をウェブサイトやアプリケーションと共有することができます。

ユーザーの情報が共有または販売されることへの同意を示す論理値を返します。

空文字列を返します。 Netscape 4.7x では "US & CA domestic policy" または "Export policy" を返していました。

ブラウザーをスタンドアロンモードで実行しているかを示す論理値を返します。 Apple の iOS Safari だけで使用できます。

WakeLock インターフェイスを返します。これは、画面のウェイクロックを要求したり、画面の減光、消灯、スクリーンセーバーの表示を防止したりするために利用できます。

非推奨のプロパティ

どのブラウザーでも 'Mozilla' を返します。

どのブラウザーでも 'Netscape' を返します。

ブラウザーのバージョンを文字列で返します。このプロパティが正確な値を返すことを期待しないで下さい。

現在表示中である(VRDisplay.ispresentingtrue である)、すべての VRDisplay オブジェクトを収めた配列を返します。

ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。

ブラウザーが対応している MIME タイプの一覧を MimeTypeArray (en-US) で返します。

現在の OS を表す文字列を返します。

現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。

PluginArray を返します。これはブラウザーにインストールされているプラグインを列挙します。

どのブラウザーも、常に 'Gecko' を返します。

'20030107' または '"20100101' の文字列のどちらかを返します。

空文字列、'Apple Computer Inc.''Google Inc.' のいずれかを返します。

常に空文字列を返します。

インスタンスメソッド

継承するメソッドはありません。

Navigator.share() の呼び出しが成功した場合は true を返します。

現在のアプリのバッジを消去し、 undefined に解決する Promise を返します。

指定したメディア要素、音声コンテキスト、またはメディア機能の "type" が自動再生を許可されているかどうかを示す値を返します。

BatteryManager (en-US) オブジェクトで解決するプロミスを返します。このオブジェクトはバッテリーの充電状態についての情報を返します。

ユーザーがインストールしている、関連するネイティブまたはプログレッシブウェブアプリを表すオブジェクトの配列で解決するプロミスを返します。

自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。

指定されたプロトコルのハンドラーであるウェブサイトの登録を解除します。

MediaKeySystemAccess オブジェクト用の Promise を返します。

ユーザーのシステムにおいて MIDI 機器にアクセスするリクエストを表す Promise を返します。

ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。

このアプリに関連付けられたアイコンにバッジを設定し、 undefined で解決する Promise を返します。

現在のプラットフォームのネイティブ共有メカニズムを実行します。

バイブレーションに対応している場合、端末にバイブレーションを起こします。対応していない場合は、何もしません。

非推奨のメソッド

コンピューターに接続されて使用可能な VR 機器を表す VRDisplay の配列に解決されるプロミスを返します。

ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの音声または動画ストリームを返します。

false を返します。 JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。

常に false を返します。

仕様書

Specification
HTML Standard
# the-navigator-object

ブラウザーの互換性

BCD tables only load in the browser