Navigator

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

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

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

インスタンスプロパティ

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

標準プロパティ

Navigator.bluetooth 読取専用 Experimental 安全なコンテキスト用: 現在の文書の Bluetooth オブジェクトを返し、 Web Bluetooth API の機能へのアクセスを提供します。
Navigator.clipboard 読取専用安全なコンテキスト用: Clipboard オブジェクトを返し、システムクリップボードへの読み書きアクセスを提供します。
Navigator.connection 読取専用: 端末のネットワーク状態の情報を含む NetworkInformation オブジェクトを返します。
Navigator.contacts 読取専用 Experimental 安全なコンテキスト用: ContactsManager インターフェイスを返します。これにより、ユーザーが連絡先リストから項目を選択したり、選択した項目の制限付きの詳細をウェブサイトやアプリケーションと共有したりすることができます。
Navigator.cookieEnabled 読取専用: Cookie への設定を無視する場合は false、それ以外は true を返します。
Navigator.credentials 読取専用安全なコンテキスト用: CredentialsContainer インターフェイスを返し、ログインやログアウトの成功といったイベントが発生したときに、資格情報を要求してユーザーエージェントへ通知する手段を提供します。
Navigator.deviceMemory 読取専用 Experimental: 端末のメモリーをギガバイト単位で返します。この値は 2 の累乗に最も近い値を 1024 で割った概算値です。
Navigator.geolocation 読取専用: 端末の物理的な場所を取得することができる Geolocation オブジェクトを返します。
Navigator.gpu 読取専用 Experimental 安全なコンテキスト用: 現在の閲覧コンテキストの GPU オブジェクトを返します。 WebGPU API のエントリーポイントです。
Navigator.hardwareConcurrency 読取専用: 使用可能な論理プロセッサーのコア数を返します。
Navigator.hid 読取専用 Experimental 安全なコンテキスト用: HID オブジェクトを返します。これは HID 機器の接続、接続されている HID 機器の列挙、接続されている HID 機器のイベントハンドラーなどのメソッドを提供します。
Navigator.ink 読取専用 Experimental: 現在の文書の Ink オブジェクトを返し、インク API の機能へのアクセスを提供します。
Navigator.keyboard 読取専用 Experimental 安全なコンテキスト用: Keyboard オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。
Navigator.language 読取専用: ユーザーにとって一番望ましい言語（たいていはブラウザー UI の言語）の文字列を返します。不明な場合には null を返します。
Navigator.languages 読取専用: ユーザーが知っている言語を表す文字列を、望ましい順に並べた配列を返します。
Navigator.locks 読取専用安全なコンテキスト用: LockManager オブジェクトを返します。これは、新しい Lock オブジェクトを要求したり、既存の Lock オブジェクトをクエリーしたりするためのものです。
Navigator.login 読取専用 Experimental 安全なコンテキスト用: ブラウザーの NavigatorLogin オブジェクトへのアクセスを提供します。これは、連合 ID プロバイダー (IdP) が、ユーザーが IdP にログインまたはログインする際に、ユーザーのログインステータスを設定するために使用することができます。詳細は、連合資格情報管理 (FedCM) API を参照してください。
Navigator.maxTouchPoints 読取専用: 現在の端末で対応している同時タッチ点の最大数を返します。
Navigator.mediaCapabilities 読取専用: 指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる MediaCapabilities オブジェクトを返します。
Navigator.mediaDevices 読取専用安全なコンテキスト用: MediaDevices オブジェクトへの参照を返します。これにより、使用可能なメディア端末の情報を取得する (MediaDevices.enumerateDevices())、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限することができるかを確認する (MediaDevices.getSupportedConstraints())、MediaDevices.getUserMedia() を使用してメディアへのアクセスを要求するといったことができます。
Navigator.mediaSession 読取専用: MediaSession オブジェクトを返します。このオブジェクトは、グローバルメディア制御の UI などで、現在再生中のメディアに関する情報をブラウザーがユーザーに提示する際に使用できるメタデータを提供するために使用することができます。
Navigator.onLine 読取専用: 現在のブラウザーがオンラインかどうかを示す論理値を返します。
Navigator.pdfViewerEnabled 読取専用: ブラウザーが PDF に移動したときにインラインで表示できるのであれば true を、そうでなければ false を返します。
Navigator.permissions 読取専用: Permissions オブジェクトを返します。これは、権限 API が対応する API の許可状態の問い合わせや更新に使用できます。
Navigator.presentation 読取専用安全なコンテキスト用: Presentation API への参照を返します。
Navigator.scheduling 読取専用 Experimental: 現在の文書の Scheduling オブジェクトを返します。
Navigator.serial 読取専用 Experimental 安全なコンテキスト用: Serial オブジェクトを返します。これは、シリアルポートを制御できるようにするウェブシリアル API のエントリーポイントを表します。
Navigator.serviceWorker 読取専用安全なコンテキスト用: ServiceWorkerContainer オブジェクトを返します。これは、関連付けれた文書の ServiceWorker オブジェクトの登録、削除、更新、通信の機能を提供します。
Navigator.storage 読取専用安全なコンテキスト用: サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトンの StorageManager オブジェクトを返します。
Navigator.usb 読取専用安全なコンテキスト用: 現在の文書内の USB オブジェクトを返します。WebUSB API の機能へのアクセスを提供します。
Navigator.userActivation 読取専用: 現在のウィンドウのユーザー起動状態に関する情報を格納した UserActivation オブジェクトを返します。
Navigator.userAgent 読取専用: 現在のブラウザーのユーザーエージェントを表す文字列を返します。
Navigator.userAgentData 読取専用 Experimental 安全なコンテキスト用: ユーザーのブラウザーとオペレーティングシステムに関する情報にアクセスするための NavigatorUAData オブジェクトを返します。
Navigator.virtualKeyboard 読取専用 Experimental 安全なコンテキスト用: 画面上の仮想キーボードを制御するための VirtualKeyboard API への参照を返します。
Navigator.wakeLock 読取専用安全なコンテキスト用: WakeLock インターフェイスを返します。これは、画面のウェイクロックを要求したり、画面の減光、消灯、スクリーンセーバーの表示を防止したりするために利用できます。
Navigator.webdriver 読取専用: ユーザーエージェントが自動で制御されているかどうかを示します。
Navigator.windowControlsOverlay 読取専用安全なコンテキスト用: WindowControlsOverlay インターフェイスを返します。これは、デスクトップのプログレッシブウェブアプリにおける、タイトルバーの形状に関する情報と、それが変更されるたびに知るためのイベントを公開します。
Navigator.xr 読取専用 Experimental 安全なコンテキスト用: XRSystem オブジェクトを返します。これは WebXR API のエントリーポイントを表します。

