Navigator インターフェイスは、ユーザーエージェントの状態や身元情報を表します。スクリプトからその情報を問い合わる、および活動を続けるためにそれら自体を登録することができます。
Navigator オブジェクトは、読み取り専用の window.navigator プロパティを使用して取得できます。
プロパティ
継承するプロパティはありませんが、 NavigatorID, NavigatorLanguage, NavigatorOnLine, NavigatorContentUtils, NavigatorStorage, NavigatorStorageUtils, NavigatorConcurrentHardware, NavigatorPlugins, NavigatorUserMedia で定義されているプロパティを実装しています。
標準プロパティ
Navigator.activeVRDisplays読取専用- 現在表示中 (
VRDisplay.ispresentingがtrue) である、すべてのVRDisplayオブジェクトを収めた配列を返します。 NavigatorID.appCodeName読取専用- 現在のブラウザーの内部のコードネームを返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorID.appName読取専用- このブラウザーの公式な名前の
DOMStringを返します。このプロパティが正確な値を返すことを期待しないで下さい。 NavigatorID.appVersion読取専用- ブラウザーのバージョンを
DOMStringで返します。このプロパティが正確な値を返すことを期待しないで下さい。 Navigator.battery読取専用- バッテリー残量などの情報を取得できる
BatteryManagerオブジェクトを返します。 Navigator.connection読取専用- デバイスのネットワーク状態の情報を提供する
NetworkInformationオブジェクトを返します。 Navigator.cookieEnabled読取専用- cookie へのセットが無視される場合 false、それ以外は true を返します。
Navigator.geolocation読取専用- デバイスの物理的な場所を取得することができる
Geolocationオブジェクトを返します。 NavigatorConcurrentHardware.hardwareConcurrency読取専用- 使用可能な論理プロセッサーコアの数を返します。
NavigatorPlugins.javaEnabled読取専用- このブラウザーで Java が利用できるかどうかを
Booleanで返します。 Navigator.keyboard読取専用Keyboardオブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。NavigatorLanguage.language読取専用- ユーザーにとって一番望ましい言語 (たいていはブラウザー UI の言語) の
DOMStringを返します。不明な場合にはnullを返します。 NavigatorLanguage.languages読取専用- ユーザーが知っている言語を表す
DOMStringを、望ましい順に並べた配列を返します。 Navigator.locks読取専用- 新しい
Lockオブジェクトを要求したり、既存のLockオブジェクトをクエリしたりするためのLockManagerオブジェクトを返します。 Navigator.mediaCapabilities読取専用- 指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる
MediaCapabilitiesオブジェクトを返します。 Navigator.maxTouchPoints読取専用- 現在の端末で対応している同時タッチ点の最大数を返します。
NavigatorPlugins.mimeTypes読取専用- ブラウザーが対応している MIME タイプのリストを
MimeTypeArrayで返します。 NavigatorOnLine.onLine読取専用- 現在のブラウザーがオンラインかどうかを示す
Booleanを返します。 Navigator.oscpu- 現在の OS を表す文字列を返します。
Navigator.permissions読取専用- Permissions API が対応する API の許可状態の問い合わせや更新に使用できる、
Permissionsオブジェクトを返します。 NavigatorID.platform読取専用- 現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。
NavigatorPlugins.plugins読取専用- 現在のブラウザーにインストールされているプラグインをリストした
PluginArrayを返します。 NavigatorID.product読取専用- どのブラウザーも、常に
'Gecko'を返します。このプロパティは、互換性のために限って維持されています。 Navigator.serviceWorker読取専用ServiceWorkerContainerオブジェクトを返します。これは、associated document のServiceWorkerオブジェクトの登録、削除、更新、通信の機能を提供します。NavigatorStorage.storage読取専用- サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトン
StorageManagerオブジェクトを返します。 NavigatorID.userAgent読取専用- 現在のブラウザーのユーザーエージェントを表す文字列を返します。
Navigator.webdriver読取専用- ユーザーエージェントが自動で制御されているかどうかを示します。
標準外プロパティ
Navigator.buildID- ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では
20181001000000となります。 Navigator.credentials- ログインやログアウトの成功といったイベントが発生したときに資格情報を要求してユーザーエージェントへ通知する手段を提供する、
CredentialsContainerインターフェイスを返します。 Navigator.deviceMemory読取専用- 端末のメモリーをギガバイト単位で返します。この値は 2 の階乗の最も近い値を 1024 で割った概算値です。
Navigator.doNotTrack- ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。
Navigator.mediaDevices- 使用可能なメディアデバイスの情報を取得する (
MediaDevices.enumerateDevices())、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限できるかを確認する (MediaDevices.getSupportedConstraints())、MediaDevices.getUserMedia()を使用してメディアへのアクセスを要求するといったことができる、MediaDevicesオブジェクトへの参照を返します。 Navigator.mozNotification非推奨 Gecko 22
Navigator.webkitNotification- ウェブアプリからユーザーへ通知を送るために使用できる、
notificationオブジェクトを返します。 Navigator.mozSocialnavigator.mozSocialプロパティが返すオブジェクトは、ソーシャルメディアプロバイダーのパネル内で、それらが必要とする機能を提供するために使用できます。Navigator.presentationPresentationAPI への参照を返します。Navigator.productSub- ブラウザーのビルド番号を返します (例, "20060909")。
Navigator.securitypolicy- 空文字列を返します。Netscape 4.7x では "US & CA domestic policy" または "Export policy" を返していました。
Navigator.standalone- ブラウザーをスタンドアロンモードで実行しているかを示す boolean を返します。Apple の iOS Safari だけで使用できます。
Navigator.storageQuota読取専用- 記憶域の使用量やクォータ情報の問い合わせや要求の手段を提供する、
StorageQuotaインターフェイスを返します。 Navigator.vendor- 現在のブラウザーのベンダーネームを返します (例 "Netscape6")。
Navigator.vendorSub- vendor version number を返します (例 "6.1").
Navigator.webkitPointer- Mouse Lock API の PointerLock オブジェクトを返します。
メソッド
継承するメソッドはありませんが、 NavigatorID, NavigatorContentUtils, NavigatorUserMedia, NavigatorStorageUtils で定義されているメソッドを継承します。
標準メソッド
Navigator.getVRDisplays()- コンピューターに接続されて使用可能な VR デバイスを表す
VRDisplayの配列に解決される promise を返します。 Navigator.getUserMedia()- ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの audio または video ストリームを返します。
Navigator.registerContentHandler()Gecko 59 で廃止- ウェブサイトが自分自身を、ある MIME タイプのハンドラーとして登録できるようにします。
Navigator.registerProtocolHandler()- 自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。
Navigator.requestMediaKeySystemAccess()- MediaKeySystemAccess オブジェクト用の
Promiseを返します。 Navigator.sendBeacon()- ユーザーエージェントからウェブサーバーへ、HTTP を使用して少量のデータを非同期に転送するために使用します。
Navigator.share()- 現在のプラットフォームのネイティブ共有メカニズムを実行します。
NavigatorID.taintEnabled()非推奨 Gecko 1.7.8 Gecko 9.0 で廃止falseを返します。JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。Navigator.vibrate()- バイブレーションがサポートされている場合、デバイスにバイブレーションを起こします。サポートされていない場合、何もしません。
標準外メソッド
Firefox OS デバイスには、さらに多くの標準外メソッドがあります。Firefox OS Navigator 拡張の記事 で、それらを確認できます。
Navigator.mozIsLocallyAvailable()- 指定した URL のドキュメントが、ネットワーク接続がない状態で使用できるかを確認できます。
Navigator.mozPay()- アプリ内で支払いができるようにします。
仕様書
| 仕様書 | 状態 | 備考 |
|---|---|---|
| HTML Living Standard the Navigator object の定義 |
現行の標準 |
ブラウザーの対応
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Update compatibility data on GitHub
| デスクトップ | モバイル | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Navigator | Chrome 完全対応 あり | Edge 完全対応 あり | Firefox 完全対応 あり | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Edge Mobile 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
activeVRDisplays | Chrome
未対応
なし
| Edge 完全対応 15 | Firefox
完全対応
55
| IE 未対応 なし | Opera 未対応 なし | Safari 未対応 なし | WebView Android 完全対応 あり | Chrome Android
完全対応
あり
| Edge Mobile 未対応 なし | Firefox Android 完全対応 55 | Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android ? |
authentication | Chrome
完全対応
67
| Edge 未対応 なし | Firefox 未対応 なし | IE 未対応 なし | Opera ? | Safari 未対応 なし | WebView Android
完全対応
67
| Chrome Android
完全対応
67
| Edge Mobile 未対応 なし | Firefox Android 未対応 なし | Opera Android ? | Safari iOS 未対応 なし | Samsung Internet Android 未対応 なし |
battery | Chrome
未対応
20 — 29
| Edge 未対応 なし | Firefox
未対応
16 — 50
| IE 未対応 なし | Opera 未対応 なし | Safari 未対応 なし | WebView Android 未対応 なし | Chrome Android 未対応 なし | Edge Mobile 未対応 なし | Firefox Android
未対応
16 — 50
| Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android ? |
buildID | Chrome 未対応 なし | Edge ? | Firefox
完全対応
64
| IE ? | Opera ? | Safari ? | WebView Android 未対応 なし | Chrome Android 未対応 なし | Edge Mobile ? | Firefox Android
完全対応
64
| Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
clipboard | Chrome 完全対応 66 | Edge ? | Firefox 完全対応 63 | IE ? | Opera ? | Safari ? | WebView Android 完全対応 66 | Chrome Android 完全対応 66 | Edge Mobile ? | Firefox Android 完全対応 63 | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
connection | Chrome 完全対応 61 | Edge ? | Firefox ? | IE 未対応 なし | Opera ? | Safari 未対応 なし | WebView Android 完全対応 50 | Chrome Android 完全対応 38 | Edge Mobile ? | Firefox Android
完全対応
14
| Opera Android 完全対応 37 | Safari iOS 未対応 なし | Samsung Internet Android ? |
cookieEnabled | Chrome 完全対応 59 | Edge 完全対応 12 | Firefox
完全対応
1
| IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 59 | Chrome Android 完全対応 59 | Edge Mobile 完全対応 あり | Firefox Android
完全対応
4
| Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android ? |
credentials | Chrome 完全対応 51 | Edge 完全対応 18 | Firefox ? | IE ? | Opera ? | Safari ? | WebView Android 完全対応 51 | Chrome Android 完全対応 51 | Edge Mobile ? | Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
deviceMemory | Chrome 完全対応 63 | Edge ? | Firefox ? | IE ? | Opera 完全対応 50 | Safari ? | WebView Android 完全対応 63 | Chrome Android 完全対応 63 | Edge Mobile ? | Firefox Android ? | Opera Android 完全対応 50 | Safari iOS ? | Samsung Internet Android ? |
doNotTrack | Chrome 完全対応 23 | Edge
完全対応
17
| Firefox
完全対応
9
| IE
未対応
9 — 11
| Opera 完全対応 12 | Safari
未対応
5.1 — 7
| WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Edge Mobile
未対応
なし
| Firefox Android
完全対応
9
| Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
geolocation | Chrome 完全対応 5 | Edge 完全対応 12 | Firefox 完全対応 3.5 | IE 完全対応 9 | Opera
完全対応
16
| Safari 完全対応 5 | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Edge Mobile 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 10.6 | Safari iOS 完全対応 あり | Samsung Internet Android ? |
getBattery | Chrome 完全対応 45 | Edge 未対応 なし | Firefox
未対応
43 — 52
| IE 未対応 なし | Opera 完全対応 25 | Safari 未対応 なし | WebView Android 完全対応 45 | Chrome Android 完全対応 45 | Edge Mobile 未対応 なし | Firefox Android
未対応
43 — 52
| Opera Android 完全対応 25 | Safari iOS 未対応 なし | Samsung Internet Android ? |
getGamepads | Chrome
完全対応
35
| Edge 完全対応 12 | Firefox 完全対応 29 | IE 未対応 なし | Opera
完全対応
22
| Safari 未対応 なし | WebView Android
完全対応
37
| Chrome Android 完全対応 42 | Edge Mobile 完全対応 あり | Firefox Android 未対応 なし | Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android ? |
getUserMedia | Chrome
完全対応
21
| Edge 完全対応 12 | Firefox
完全対応
17
| IE 未対応 なし | Opera
完全対応
18
| Safari 未対応 なし | WebView Android
完全対応
40
| Chrome Android 未対応 なし | Edge Mobile 完全対応 あり | Firefox Android
完全対応
24
| Opera Android
完全対応
12
| Safari iOS 未対応 なし | Samsung Internet Android 未対応 なし |
getVRDisplays | Chrome
未対応
なし
| Edge 完全対応 15 | Firefox
完全対応
55
| IE 未対応 なし | Opera 未対応 なし | Safari 未対応 なし | WebView Android 完全対応 あり | Chrome Android
完全対応
あり
| Edge Mobile 未対応 なし | Firefox Android 完全対応 55 | Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android ? |
keyboard | Chrome 完全対応 68 | Edge 未対応 なし | Firefox 未対応 なし | IE 未対応 なし | Opera 完全対応 55 | Safari 未対応 なし | WebView Android 未対応 なし | Chrome Android 未対応 なし | Edge Mobile 未対応 なし | Firefox Android 未対応 なし | Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android 未対応 なし |
locks | Chrome 完全対応 69 | Edge ? | Firefox ? | IE ? | Opera 完全対応 56 | Safari ? | WebView Android 完全対応 69 | Chrome Android 完全対応 69 | Edge Mobile ? | Firefox Android ? | Opera Android 完全対応 56 | Safari iOS ? | Samsung Internet Android ? |
maxTouchPoints | Chrome 完全対応 35 | Edge 完全対応 12 | Firefox
完全対応
59
| IE
完全対応
11
| Opera ? | Safari 未対応 なし | WebView Android 完全対応 37 | Chrome Android 完全対応 35 | Edge Mobile ? | Firefox Android
完全対応
29
| Opera Android ? | Safari iOS 未対応 なし | Samsung Internet Android ? |
mediaCapabilities | Chrome 完全対応 66 | Edge 未対応 なし | Firefox 完全対応 63 | IE 未対応 なし | Opera 完全対応 55 | Safari 未対応 なし | WebView Android 完全対応 66 | Chrome Android 完全対応 66 | Edge Mobile 未対応 なし | Firefox Android 完全対応 63 | Opera Android 完全対応 55 | Safari iOS 未対応 なし | Samsung Internet Android ? |
mediaDevices | Chrome 完全対応 51 | Edge 完全対応 12 | Firefox 完全対応 36 | IE 完全対応 あり | Opera 未対応 なし | Safari 未対応 なし | WebView Android 完全対応 51 | Chrome Android 完全対応 51 | Edge Mobile 完全対応 あり | Firefox Android 完全対応 36 | Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android ? |
mediaSession | Chrome 未対応 なし | Edge ? | Firefox ? | IE ? | Opera 未対応 なし | Safari ? | WebView Android 未対応 なし | Chrome Android 完全対応 57 | Edge Mobile ? | Firefox Android ? | Opera Android 未対応 なし | Safari iOS ? | Samsung Internet Android ? |
mozIsLocallyAvailable | Chrome 未対応 なし | Edge 未対応 なし | Firefox 未対応 ? — 35 | IE 未対応 なし | Opera 未対応 なし | Safari 未対応 なし | WebView Android 未対応 なし | Chrome Android 未対応 なし | Edge Mobile 未対応 なし | Firefox Android 未対応 ? — 35 | Opera Android 未対応 なし | Safari iOS 未対応 なし | Samsung Internet Android 未対応 なし |
oscpu | Chrome 未対応 なし | Edge ? | Firefox 完全対応 あり | IE ? | Opera ? | Safari ? | WebView Android 未対応 なし | Chrome Android 未対応 なし | Edge Mobile ? | Firefox Android 完全対応 あり | Opera Android ? | Safari iOS 未対応 なし | Samsung Internet Android ? |
permissions | Chrome 完全対応 43 | Edge ? | Firefox 完全対応 46 | IE ? | Opera ? | Safari ? | WebView Android 未対応 なし | Chrome Android 完全対応 43 | Edge Mobile ? | Firefox Android 完全対応 46 | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
presentation | Chrome 完全対応 あり | Edge ? | Firefox 未対応 なし | IE ? | Opera ? | Safari ? | WebView Android 未対応 なし | Chrome Android 完全対応 あり | Edge Mobile ? | Firefox Android 未対応 なし | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
productSub | Chrome
完全対応
あり
| Edge 完全対応 12 | Firefox 完全対応 あり | IE
完全対応
あり
| Opera ? | Safari
完全対応
あり
| WebView Android ? | Chrome Android
完全対応
あり
| Edge Mobile ? | Firefox Android 完全対応 あり | Opera Android ? | Safari iOS
完全対応
あり
| Samsung Internet Android ? |
registerContentHandler | Chrome ? | Edge ? | Firefox 未対応 2 — 62 | IE ? | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Edge Mobile ? | Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
registerProtocolHandler | Chrome
完全対応
13
| Edge ? | Firefox 完全対応 3 | IE ? | Opera 完全対応 11.6 | Safari ? | WebView Android 未対応 なし | Chrome Android 完全対応 あり | Edge Mobile ? | Firefox Android 完全対応 4 | Opera Android ? | Safari iOS 未対応 なし | Samsung Internet Android ? |
requestMediaKeySystemAccess | Chrome
完全対応
42
| Edge 完全対応 13 | Firefox
完全対応
あり
| IE ? | Opera
完全対応
29
| Safari ? | WebView Android
完全対応
43
| Chrome Android
完全対応
42
| Edge Mobile 完全対応 あり | Firefox Android
完全対応
あり
| Opera Android
完全対応
29
| Safari iOS ? | Samsung Internet Android ? |
sendBeacon | Chrome
完全対応
39
| Edge 完全対応 14 | Firefox 完全対応 31 | IE 未対応 なし | Opera
完全対応
26
| Safari 完全対応 11.1 | WebView Android
完全対応
40
| Chrome Android
完全対応
42
| Edge Mobile 完全対応 あり | Firefox Android 完全対応 31 | Opera Android
完全対応
29
| Safari iOS 完全対応 11.1 | Samsung Internet Android ? |
serviceWorker | Chrome 完全対応 40 | Edge
完全対応
17
| Firefox
完全対応
44
| IE 未対応 なし | Opera 完全対応 27 | Safari 完全対応 11.1 | WebView Android 完全対応 40 | Chrome Android 完全対応 40 | Edge Mobile ? | Firefox Android 完全対応 44 | Opera Android 完全対応 27 | Safari iOS 完全対応 11.1 | Samsung Internet Android ? |
share | Chrome 未対応 なし | Edge ? | Firefox 未対応 なし | IE 未対応 なし | Opera 未対応 なし | Safari 未対応 なし | WebView Android 未対応 なし | Chrome Android 完全対応 61 | Edge Mobile ? | Firefox Android 未対応 なし | Opera Android 完全対応 48 | Safari iOS 未対応 なし | Samsung Internet Android ? |
vendor | Chrome 完全対応 1 | Edge 完全対応 12 | Firefox 完全対応 あり | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Edge Mobile 完全対応 あり | Firefox Android 完全対応 あり | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
vendorSub | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 あり | IE 完全対応 あり | Opera 完全対応 15 | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Edge Mobile ? | Firefox Android 完全対応 あり | Opera Android 完全対応 15 | Safari iOS 完全対応 あり | Samsung Internet Android ? |
vibrate | Chrome 完全対応 32 | Edge ? | Firefox
完全対応
16
| IE 未対応 なし | Opera 未対応 なし | Safari 未対応 なし | WebView Android
完全対応
4.4.3
| Chrome Android
完全対応
32
| Edge Mobile ? | Firefox Android
完全対応
16
| Opera Android
完全対応
あり
| Safari iOS 未対応 なし | Samsung Internet Android ? |
webdriver | Chrome 完全対応 63 | Edge 完全対応 12 | Firefox ? | IE ? | Opera 完全対応 50 | Safari ? | WebView Android ? | Chrome Android 完全対応 63 | Edge Mobile ? | Firefox Android ? | Opera Android 完全対応 50 | Safari iOS ? | Samsung Internet Android ? |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実装状況不明
- 実装状況不明
- 実験的。動作が変更される可能性があります。
- 実験的。動作が変更される可能性があります。
- 非標準。ブラウザー間の互換性が低い可能性があります。
- 非標準。ブラウザー間の互換性が低い可能性があります。
- 非推奨。新しいウェブサイトでは使用しないでください。
- 非推奨。新しいウェブサイトでは使用しないでください。
- 実装ノートを参照してください。
- 実装ノートを参照してください。
- ユーザーが明示的にこの機能を有効にしなければなりません。
- ユーザーが明示的にこの機能を有効にしなければなりません。
- 使用するには、ベンダー接頭辞または異なる名前が必要です。
- 使用するには、ベンダー接頭辞または異なる名前が必要です。