Navigator

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

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

インスタンスプロパティ

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

標準プロパティ

現在の文書の Bluetooth オブジェクトを返し、 Web Bluetooth API の機能へのアクセスを提供します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ブラウザーの NavigatorLogin オブジェクトへのアクセスを提供します。これは、連合 ID プロバイダー (IdP) が、ユーザーが IdP にログインまたはログインする際に、ユーザーのログインステータスを設定するために使用することができます。詳細は、連合資格情報管理 (FedCM) API を参照してください。

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

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

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

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

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

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

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

Presentation API への参照を返します。

現在の文書の Scheduling オブジェクトを返します。

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

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

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

現在の文書内の USB オブジェクトを返します。WebUSB API の機能へのアクセスを提供します。

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

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

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

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

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

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

WindowControlsOverlay インターフェイスを返します。これは、デスクトップのプログレッシブウェブアプリにおける、タイトルバーの形状に関する情報と、それが変更されるたびに知るためのイベントを公開します。

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

標準外のプロパティ

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

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

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

非推奨のプロパティ

VRDisplay オブジェクトのうち、現在表示している(VRDisplay.ispresentingtrue である)ものすべてを格納する配列を返します。

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

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

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

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

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

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

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

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

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

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

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

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

インスタンスメソッド

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

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

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

指定された文字列は、指定された不透明な URN または FencedFrameConfig 内部の url プロパティに対応する URL で置換されます。このメソッドは、一時的な措置として利用できるようになりました(そのため「非推奨」となっています)。フェンスで囲まれたフレームの URL で置換できるようにすることで、広告技術プロバイダーが既存の実装をプライバシーサンドボックス API に移行するのに役立つためです。

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

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

Gamepad オブジェクトの配列を返します。それぞれがこの端末に接続されているゲームパッドを表します。

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

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

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

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

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

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

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

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

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

非推奨のメソッド

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

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

常に false を返します。

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

仕様書

Specification
HTML Standard
# the-navigator-object

ブラウザーの互換性

BCD tables only load in the browser