1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
---
title: Navigator
slug: Web/API/Navigator
tags:
- API
- DOM
- Interface
- Navigator
- Reference
- Web
- Web Performance
translation_of: Web/API/Navigator
---
<div>{{APIRef("DOM")}}</div>
<p><code><strong>Navigator</strong></code> インターフェイスは、ユーザーエージェントの状態や身元情報を表します。スクリプトからその情報を問い合わる、および活動を続けるためにそれら自体を登録することができます。</p>
<p><code>Navigator</code> オブジェクトは、読み取り専用の {{domxref("window.navigator")}} プロパティを使用して取得できます。</p>
<h2 id="Properties" name="Properties">プロパティ</h2>
<p><em>継承するプロパティはありませんが、 {{domxref("NavigatorID")}}, {{domxref("NavigatorLanguage")}}, {{domxref("NavigatorOnLine")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorStorage")}}, {{domxref("NavigatorStorageUtils")}}, {{domxref("NavigatorConcurrentHardware")}}, {{domxref("NavigatorPlugins")}}, {{domxref("NavigatorUserMedia")}} で定義されているプロパティを実装しています。</em></p>
<h3 id="Standard_properties" name="Standard_properties">標準プロパティ</h3>
<dl>
<dt>{{domxref("Navigator.connection")}} {{readonlyInline}} {{experimental_inline}}</dt>
<dd>デバイスのネットワーク状態の情報を提供する {{domxref("NetworkInformation")}} オブジェクトを返します。</dd>
<dt>{{domxref("Navigator.cookieEnabled")}} {{readonlyinline}}</dt>
<dd>cookie へのセットが無視される場合 false、それ以外は true を返します。</dd>
<dt>{{domxref("Navigator.credentials")}} {{readonlyInline}}</dt>
<dd>ログインやログアウトの成功といったイベントが発生したときに資格情報を要求してユーザーエージェントへ通知する手段を提供する、{{domxref("CredentialsContainer")}} インターフェイスを返します。</dd>
<dt>{{domxref("Navigator.deviceMemory")}} {{readonlyInline}} {{experimental_inline}}</dt>
<dd>端末のメモリーをギガバイト単位で返します。この値は 2 の階乗の最も近い値を 1024 で割った概算値です。</dd>
<dt>{{domxref("Navigator.doNotTrack")}} {{readonlyInline}} {{experimental_inline}}</dt>
<dd>ユーザーの do-not-track 設定の値を返します。この値が "yes" であるとき、ウェブサイトやアプリケーションはユーザーを追跡するべきではありません。</dd>
<dt>{{domxref("Navigator.geolocation")}} {{readonlyInline}}</dt>
<dd>デバイスの物理的な場所を取得することができる {{domxref("Geolocation")}} オブジェクトを返します。</dd>
<dt>{{domxref("NavigatorConcurrentHardware.hardwareConcurrency")}} {{readonlyInline}}</dt>
<dd>使用可能な論理プロセッサーコアの数を返します。</dd>
<dt>{{domxref("NavigatorPlugins.javaEnabled")}} {{readonlyInline}}</dt>
<dd>このブラウザーで Java が利用できるかどうかを {{domxref("Boolean")}} で返します。</dd>
<dt>{{domxref('Navigator.keyboard')}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>{{domxref('Keyboard')}} オブジェクトを返し、キーボード配置マップを受け取る関数へのアクセスを提供したり、物理キーボードからキーの押下のキャプチャを有効化・無効化したりできるようにします。</dd>
<dt>{{domxref("NavigatorLanguage.language")}} {{readonlyInline}}</dt>
<dd>ユーザーにとって一番望ましい言語 (たいていはブラウザー UI の言語) の {{domxref("DOMString")}} を返します。不明な場合には <code>null</code> を返します。</dd>
<dt>{{domxref("NavigatorLanguage.languages")}} {{readonlyInline}} {{experimental_inline}}</dt>
<dd>ユーザーが知っている言語を表す {{domxref("DOMString")}} を、望ましい順に並べた配列を返します。</dd>
<dt>{{domxref("Navigator.locks")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>新しい {{domxref('Lock')}} オブジェクトを要求したり、既存の {{domxref('Lock')}} オブジェクトをクエリしたりするための {{domxref("LockManager")}} オブジェクトを返します。</dd>
<dt>{{domxref("Navigator.maxTouchPoints")}} {{readonlyInline}}</dt>
<dd>現在の端末で対応している同時タッチ点の最大数を返します。</dd>
<dt>{{domxref("Navigator.mediaCapabilities")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>指定された形式のデコードおよびエンコード能力、それに出力能力についての情報が得られる {{domxref("MediaCapabilities")}} オブジェクトを返します。</dd>
<dt>{{domxref("Navigator.mediaDevices")}} {{readonlyinline}}</dt>
<dd>使用可能なメディアデバイスの情報を取得する ({{domxref("MediaDevices.enumerateDevices()")}})、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限できるかを確認する ({{domxref("MediaDevices.getSupportedConstraints()")}})、{{domxref("MediaDevices.getUserMedia()")}} を使用してメディアへのアクセスを要求するといったことができる、{{domxref("MediaDevices")}} オブジェクトへの参照を返します。</dd>
<dt>{{domxref("Navigator.mediaSession")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd>Returns {{domxref("MediaSession")}} object which can be used to provide metadata that can be used by the browser to present information about the currently-playing media to the user, such as in a global media controls UI.</dd>
<dt>{{domxref("NavigatorPlugins.mimeTypes")}} {{readonlyInline}}</dt>
<dd>ブラウザーが対応している MIME タイプのリストを {{domxref("MimeTypeArray")}} で返します。</dd>
<dt>{{domxref("Navigator.onLine")}} {{readonlyInline}}</dt>
<dd>現在のブラウザーがオンラインかどうかを示す {{domxref("Boolean")}} を返します。</dd>
<dt>{{domxref("Navigator.permissions")}} {{readonlyinline}} {{experimental_inline}}</dt>
<dd><a href="/ja/docs/Web/API/Permissions_API">Permissions API</a> が対応する API の許可状態の問い合わせや更新に使用できる、{{domxref("Permissions")}} オブジェクトを返します。</dd>
<dt>{{domxref("NavigatorPlugins.plugins")}} {{readonlyInline}}</dt>
<dd>現在のブラウザーにインストールされているプラグインをリストした {{domxref("PluginArray")}} を返します。</dd>
<dt>{{domxref("Navigator.presentation")}} {{readonlyInline}} {{experimental_inline}}</dt>
<dd>{{domxref("Presentation")}} API への参照を返します。</dd>
<dt>{{domxref("Navigator.serviceWorker")}} {{readonlyInline}}</dt>
<dd>{{domxref("ServiceWorkerContainer")}} オブジェクトを返します。これは、<a href="https://html.spec.whatwg.org/multipage/browsers.html#concept-document-window">associated document</a> の {{domxref("ServiceWorker")}} オブジェクトの登録、削除、更新、通信の機能を提供します。</dd>
<dt>{{domxref("NavigatorStorage.storage")}} {{readonlyinline}}</dt>
<dd>サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトン {{domxref('StorageManager')}} オブジェクトを返します。</dd>
<dt>{{domxref("NavigatorID.userAgent")}} {{readonlyInline}}</dt>
<dd>現在のブラウザーのユーザーエージェントを表す文字列を返します。</dd>
<dt>{{domxref("Navigator.vendor")}} {{readonlyInline}}</dt>
<dd>現在のブラウザーのベンダーネームを返します (例 "Netscape6")。</dd>
<dt>{{domxref("Navigator.webdriver")}} {{readonlyInline}} {{experimental_inline}}</dt>
<dd>ユーザーエージェントが自動で制御されているかどうかを示します。</dd>
<dt>{{domxref("Navigator.xr")}} {{readonlyInline}} {{experimental_inline}}</dt>
<dd>Returns {{domxref("XR")}} object, which represents the entry point into the <a href="/en-US/docs/Web/API/WebXR_API">WebXR API</a>.</dd>
</dl>
<h3 id="Non-standard_properties" name="Non-standard_properties">標準外プロパティ</h3>
<dl>
<dt>{{domxref("Navigator.buildID")}} {{non-standard_inline}}</dt>
<dd>ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では <code>20181001000000</code> となります。</dd>
<dt>{{domxref("Navigator.securitypolicy")}} {{non-standard_inline}}</dt>
<dd>空文字列を返します。Netscape 4.7x では "US & CA domestic policy" または "Export policy" を返していました。</dd>
<dt>{{domxref("Navigator.standalone")}} {{non-standard_inline}}</dt>
<dd>ブラウザーをスタンドアロンモードで実行しているかを示す boolean を返します。Apple の iOS Safari だけで使用できます。</dd>
<dt>{{domxref("Navigator.wakeLock")}} {{readonlyInline}} {{non-standard_inline}}</dt>
<dd>Returns a {{domxref("WakeLock")}} interface you can use to request screen wake locks and prevent screen from dimming, turning off, or showing a screen saver.</dd>
</dl>
<h3 id="Deprecated_properties" name="Deprecated_properties">非推奨のプロパティ</h3>
<dl>
<dt>{{domxref("NavigatorID.appCodeName")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>現在のブラウザーの内部のコードネームを返します。このプロパティが正確な値を返すことを期待しないで下さい。</dd>
<dt>{{domxref("NavigatorID.appName")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>このブラウザーの公式な名前の {{domxref("DOMString")}} を返します。このプロパティが正確な値を返すことを期待しないで下さい。</dd>
<dt>{{domxref("NavigatorID.appVersion")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>ブラウザーのバージョンを {{domxref("DOMString")}} で返します。このプロパティが正確な値を返すことを期待しないで下さい。</dd>
<dt>{{domxref("Navigator.activeVRDisplays")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>現在表示中 ({{domxref("VRDisplay.ispresenting")}} が <code>true</code>) である、すべての {{domxref("VRDisplay")}} オブジェクトを収めた配列を返します。</dd>
<dt>{{domxref("Navigator.battery")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>バッテリー残量などの情報を取得できる {{domxref("BatteryManager")}} オブジェクトを返します。</dd>
<dt>{{domxref("Navigator.oscpu")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>現在の OS を表す文字列を返します。</dd>
<dt>{{domxref("NavigatorID.platform")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。</dd>
<dt>{{domxref("NavigatorID.product")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>どのブラウザーも、常に <code>'Gecko'</code> を返します。このプロパティは、互換性のために限って維持されています。</dd>
<dt>{{domxref("Navigator.productSub")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>ブラウザーのビルド番号を返します (例, "20060909")。</dd>
<dt>{{domxref("Navigator.storageQuota")}} {{readonlyinline}} {{deprecated_inline}}</dt>
<dd>記憶域の使用量やクォータ情報の問い合わせや要求の手段を提供する、{{domxref('StorageQuota')}} インターフェイスを返します。</dd>
<dt>{{domxref("Navigator.vendorSub")}} {{readonlyInline}} {{deprecated_inline}}</dt>
<dd>vendor version number を返します (例 "6.1").</dd>
</dl>
<h2 id="Methods" name="Methods">メソッド</h2>
<p><em>継承するメソッドはありませんが、 {{domxref("NavigatorID")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorUserMedia")}}, {{domxref("NavigatorStorageUtils")}} で定義されているメソッドを継承します。</em></p>
<dl>
<dt>{{domxref("Navigator.canShare()")}}</dt>
<dd>Returns <code>true</code> if a call to <code>Navigator.share()</code> would succeed.</dd>
<dt>{{domxref("Navigator.registerProtocolHandler()")}}</dt>
<dd>自分自身のサイトに URL などのプロトコルに関連づけたハンドラーを可能な限り登録します。</dd>
<dt>{{domxref("Navigator.requestMediaKeySystemAccess()")}}</dt>
<dd>MediaKeySystemAccess オブジェクト用の {{jsxref("Promise")}} を返します。</dd>
<dt>{{domxref("Navigator.sendBeacon()")}}</dt>
<dd>ユーザーエージェントからウェブサーバーへ、{{Glossary("HTTP")}} を使用して少量のデータを非同期に転送するために使用します。</dd>
<dt>{{domxref("Navigator.share()")}}</dt>
<dd>現在のプラットフォームのネイティブ共有メカニズムを実行します。</dd>
<dt>{{domxref("Navigator.vibrate()")}}</dt>
<dd>バイブレーションがサポートされている場合、デバイスにバイブレーションを起こします。サポートされていない場合、何もしません。</dd>
</dl>
<h3 id="Deprecated_methods" name="Deprecated_methods">非推奨のメソッド</h3>
<dl>
<dt>{{domxref("Navigator.getVRDisplays()")}} {{deprecated_inline}}</dt>
<dd>コンピューターに接続されて使用可能な VR デバイスを表す {{domxref("VRDisplay")}} の配列に解決される promise を返します。</dd>
<dt>{{domxref("Navigator.getUserMedia()")}} {{deprecated_inline}}</dt>
<dd>ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの audio または video ストリームを返します。</dd>
<dt>{{domxref("Navigator.registerContentHandler()")}} {{deprecated_inline}}</dt>
<dd>ウェブサイトが自分自身を、ある MIME タイプのハンドラーとして登録できるようにします。</dd>
<dt>{{domxref("NavigatorID.taintEnabled()")}} {{deprecated_inline}}</dt>
<dd><code>false</code> を返します。JavaScript の taint/untaint 関数は JavaScript 1.2 で削除されました。</dd>
</dl>
<h2 id="Specifications" name="Specifications">仕様書</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">仕様書</th>
<th scope="col">状態</th>
<th scope="col">備考</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('HTML WHATWG', '#the-navigator-object', 'the Navigator object')}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td></td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
<div>{{Compat("api.Navigator")}}</div>
|
