Web/API/Navigator を更新

- 2021/07/13 時点の英語版に同期

1 files changed, 64 insertions, 72 deletions

diff --git a/files/ja/web/api/navigator/index.html b/files/ja/web/api/navigator/index.html
index a45628c82a..19a930cabf 100644
--- a/files/ja/web/api/navigator/index.html
+++ b/files/ja/web/api/navigator/index.html
@@ -9,168 +9,160 @@ tags:
   - Reference
   - Web
   - Web Performance
+browser-compat: api.Navigator
 translation_of: Web/API/Navigator
 ---
 <div>{{APIRef("DOM")}}</div>
 
-<p><code><strong>Navigator</strong></code> インターフェイスは、ユーザーエージェントの状態や身元情報を表します。スクリプトからその情報を問い合わる、および活動を続けるためにそれら自体を登録することができます。</p>
+<p><code><strong>Navigator</strong></code> インターフェイスは、ユーザーエージェントの状態や身元情報を表します。これにより、スクリプトがこれらの問い合わせを行ったり、アクティビティを実行するために自分自身を登録したりすることができます。</p>
 
 <p><code>Navigator</code> オブジェクトは、読み取り専用の {{domxref("window.navigator")}} プロパティを使用して取得できます。</p>
 
-<h2 id="Properties" name="Properties">プロパティ</h2>
+<h2 id="Properties">プロパティ</h2>
 
