DOM

：

インターフェイス

：

Navigator インターフェイス

　 編集：2022.02.06 by T.A.

ユーザー･エージェントの状態や身元情報を表します。→●、MS

これにより、スクリプトがこれらの問い合わせを行ったり、アクティビティを実行するために自分自身を登録したりすることができます。

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

プロパティ

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

標準プロパティ
navigator.connection 読取専用 実験的
端末のネットワーク状態の情報を提供する NetworkInformation オブジェクトを返します。
navigator.cookieEnabled 読取専用
Cookie への設定を無視する場合は false、それ以外は true を返します。
navigator.credentials 読取専用
ログインやログアウトの成功といったイベントが発生したときに、資格情報を要求してユーザーエージェントへ通知する手段を提供する CredentialsContainer インターフェイスを返します。
navigator.deviceMemory 読取専用 実験的
端末のメモリーをギガバイト単位で返します。この値は 2 の累乗に最も近い値を 1024 で割った概算値です。
navigator.doNotTrack 読取専用 実験的
ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。
navigator.geolocation 読取専用
端末の物理的な場所を取得することができる Geolocation オブジェクトを返します。
navigator.hid 読取専用
HID オブジェクトを返します。これは HID 機器の接続、接続されている HID 機器の列挙、接続されている HID 機器のイベントハンドラーなどのメソッドを提供します。
navigator.hardwareConcurrency 読取専用
使用可能な論理プロセッサーコアの数を返します。
navigator.keyboard 読取専用 実験的
Keyboard オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。
navigator.language 読取専用
ユーザーにとって一番望ましい言語 (たいていはブラウザー UI の言語) の DOMString を返します。不明な場合には null を返します。
navigator.languages 読取専用 実験的
ユーザーが知っている言語を表す DOMString を、望ましい順に並べた配列を返します。
navigator.locks 読取専用 実験的
LockManager オブジェクトを返します。これは、新しい Lock オブジェクトを要求したり、既存の Lock オブジェクトをクエリしたりするためのものです。
navigator.maxTouchPoints 読取専用 ●
現在の端末で対応している同時タッチ点の最大数を返します。
navigator.mediaCapabilities 読取専用 実験的
指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる MediaCapabilities オブジェクトを返します。
navigator.mediaDevices 読取専用
MediaDevices オブジェクトへの参照を返します。これにより、使用可能なメディア端末の情報を取得する（MediaDevices.enumerateDevices()）、ユーザーのコンピューターやユーザー･エージェントで、メディアのどのような特性を制限することができるかを確認する（MediaDevices.getSupportedConstraints()）、MediaDevices.getUserMedia() を使用してメディアへのアクセスを要求するといったことができます。
navigator.mediaSession 読取専用 実験的
MediaSession オブジェクトを返します。このオブジェクトは、グローバルメディア制御の UI などで、現在再生中のメディアに関する情報をブラウザーがユーザーに提示する際に使用できるメタデータを提供するために使用することができます。
navigator.onLine 読取専用
現在のブラウザーがオンラインかどうかを示す Boolean を返します。
navigator.permissions 読取専用 実験的
Permissions オブジェクトを返します。これは、Permissions API が対応する API の許可状態の問い合わせや更新に使用できます。
navigator.presentation 読取専用 実験的
Presentation API への参照を返します。
navigator.serial 読取専用
Serial オブジェクトを返します。これは、シリアルポートを制御できるようにする Web Serial API のエントリーポイントを表します。
navigator.serviceWorker 読取専用
ServiceWorkerContainer オブジェクトを返します。これは、associated document の ServiceWorker オブジェクトの登録、削除、更新、通信の機能を提供します。
navigator.storage 読取専用
サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトンの StorageManager オブジェクトを返します。
navigator.userAgent 読取専用
現在のブラウザーのユーザーエージェントを表す文字列を返します。
navigator.vendor 読取専用
現在のブラウザーのベンダー名を返します (例 "Netscape6")。
navigator.webdriver 読取専用 実験的
ユーザーエージェントが自動で制御されているかどうかを示します。
navigator.xr 読取専用 実験的
XRSystem オブジェクトを返します。これは WebXR API のエントリー･ポイントを表します。
標準外のプロパティ
navigator.buildID 非推奨
ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では 20181001000000 となります。
navigator.contacts 読取専用 非推奨
ContactsManager インターフェイスを返します。ユーザーが連絡先リストから項目を選択し、選択した項目の限られた詳細情報をウェブサイトやアプリケーションと共有することができます。
navigator.securitypolicy 非推奨
空文字列を返します。Netscape 4.7x では "US & CA domestic policy" または "Export policy" を返していました。
navigator.standalone 非推奨
ブラウザーをスタンドアロンモードで実行しているかを示す boolean を返します。Apple の iOS Safari だけで使用できます。
navigator.wakeLock 読取専用 非推奨
WakeLock インターフェイスを返します。これは、画面のウェイクロックを要求したり、画面の減光、消灯、スクリーンセーバーの表示を防止したりするために利用できます。
非推奨のプロパティ
navigator.appCodeName 読取専用 廃止
現在のブラウザーの内部のコードネームを返します。このプロパティが正確な値を返すことを期待しないで下さい。
navigator.appName 読取専用 廃止
このブラウザーの公式な名前の DOMString を返します。このプロパティが正確な値を返すことを期待しないで下さい。
navigator.appVersion 読取専用 廃止
ブラウザーのバージョンを DOMString で返します。このプロパティが正確な値を返すことを期待しないで下さい。
navigator.activeVRDisplays 読取専用 廃止
現在表示中である（VRDisplay.ispresenting が true である）、すべての VRDisplay オブジェクトを収めた配列を返します。
navigator.battery 読取専用 廃止
バッテリー残量などの情報を取得できる BatteryManager オブジェクトを返します。
navigator.oscpu 読取専用 廃止
現在の OS を表す文字列を返します。
navigator.platform 読取専用 廃止
現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。
navigator.plugins 読取専用 廃止
PluginArray を返します。これはブラウザーにインストールされたプラグインを列挙します。
navigator.product 読取専用 廃止
どのブラウザーも、常に 'Gecko' を返します。このプロパティは、互換性だけの目的で維持されています。
navigator.productSub 読取専用 廃止
ブラウザーのビルド番号を返します（例： "20060909"）。
navigator.vendorSub 読取専用 廃止
vendor version number を返します（例： "6.1"）。
メソッド

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