標準外のプロパティ

Navigator.buildID 読取専用非標準: ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では 20181001000000 となります。
Navigator.globalPrivacyControl 読取専用 Experimental 非標準: ユーザーの情報が共有または販売されることへの同意を示す論理値を返します。
Navigator.standalone 非標準: ブラウザーをスタンドアロンモードで実行しているかを示す論理値を返します。 Apple の iOS Safari だけで使用できます。

非推奨のプロパティ

Navigator.activeVRDisplays 読取専用非推奨; 非標準: VRDisplay オブジェクトのうち、現在表示している（VRDisplay.ispresenting が true である）ものすべてを格納する配列を返します。
Navigator.appCodeName 読取専用非推奨;: どのブラウザーでも 'Mozilla' を返します。
Navigator.appName 読取専用非推奨;: どのブラウザーでも 'Netscape' を返します。
Navigator.appVersion 読取専用非推奨;: ブラウザーのバージョンを文字列で返します。このプロパティが正確な値を返すことを期待しないで下さい。
Navigator.doNotTrack 読取専用非推奨; 非標準: ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。
Navigator.mimeTypes 読取専用非推奨;: ブラウザーが対応している MIME タイプの一覧を MimeTypeArray で返します。
Navigator.oscpu 読取専用非推奨;: 現在の OS を表す文字列を返します。
Navigator.platform 読取専用非推奨;: 現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。
Navigator.plugins 読取専用非推奨;: PluginArray を返します。これはブラウザーにインストールされているプラグインを列挙します。
Navigator.product 読取専用非推奨;: どのブラウザーも、常に 'Gecko' を返します。
Navigator.productSub 読取専用非推奨;: '20030107' または '"20100101' の文字列のどちらかを返します。
Navigator.vendor 読取専用非推奨;: 空文字列、'Apple Computer Inc.'、'Google Inc.' のいずれかを返します。
Navigator.vendorSub 読取専用非推奨;: 常に空文字列を返します。