-<p><em>継承するプロパティはありませんが、 {{domxref("NavigatorID")}}, {{domxref("NavigatorLanguage")}}, {{domxref("NavigatorOnLine")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorStorage")}}, {{domxref("NavigatorStorageUtils")}}, {{domxref("NavigatorConcurrentHardware")}}, {{domxref("NavigatorPlugins")}}, {{domxref("NavigatorUserMedia")}} で定義されているプロパティを実装しています。</em></p>
+<p><em>継承しているプロパティはありません。</em></p>
 
-<h3 id="Standard_properties" name="Standard_properties">標準プロパティ</h3>
+<h3 id="Standard_properties">標準プロパティ</h3>
 
 <dl>
  <dt>{{domxref("Navigator.connection")}} {{readonlyInline}} {{experimental_inline}}</dt>
- <dd>デバイスのネットワーク状態の情報を提供する {{domxref("NetworkInformation")}} オブジェクトを返します。</dd>
+ <dd>端末のネットワーク状態の情報を提供する {{domxref("NetworkInformation")}} オブジェクトを返します。</dd>
  <dt>{{domxref("Navigator.cookieEnabled")}} {{readonlyinline}}</dt>
- <dd>cookie へのセットが無視される場合 false、それ以外は true を返します。</dd>
+ <dd>Cookie への設定を無視する場合は false、それ以外は true を返します。</dd>
  <dt>{{domxref("Navigator.credentials")}} {{readonlyInline}}</dt>
- <dd>ログインやログアウトの成功といったイベントが発生したときに資格情報を要求してユーザーエージェントへ通知する手段を提供する、{{domxref("CredentialsContainer")}} インターフェイスを返します。</dd>
+ <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>端末の物理的な場所を取得することができる {{domxref("Geolocation")}} オブジェクトを返します。</dd>
+ <dt>{{domxref("Navigator.hid")}} {{readonlyInline}}</dt>
+ <dd>{{domxref("HID")}} オブジェクトを返します。これは HID 機器の接続、接続されている HID 機器の列挙、接続されている HID 機器のイベントハンドラーなどのメソッドを提供します。</dd>
+ <dt>{{domxref("Navigator.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>
+ <dt>{{domxref("Navigator.language")}} {{readonlyInline}}</dt>
  <dd>ユーザーにとって一番望ましい言語 (たいていはブラウザー UI の言語) の {{domxref("DOMString")}} を返します。不明な場合には <code>null</code> を返します。</dd>
- <dt>{{domxref("NavigatorLanguage.languages")}} {{readonlyInline}} {{experimental_inline}}</dt>
+ <dt>{{domxref("Navigator.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>
+ <dd>{{domxref("LockManager")}} オブジェクトを返します。これは、新しい {{domxref('Lock')}} オブジェクトを要求したり、既存の {{domxref('Lock')}} オブジェクトをクエリしたりするためのものです。</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>
+ <dd>{{domxref("MediaDevices")}} オブジェクトへの参照を返します。これにより、使用可能なメディア端末の情報を取得する ({{domxref("MediaDevices.enumerateDevices()")}})、ユーザーのコンピューターやユーザーエージェントで、メディアのどのような特性を制限することができるかを確認する ({{domxref("MediaDevices.getSupportedConstraints()")}})、{{domxref("MediaDevices.getUserMedia()")}} を使用してメディアへのアクセスを要求するといったことができます。</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>
+ <dd>{{domxref("MediaSession")}} オブジェクトを返します。このオブジェクトは、グローバルメディア制御の UI などで、現在再生中のメディアに関する情報をブラウザーがユーザーに提示する際に使用できるメタデータを提供するために使用することができます。</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>
+ <dd>{{domxref("Permissions")}} オブジェクトを返します。これは、 <a href="/ja/docs/Web/API/Permissions_API">Permissions API</a> が対応する API の許可状態の問い合わせや更新に使用できます。</dd>
  <dt>{{domxref("Navigator.presentation")}} {{readonlyInline}} {{experimental_inline}}</dt>
  <dd>{{domxref("Presentation")}} API への参照を返します。</dd>
+ <dt>{{domxref("Navigator.serial")}} {{readonlyInline}}</dt>
+ <dd>{{domxref("Serial")}} オブジェクトを返します。これは、シリアルポートを制御できるようにする {{domxref("Web Serial 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>
+ <dt>{{domxref("Navigator.storage")}} {{readonlyinline}}</dt>
+ <dd>サイトごとまたはアプリごとに持続的な記憶域の許可の管理や使用可能な記憶域の試算に使用する、シングルトンの {{domxref('StorageManager')}} オブジェクトを返します。</dd>
+ <dt>{{domxref("Navigator.userAgent")}} {{readonlyInline}}</dt>
  <dd>現在のブラウザーのユーザーエージェントを表す文字列を返します。</dd>
  <dt>{{domxref("Navigator.vendor")}} {{readonlyInline}}</dt>
- <dd>現在のブラウザーのベンダーネームを返します (例 "Netscape6")。</dd>
- <dt>{{domxref("Navigator.webdriver")}} {{readonlyInline}} {{experimental_inline}}</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>
+ <dd>{{domxref("XRSystem")}} オブジェクトを返します。これは <a href="/ja/docs/Web/API/WebXR_API">WebXR API</a> のエントリーポイントを表します。</dd>
 </dl>
 
-<h3 id="Non-standard_properties" name="Non-standard_properties">標準外プロパティ</h3>
+<h3 id="Non-standard_properties">標準外のプロパティ</h3>
 
 <dl>
  <dt>{{domxref("Navigator.buildID")}} {{non-standard_inline}}</dt>
  <dd>ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では <code>20181001000000</code> となります。</dd>
+ <dt>{{domxref("Navigator.contacts")}} {{readonlyInline}} {{non-standard_inline}}</dt>
+ <dd>{{domxref('ContactsManager')}} インターフェイスを返します。ユーザーが連絡先リストから項目を選択し、選択した項目の限られた詳細情報をウェブサイトやアプリケーションと共有することができます。</dd>
  <dt>{{domxref("Navigator.securitypolicy")}} {{non-standard_inline}}</dt>
  <dd>空文字列を返します。Netscape 4.7x では "US &amp; 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>
+ <dd>{{domxref("WakeLock")}} インターフェイスを返します。これは、画面のウェイクロックを要求したり、画面の減光、消灯、スクリーンセーバーの表示を防止したりするために利用できます。</dd>
 </dl>
 
-<h3 id="Deprecated_properties" name="Deprecated_properties">非推奨のプロパティ</h3>
+<h3 id="Deprecated_properties">非推奨のプロパティ</h3>
 
 <dl>
- <dt>{{domxref("NavigatorID.appCodeName")}} {{readonlyInline}} {{deprecated_inline}}</dt>
+ <dt>{{domxref("Navigator.appCodeName")}} {{readonlyInline}} {{deprecated_inline}}</dt>
  <dd>現在のブラウザーの内部のコードネームを返します。このプロパティが正確な値を返すことを期待しないで下さい。</dd>
- <dt>{{domxref("NavigatorID.appName")}} {{readonlyInline}} {{deprecated_inline}}</dt>
+ <dt>{{domxref("Navigator.appName")}} {{readonlyInline}} {{deprecated_inline}}</dt>
  <dd>このブラウザーの公式な名前の {{domxref("DOMString")}} を返します。このプロパティが正確な値を返すことを期待しないで下さい。</dd>
- <dt>{{domxref("NavigatorID.appVersion")}} {{readonlyInline}} {{deprecated_inline}}</dt>
+ <dt>{{domxref("Navigator.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>
+ <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>
+ <dt>{{domxref("Navigator.platform")}} {{readonlyInline}} {{deprecated_inline}}</dt>
  <dd>現在のブラウザーのプラットフォームを表す文字列を返します。このプロパティが正確な値を返すことを期待しないで下さい。</dd>
- <dt>{{domxref("NavigatorID.product")}} {{readonlyInline}} {{deprecated_inline}}</dt>
- <dd>どのブラウザーも、常に <code>'Gecko'</code> を返します。このプロパティは、互換性のために限って維持されています。</dd>
+ <dt>{{domxref("Navigator.plugins")}} {{readonlyInline}}{{deprecated_inline}}</dt>
+ <dd>{{domxref("PluginArray")}} を返します。これはブラウザーにインストールされたプラグインを列挙します。</dd>
+ <dt>{{domxref("Navigator.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>
+<h2 id="Methods">メソッド</h2>
 
-<p><em>継承するメソッドはありませんが、 {{domxref("NavigatorID")}}, {{domxref("NavigatorContentUtils")}}, {{domxref("NavigatorUserMedia")}}, {{domxref("NavigatorStorageUtils")}} で定義されているメソッドを継承します。</em></p>
+<p><em>継承するメソッドはありません。</em></p>
 
 <dl>
  <dt>{{domxref("Navigator.canShare()")}}</dt>
- <dd>Returns <code>true</code> if a call to <code>Navigator.share()</code> would succeed.</dd>
+ <dd><code>Navigator.share()</code> の呼び出しが成功した場合は <code>true</code> を返します。</dd>
+ <dt>{{domxref("Navigator.clearAppBadge()")}}</dt>
+ <dd>現在のアプリのバッジを消去し、 {{jsxref("undefined")}} に解決する {{jsxref("Promise")}} を返します。</dd>
+ <dt>{{domxref("Navigator.getBattery()")}}</dt>
+ <dd>{{domxref("BatteryManager")}} オブジェクトで解決するプロミスを返します。このオブジェクトはバッテリーの充電状態についての情報を返します。</dd>
+ <dt>{{domxref("Navigator.javaEnabled()")}} {{readonlyInline}}</dt>
+ <dd>false を返します。</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.setAppBadge()")}}</dt>
+ <dd>このアプリに関連付けられたアイコンにバッジを設定し、 {{jsxref("undefined")}} で解決する {{jsxref("Promise")}} を返します。</dd>
  <dt>{{domxref("Navigator.share()")}}</dt>
  <dd>現在のプラットフォームのネイティブ共有メカニズムを実行します。</dd>
  <dt>{{domxref("Navigator.vibrate()")}}</dt>
- <dd>バイブレーションがサポートされている場合、デバイスにバイブレーションを起こします。サポートされていない場合、何もしません。</dd>
+ <dd>バイブレーションに対応している場合、端末にバイブレーションを起こします。対応していない場合は、何もしません。</dd>
 </dl>
 
-<h3 id="Deprecated_methods" name="Deprecated_methods">非推奨のメソッド</h3>
+<h3 id="Deprecated_methods">非推奨のメソッド</h3>
 
 <dl>
  <dt>{{domxref("Navigator.getVRDisplays()")}} {{deprecated_inline}}</dt>
- <dd>コンピューターに接続されて使用可能な VR デバイスを表す {{domxref("VRDisplay")}} の配列に解決される promise を返します。</dd>
+ <dd>コンピューターに接続されて使用可能な VR 機器を表す {{domxref("VRDisplay")}} の配列に解決されるプロミスを返します。</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>
+ <dd>ユーザーにプロンプトで許可を取った後に、ローカルコンピューターのマイクやカメラからの音声または動画ストリームを返します。</dd>
+ <dt>{{domxref("Navigator.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>
+<h2 id="Specifications">仕様書</h2>
+
+{{Specifications}}
+
+<h2 id="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div>{{Compat}}</div>