navigator.canShare()
navigator.share() の呼び出しが成功した場合は true を返します。
navigator.clearAppBadge()
現在のアプリのバッジを消去し、 undefined に解決する Promise を返します。
navigator.getBattery() ●
BatteryManager オブジェクトで解決するプロミスを返します。このオブジェクトはバッテリーの充電状態についての情報を返します。
navigator.javaEnabled() 読取専用
false を返します。
navigator.registerProtocolHandler()
自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。
navigator.requestMediaKeySystemAccess()
MediaKeySystemAccess オブジェクト用の Promise を返します。
navigator.sendBeacon()
ユーザー･エージェントからウェブ･サーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。
navigator.setAppBadge()
このアプリに関連付けられたアイコンにバッジを設定し、undefined で解決する Promise を返します。
navigator.share()
現在のプラットフォームのネイティブ共有メカニズムを実行します。
Navigator.vibrate(pattern) ●
バイブレーションに対応している場合、端末にバイブレーションを起こします。対応していない場合は、何もしません。
非推奨のメソッド
navigator.getVRDisplays() 廃止
コンピューターに接続されて使用可能な VR 機器を表す VRDisplay の配列に解決されるプロミスを返します。
navigator.getUserMedia() 廃止
ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの音声または動画ストリームを返します。
navigator.taintEnabled() 廃止
false を返します。JavaScript の taint／untaint 関数は JavaScript 1.2 で削除されました。
Navigator¶.getGamepads()→●

注記： このメソッドが返すゲーム･パッド状態は、［gamepaddisconnected／gamepadconnected］イベントが発火されるまで、切断か接続かを反映しない。

現在の設定群オブジェクトの担当の文書には "gamepad" 特能の利用は許容されていない場合、SecurityError 例外を投出する。

現在［接続されていて、やりとりしているゲーム･パッド］用のデータのスナップ･ショットを検索取得する。

返される配列は、次を満たすリストを表現するものとする：

テスト
HTML：

ここに表示
スクリプト組み込み：



スクリプト：


スクリプト：



表示内容：
表示内容：