インスタンスメソッド

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

Navigator.canShare() 安全なコンテキスト用: Navigator.share() の呼び出しが成功した場合は true を返します。
Navigator.clearAppBadge() 安全なコンテキスト用: 現在のアプリのバッジを消去し、 undefined に解決するプロミス (Promise) を返します。
Navigator.deprecatedReplaceInURN() Experimental: 指定された文字列は、指定された不透明な URN または FencedFrameConfig 内部の url プロパティに対応する URL で置換されます。このメソッドは、一時的な措置として利用できるようになりました（そのため「非推奨」となっています）。フェンスで囲まれたフレームの URL で置換できるようにすることで、広告技術プロバイダーが既存の実装をプライバシーサンドボックス API に移行するのに役立つためです。
Navigator.getAutoplayPolicy() Experimental: 指定したメディア要素、音声コンテキスト、またはメディア機能の "type" が自動再生を許可されているかどうかを示す値を返します。
Navigator.getBattery() 安全なコンテキスト用: BatteryManager オブジェクトで解決するプロミスを返します。このオブジェクトはバッテリーの充電状態についての情報を返します。
Navigator.getGamepads(): Gamepad オブジェクトの配列を返します。それぞれがこの端末に接続されているゲームパッドを表します。
Navigator.getInstalledRelatedApps() Experimental 安全なコンテキスト用: ユーザーがインストールしている、関連するネイティブまたはプログレッシブウェブアプリを表すオブジェクトの配列で解決するプロミスを返します。
Navigator.registerProtocolHandler() 安全なコンテキスト用: 自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。
Navigator.requestMediaKeySystemAccess() 安全なコンテキスト用: MediaKeySystemAccess オブジェクト用の Promise を返します。
Navigator.requestMIDIAccess() 安全なコンテキスト用: ユーザーのシステムにおいて MIDI 機器にアクセスするリクエストを表す Promise を返します。
Navigator.sendBeacon(): ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。
Navigator.setAppBadge() 安全なコンテキスト用: このアプリに関連付けられたアイコンにバッジを設定し、 undefined で解決する Promise を返します。
Navigator.share() 安全なコンテキスト用: 現在のプラットフォームのネイティブ共有メカニズムを実行します。
Navigator.vibrate(): バイブレーションに対応している場合、端末にバイブレーションを起こします。対応していない場合は、何もしません。
Navigator.unregisterProtocolHandler() 安全なコンテキスト用: 指定されたプロトコルのハンドラーであるウェブサイトの登録を解除します。

非推奨のメソッド

Navigator.getUserMedia() 非推奨; 安全なコンテキスト用: ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの音声または動画ストリームを返します。
Navigator.getVRDisplays() 非推奨; 非標準: コンピューターに接続されて使用可能な VR 機器を表す VRDisplay の配列に解決されるプロミスを返します。
Navigator.javaEnabled() 非推奨;: 常に false を返します。
Navigator.taintEnabled() 非推奨;: false を返します。 JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。

仕様書

Specification
HTML # the-navigator-object