diff options
Diffstat (limited to 'files/ja/web/api/navigator')
43 files changed, 3043 insertions, 0 deletions
diff --git a/files/ja/web/api/navigator/activevrdisplays/index.html b/files/ja/web/api/navigator/activevrdisplays/index.html new file mode 100644 index 0000000000..bedccb5eb0 --- /dev/null +++ b/files/ja/web/api/navigator/activevrdisplays/index.html @@ -0,0 +1,67 @@ +--- +title: Navigator.activeVRDisplays +slug: Web/API/Navigator/activeVRDisplays +tags: + - API + - Experimental + - HTML DOM + - Navigator + - Property + - Reference + - VR + - Virtual Reality + - WebVR + - activeVRDisplays +translation_of: Web/API/Navigator/activeVRDisplays +--- +<div>{{DefaultAPISidebar("WebVR API")}}{{Obsolete_header}}</div> + +<p><strong><code>activeVRDisplays</code></strong> は {{domxref("Navigator")}} インターフェイスの読み取り専用プロパティで、現在表示中 ({{domxref("VRDisplay.ispresenting")}} が <code>true</code>) のすべての {{domxref("VRDisplay")}} オブジェクトを含んだ配列を返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">var myActiveDisplays = navigator.activeVRDisplays;</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("VRDisplay")}} オブジェクトの配列です。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js notranslate">function showActive() { + var displays = navigator.activeVRDisplays; + for(var i = 0; i < displays.length; i++) { + console.log('Display ' + displays[i].displayId + ' is active.'); + } +} +</pre> + +<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("WebVR 1.1", '#navigator-activevrdisplays-attribute', 'activeVRDisplays')}}</td> + <td>{{Spec2("WebVR 1.1")}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<p>{{Compat("api.Navigator.activeVRDisplays")}}</p> + +<h2 id="参照">参照</h2> + +<ul> + <li><a href="/ja/docs/Web/API/WebVR_API">WebVR API ホームページ</a></li> + <li><a href="http://mozvr.com/">MozVr.com</a> — Mozilla VR チームのデモ、ダウンロード、その他のリソース</li> +</ul> diff --git a/files/ja/web/api/navigator/battery/index.html b/files/ja/web/api/navigator/battery/index.html new file mode 100644 index 0000000000..5ab81d5651 --- /dev/null +++ b/files/ja/web/api/navigator/battery/index.html @@ -0,0 +1,45 @@ +--- +title: Navigator.battery +slug: Web/API/Navigator/battery +tags: + - API + - Battery + - Battery API + - Device API + - Navigator + - Non-standard + - Obsolete + - Property + - Reference + - バッテリ + - プロパティ + - 廃止 + - 標準外 +translation_of: Web/API/Navigator/battery +--- +<div>{{ApiRef("Battery API")}}</div> + +<p><span class="seoSummary"><strong><code>battery</code></strong> プロパティは読み取り専用で、システムのバッテリの充電レベルや端末が充電中であるかどうかについての情報を提供し、これらのパラメーターが変化したときに発生するイベントを公開する {{DOMxRef("BatteryManager")}} を返します。このインターフェイスは <a href="/ja/docs/Web/API/Battery_Status_API">Battery Status API</a> の早期の草稿で導入されましたが、 {{JSxRef("Promise")}} ベースの {{DOMxRef("Navigator.getBattery","Navigator.getBattery()")}} に置き換えられました。</span></p> + +<div class="note"> +<p><code>battery</code> プロパティは非推奨になり、バッテリの {{JSxRef("Promise")}} を返す {{DOMxRef("Navigator.getBattery","Navigator.getBattery()")}} メソッドに置き換えられました。</p> +</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">var battery = navigator.battery;</pre> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.battery")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{DOMxRef("Navigator.getBattery","Navigator.getBattery()")}}</li> + <li><a href="/ja/docs/Web/API/Battery_Status_API">Battery Status API</a></li> + <li><a class="external" href="http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/">Blog post - Using the Battery API</a></li> + <li><a class="external" href="http://davidwalsh.name/battery-api" title="http://davidwalsh.name/battery-api">David Walsh on the JavaScript Battery API</a></li> +</ul> diff --git a/files/ja/web/api/navigator/buildid/index.html b/files/ja/web/api/navigator/buildid/index.html new file mode 100644 index 0000000000..ae1d567353 --- /dev/null +++ b/files/ja/web/api/navigator/buildid/index.html @@ -0,0 +1,44 @@ +--- +title: Navigator.buildID +slug: Web/API/Navigator/buildID +tags: + - API + - DOM + - Gecko + - Navigator + - Property + - buildID +translation_of: Web/API/Navigator/buildID +--- +<p>{{ ApiRef("HTML DOM") }}</p> + +<p>ブラウザーのビルド識別子を返します。最近のブラウザーでは、このプロパティはプライバシーの目的で、固定のタイムスタンプを返すようになり、例えば Firefox 64 系列では <code>20181001000000</code> となります。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="eval"><var>buildID</var> = <var>navigator</var>.buildID; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>アプリケーションのビルド識別子を表す文字列です。 ビルド識別子は <code>YYYYMMDDHHMMSS</code> の形式です。</p> + +<h2 id="Example" name="Example">例</h2> + +<pre class="eval">console.log(window.navigator.buildID);</pre> + +<h2 id="Specification" name="Specification">仕様書</h2> + +<p>どの公的な標準にも属していません。</p> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.Navigator.buildID")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="https://www.fxsitecompat.com/en-CA/docs/2018/navigator-buildid-now-returns-a-fixed-timestamp/">navigator.buildID now returns a fixed timestamp</a></li> +</ul> diff --git a/files/ja/web/api/navigator/clipboard/index.html b/files/ja/web/api/navigator/clipboard/index.html new file mode 100644 index 0000000000..6da9255a8e --- /dev/null +++ b/files/ja/web/api/navigator/clipboard/index.html @@ -0,0 +1,67 @@ +--- +title: Navigator.clipboard +slug: Web/API/Navigator/clipboard +tags: + - API + - Clipboard + - Navigator + - Property + - Read-only + - Reference + - クリップボード + - コピー + - プロパティ + - 切り取り + - 貼り付け +translation_of: Web/API/Navigator/clipboard +--- +<p><span class="seoSummary"><a href="/ja/docs/Web/API/Clipboard_API">Clipboard API</a> は <strong>{{domxref("Navigator")}}</strong> インターフェイスに読み取り専用の <strong><code>clipboard</code></strong> プロパティを追加し、クリップボードの内容を読み書きするために使用する {{domxref("Clipboard")}} オブジェクトを返します。</span> Clipboard API は切り取り、コピー、貼り付け機能をウェブアプリケーションに実装するために使用することができます。</p> + +<p>非同期のクリップボード読み書きメソッドを使用するには、ユーザーがウェブサイトやアプリにクリップボードへのアクセスを許可する必要があります。この許可は <a href="/ja/docs/Web/API/Permissions_API">Permissions API</a> から、 <code>"clipboard-read"</code> や <code>"clipboard-write"</code> の権限を取得する必要があります。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>theClipboard</em> = navigator.clipboard; +</pre> + +<h2 id="Value" name="Value">値</h2> + +<p>システムのクリップボードにアクセスするために使用される {{domxref("Clipboard")}} オブジェクトです。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<p>以下のコードは、クリップボードの内容を読み取る目的でシステムのクリップボードにアクセスするため、 <code>navigator.clipboard</code> を使用します。</p> + +<pre class="brush: js">navigator.clipboard.readText().then( + clipText => document.querySelector(".cliptext").innerText = clipText);</pre> + +<p>このスニペットは、クラスが <code>"cliptext"</code> の要素の内容を、クリップボードのテキストコンテンツで置き換えます。おそらくこのコードは現在のクリップボードの内容を表示するブラウザー拡張機能に使用されているもので、定期的または特定のイベントが発火したときに自動的に更新されます。</p> + +<p>クリップボードが空であるか、テキストが含まれていない場合、 <code>"cliptext"</code> の要素の内容はクリアされます。これは、クリップボードが空かテキストが含まれていない場合、 {{domxref("Clipboard.readText", "readText()")}} が空文字列を返すからです。</p> + +<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('Clipboard API','#navigator-clipboard','navigator.clipboard')}}</td> + <td>{{Spec2('Clipboard API')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_Compatibility" name="Browser_Compatibility">ブラウザーの互換性</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.Navigator.clipboard")}}</p> + +<div>{{APIRef("Clipboard API")}}</div> diff --git a/files/ja/web/api/navigator/connection/index.html b/files/ja/web/api/navigator/connection/index.html new file mode 100644 index 0000000000..d5bfd67fd7 --- /dev/null +++ b/files/ja/web/api/navigator/connection/index.html @@ -0,0 +1,54 @@ +--- +title: Navigator.connection +slug: Web/API/Navigator/connection +tags: + - API + - Experimental + - Navigator + - Network Information API + - Property + - Reference +translation_of: Web/API/Navigator/connection +--- +<div>{{APIRef("Network Information API")}}{{SeeCompatTable}}</div> + +<p><span class="seoSummary"><code><strong>Navigator.connection</strong></code> は読み取り専用プロパティで、ユーザーの端末の現在の帯域幅や、接続が測定されているかどうかなどのシステムの接続に関する情報を含む {{domxref("NetworkInformation")}} を返します。</span>ユーザーの接続に基づいて高解像度コンテンツ、または低解像度コンテンツのいずれを使うかの選択に使用できます。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>networkInformation</var> = navigator.connection</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("NetworkInformation")}} オブジェクトです。</p> + +<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('Network Information', '#connection-attribute', 'Navigator.connection')}}</td> + <td>{{Spec2('Network Information')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.connection")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/NavigatorOnLine/Online_and_offline_events">オンライン・オフラインイベント</a></li> +</ul> diff --git a/files/ja/web/api/navigator/cookieenabled/index.html b/files/ja/web/api/navigator/cookieenabled/index.html new file mode 100644 index 0000000000..e3fb3d058a --- /dev/null +++ b/files/ja/web/api/navigator/cookieenabled/index.html @@ -0,0 +1,59 @@ +--- +title: Navigator.cookieEnabled +slug: Web/API/Navigator/cookieEnabled +tags: + - API + - HTML DOM + - Navigator + - Property + - プロパティ +translation_of: Web/API/Navigator/cookieEnabled +--- +<div>{{ApiRef("HTML DOM")}}</div> + +<p><span class="seoSummary"><code>navigator.cookieEnabled</code> は、クッキーが有効かどうかを示す Boolean 値を返します。</span>このプロパティは読み取り専用です。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="brush: js">var cookieEnabled = navigator.cookieEnabled; +</pre> + +<ul> + <li><code>cookieEnabled</code> は <a href="/ja/docs/Glossary/Boolean">Boolean</a> で、 <code>true</code> または <code>false</code> のいずれかです。</li> +</ul> + +<div class="note"><strong>注:</strong> ブラウザーがサードパーティのクッキーをブロックするように構成されていた場合で、 <code>navigator.cookieEnabled</code> がサードパーティの iframe の中で呼び出された場合、 Safari, Edge Spartan, IE では <code>true</code> を返します (この場合にクッキーを設定しようとしても失敗するにもかかわらず)。 Firefox および Chromium ベースのブラウザーでは <code>false</code> を返します。</div> + +<div class="note"><strong>注:</strong> ウェブブラウザーは特定の場面で特定のクッキーを書き込むことを阻止することがあります。例えば、 Chrome 80 以降では <code><a href="/ja/docs/Web/HTTP/Headers/Set-Cookie/SameSite">SameSite=None</a></code> 属性の付いたクッキーを作成することを許可しませんが、 <a href="https://www.chromestatus.com/feature/5633521622188032">HTTPS 上で生成され <code>Secure</code> 属性がある場合は例外です。</a></div> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush: js">if (!navigator.cookieEnabled) { + // The browser does not support or is blocking cookies from being set. +} +</pre> + +<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", "webappapis.html#dom-navigator-cookieenabled", "Navigator.cookieEnabled")}}</td> + <td>{{Spec2("HTML WHATWG")}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.cookieEnabled")}}</p> diff --git a/files/ja/web/api/navigator/credentials/index.html b/files/ja/web/api/navigator/credentials/index.html new file mode 100644 index 0000000000..d4e7110462 --- /dev/null +++ b/files/ja/web/api/navigator/credentials/index.html @@ -0,0 +1,61 @@ +--- +title: Navigator.credentials +slug: Web/API/Navigator/credentials +tags: + - API + - CredentialsContainer + - Property + - Reference + - credentials + - プロパティ + - 資格情報 +translation_of: Web/API/Navigator/credentials +--- +<div>{{securecontext_header}}{{APIRef("")}}</div> + +<p><strong><code>credentials</code></strong> は {{domxref("Navigator")}} インターフェイスのプロパティで、リクエストの資格情報のメソッドを公開する {{domxref("CredentialsContainer")}} インターフェイスを返します。 {{domxref("CredentialsContainer")}} インターフェイスはサインインやサインアウトに成功した場合など、興味深いイベントが発生したことをユーザーエージェントに通知したりもします。このインターフェイスは機能検出に使用することができます。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">var credentialsContainer = navigator.credentials</pre> + +<h3 id="Value" name="Value">Value</h3> + +<p>{{domxref("CredentialsContainer")}} インターフェイスです。</p> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush: js">if ('credentials' in navigator) { + navigator.credentials.get({password: true}) + .then(function(creds) { + //資格情報付きで何かを行う + }); +} else { + //Handle sign-in the way you did before. +}; +</pre> + +<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('Credential Management')}}</td> + <td>{{Spec2('Credential Management')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.credentials")}}</p> diff --git a/files/ja/web/api/navigator/devicememory/index.html b/files/ja/web/api/navigator/devicememory/index.html new file mode 100644 index 0000000000..8a307e45f6 --- /dev/null +++ b/files/ja/web/api/navigator/devicememory/index.html @@ -0,0 +1,62 @@ +--- +title: Navigator.deviceMemory +slug: Web/API/Navigator/deviceMemory +tags: + - API + - Device Memory API + - Navigator + - Property + - Reference + - deviceMemory + - memory +translation_of: Web/API/Navigator/deviceMemory +--- +<div>{{APIRef("Device Memory")}}{{securecontext_header}}{{SeeCompatTable}}</div> + +<p><span class="seoSummary"><strong><code>deviceMemory</code></strong> は {{domxref("Navigator")}} インターフェイスの読み取り専用プロパティで、端末のおよそのメモリ量をギガバイト単位で返します。</span>この値は概数で、最も近い２の指数に切り下げ、1024で割った数字になります。また、とても低性能または高性能の端末を使用している人のプライバシーを守るため、上限値と下限値が使用されます。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>memoryAmount</em> = navigator.deviceMemory</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>浮動小数点値で <code>0.25</code>, <code>0.5</code>, <code>1</code>, <code>2</code>, <code>4</code>, <code>8</code> のうちのいずれかです。</p> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush: js">const memory = navigator.deviceMemory +console.log (`This device has at least ${memory}GiB of RAM.`) +</pre> + +<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("Device Memory","#sec-device-memory-js-api","deviceMemory")}}</td> + <td>{{Spec2("Device Memory")}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.deviceMemory")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/Device_Memory_API">Device Memory API</a></li> + <li>{{HTTPHeader("Device-Memory")}} HTTP header</li> +</ul> diff --git a/files/ja/web/api/navigator/donottrack/index.html b/files/ja/web/api/navigator/donottrack/index.html new file mode 100644 index 0000000000..2fc0bc80b4 --- /dev/null +++ b/files/ja/web/api/navigator/donottrack/index.html @@ -0,0 +1,54 @@ +--- +title: Navigator.doNotTrack +slug: Web/API/Navigator/doNotTrack +tags: + - API + - Experimental + - HTML DOM + - Navigator + - Property + - Reference +translation_of: Web/API/Navigator/doNotTrack +--- +<div>{{ApiRef("HTML DOM")}}</div> + +<p><strong><code>Navigator.doNotTrack</code></strong> プロパティは、ユーザーの Do Not Track 設定を返します。これは、ユーザーがウェブサイトと広告主に対して追跡しないよう要求しているかどうかを示します。</p> + +<p>プロパティの値は HTTP の {{httpheader("DNT")}} ヘッダーの値、つまり、 "<code>1</code>", "<code>0</code>", "<code>unspecified</code>" の値を返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="brush: js notranslate">console.log(navigator.doNotTrack); +// DNT が有効な場合は "1" です。追跡をオプトインした場合は "0" になります。それ以外は "unspecified" です。 +</pre> + +<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("Tracking", "#dom-navigator-donottrack", "Navigator.doNotTrack")}}</td> + <td>{{Spec2("Tracking")}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.doNotTrack")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/Security/Do_not_track_field_guide">Do Not Track フィールドガイド</a></li> +</ul> diff --git a/files/ja/web/api/navigator/geolocation/index.html b/files/ja/web/api/navigator/geolocation/index.html new file mode 100644 index 0000000000..bd7b4fcf43 --- /dev/null +++ b/files/ja/web/api/navigator/geolocation/index.html @@ -0,0 +1,55 @@ +--- +title: Navigator.geolocation +slug: Web/API/Navigator/geolocation +tags: + - API + - Geolocation API + - Navigator + - Property + - Reference + - Secure context +translation_of: Web/API/Navigator/geolocation +--- +<div>{{securecontext_header}}{{APIRef("Geolocation API")}}</div> + +<p><strong><code>Navigator.geolocation</code></strong> は読み取り専用のプロパティで、ウェブコンテンツが端末の位置情報にアクセスするための {{domxref("Geolocation")}} オブジェクトを返します。これにより、ウェブサイトやアプリがユーザーの現在の位置に応じた結果を提供できるようになります。</p> + +<div class="note"> +<p><strong>注:</strong> セキュリティ上の理由により、ウェブページが位置情報にアクセスしようとする時、ユーザーにアクセス許可が求められます。その方法やポリシーはブラウザーによって異なることに注意してください。</p> +</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>geo</var> = <var>navigator</var>.geolocation +</pre> + +<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('Geolocation', '#dom-navigator-geolocation', 'Navigator.geolocation')}}</td> + <td>{{Spec2('Geolocation')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.geolocation")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/Geolocation_API/Using_the_Geolocation_API">Geolocation API の使用</a></li> +</ul> diff --git a/files/ja/web/api/navigator/getbattery/index.html b/files/ja/web/api/navigator/getbattery/index.html new file mode 100644 index 0000000000..eb379249af --- /dev/null +++ b/files/ja/web/api/navigator/getbattery/index.html @@ -0,0 +1,92 @@ +--- +title: Navigator.getBattery() +slug: Web/API/Navigator/getBattery +tags: + - API + - Battery API + - Device API + - Method + - Navigator + - Reference + - getBattery + - メッセージ +translation_of: Web/API/Navigator/getBattery +--- +<div>{{ ApiRef("Battery API") }}{{deprecated_header}}</div> + +<p><strong><code>getBattery()</code></strong> メソッドは、システムのバッテリーに関する情報を提供します。これは {{domxref("BatteryManager")}} オブジェクトで解決されるバッテリーの promise を返し、バッテリーの状態を監視するために処理できるいくつかの新しいイベントを提供します。これは <a href="/ja/docs/WebAPI/Battery_Status" title="/ja/docs/WebAPI/Battery_Status">Battery Status API</a> を実装しています。詳細、API の使用ガイド、サンプルコードについては、そのドキュメントを参照してください。</p> + +<div class="blockIndicator note"> +<p><strong>メモ:</strong> ブラウザーによっては、この機能へのアクセスは {{HTTPHeader("Feature-Policy")}} の {{HTTPHeader("Feature-Policy/battery","battery")}} ディレクティブで制御されます。</p> +</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">var <em>batteryPromise</em> = navigator.getBattery();</pre> + +<h3 id="Return_value" name="Return_value">Return value</h3> + +<p>解決されると、バッテリーの状態に関する情報を取得するために使用できる {{DOMxRef("BatteryManager")}} オブジェクトを単一の引数として持つフルフィルメントハンドラーを呼び出す {{JSxRef("Promise")}} です。</p> + +<h2 id="Exceptions" name="Exceptions">例外</h2> + +<p>このメソッドは真の例外を発生させません。代わりに、返された promise を拒絶し、 {{domxref("DOMException")}} の中に <code>name</code> を次のうちの一つに設定します。</p> + +<dl> + <dt><code>SecurityError</code></dt> + <dd>ユーザーエージェントは安全でないコンテキストではバッテリー情報を公開しませんが、このメソッドが安全でないコンテキストから呼び出されました。<br> + <strong>メモ:</strong> 一部のユーザーエージェントの古いバージョンでは、安全でないコンテキストでこの機能の利用を許可していることがあります。</dd> + <dt><code>NotAllowedError</code></dt> + <dd><strong>メモ:</strong> 現在この例外を発生させるユーザーエージェントはありませんが、仕様書では以下のような動作が記述されています。<br> + この文書ではこの機能の使用が許可されていません。例えば、 {{HTTPHeader("Feature-Policy")}} {{HTTPHeader("Feature-Policy/battery", "battery")}} 機能を介して明示的に許可されてなかったり、制限されていたりした場合です。</dd> +</dl> + +<h2 id="Example" name="Example">例</h2> + +<p>この例では、バッテリーの現在の充電状態を取得し、充電状態が変化するたびに充電状態が記録されるように、 {{Event("chargingchange")}} イベントのハンドラーを確立します。</p> + +<pre class="brush: js">let batteryIsCharging = false; + +navigator.getBattery().then(function(battery) { + batteryIsCharging = battery.charging; + + battery.addEventListener('chargingchange', function() { + batteryIsCharging = battery.charging; + }); +});</pre> + +<p>Battery Status API をご覧ください。</p> + + + +<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("Battery API", "#dom-navigator-getbattery", "Navigator.getBattery()")}}</td> + <td>{{Spec2("Battery API")}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.getBattery")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/WebAPI/Battery_Status" title="/ja/docs/WebAPI/Battery_Status">Battery Status API</a></li> + <li><code>Feature-Policy</code> の {{HTTPHeader("Feature-Policy/battery", "battery")}} 機能</li> +</ul> diff --git a/files/ja/web/api/navigator/getgamepads/index.html b/files/ja/web/api/navigator/getgamepads/index.html new file mode 100644 index 0000000000..ababd187bf --- /dev/null +++ b/files/ja/web/api/navigator/getgamepads/index.html @@ -0,0 +1,59 @@ +--- +title: Navigator.getGamepads() +slug: Web/API/Navigator/getGamepads +tags: + - API + - Experimental + - Gamepad API + - Games + - Method + - Navigator + - Reference +translation_of: Web/API/Navigator/getGamepads +--- +<p>{{APIRef("Gamepad API")}}{{SeeCompatTable}}</p> + +<p><strong><code>Navigator.getGamepads()</code></strong> <span class="tlid-translation translation"><span title="">メソッドは配列を返します。最初の値は </span></span><code>null</code><span class="tlid-translation translation"><span title=""> であり、その他はすべて </span></span>{{ domxref("Gamepad") }}<span class="tlid-translation translation"><span title=""> オブジェクトで、デバイスに接続されている各ゲームパッドのオブジェクトです。</span> <span title="">したがって、ゲームパッドが接続されていない場合、メソッドは </span></span><code>null</code><span class="tlid-translation translation"><span title=""> を返します。</span></span></p> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox"> var arrayGP = navigator.getGamepads();</pre> + +<h2 id="例">例</h2> + +<pre class="brush: js">window.addEventListener("gamepadconnected", function(e) { + var gp = navigator.getGamepads()[e.gamepad.index]; + console.log("Gamepad connected at index %d: %s. %d buttons, %d axes.", + gp.index, gp.id, + gp.buttons.length, gp.axes.length); +});</pre> + +<h2 id="仕様">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('Gamepad', '', 'The Gamepad API specification')}}</td> + <td>{{Spec2('Gamepad')}}</td> + <td>初版</td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザの互換性">ブラウザの互換性</h2> + + + +<p>{{Compat("api.Navigator.getGamepads")}}</p> + +<h2 id="参照">参照</h2> + +<ul> + <li><a href="/docs/Web/Guide/API/Gamepad">Gamepad API の利用</a></li> + <li><a href="/docs/Web/API/Gamepad_API">Gamepad API</a></li> +</ul> diff --git a/files/ja/web/api/navigator/getusermedia/index.html b/files/ja/web/api/navigator/getusermedia/index.html new file mode 100644 index 0000000000..1ec059319d --- /dev/null +++ b/files/ja/web/api/navigator/getusermedia/index.html @@ -0,0 +1,118 @@ +--- +title: Navigator.getUserMedia() +slug: Web/API/Navigator/getUserMedia +tags: + - API + - Deprecated + - Media + - Media Capture and Streams API + - Media Streams API + - Method + - Navigator + - Reference + - WebRTC + - getusermedia +translation_of: Web/API/Navigator/getUserMedia +--- +<div>{{APIRef("Media Capture and Streams")}}{{deprecated_header}}</div> + +<p><code><strong>Navigator.getUserMedia()</strong></code> メソッドは、最大1系統の動画入力機器 (カメラや共有画面など) および最大1系統の音声入力機器 (マイクなど) を {{domxref("MediaStream")}} のソースとして使用する許可をユーザーに求めます。</p> + +<p>許可が与えられた場合、それらの機器から動画や音声のトラックを持つ <code>MediaStream</code> が、指定された成功コールバックに配信されます。許可が拒否された場合や、互換性のある入力機器が存在しない場合、その他のエラー条件が発生した場合は、何が問題となったかを説明する {{domxref("MediaStreamError")}} オブジェクトを伴ってエラーコールバックが実行されます。ユーザーがまったく選択をしなかった場合は、どちらのコールバックも実行されません。</p> + +<div class="note"> +<p>これは古いメソッドです。代わりに新しい {{domxref("MediaDevices.getUserMedia", "navigator.mediaDevices.getUserMedia()")}} を使用してください。技術的には非推奨ではありませんが、この古いコールバックのバージョンはそのようにマークされています。</p> +</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">navigator.getUserMedia(<var>constraints</var>, <var>successCallback</var>, <var>errorCallback</var>);</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>constraints</var></code></dt> + <dd>要求するメディアの形式を指定する {{domxref("MediaStreamConstraints")}} オブジェクト。詳細は、現在の {{domxref("MediaDevices.getUserMedia()")}} メソッド下の <a href="/ja/docs/Web/API/MediaDevices/getUserMedia#Parameters">constraints</a> セクションと、<a href="/ja/docs/Web/API/Media_Streams_API/Constraints">能力と制約と設定</a>を参照してください。</dd> + <dt><code><var>successCallback</var></code></dt> + <dd>メディアアクセスの要求が承認されたときに呼び出される関数です。この関数は、メディアストリームを含む {{domxref("MediaStream")}} オブジェクトの単一の引数で呼び出されます。コールバックは、次の例のようにストリームを任意のオブジェクト ({{HTMLElement("audio")}} や {{HTMLElement("video")}} 要素など) に割り当てることができます。 + <pre class="brush: js notranslate">function(stream) { + var video = document.querySelector('video'); + video.srcObject = stream; + video.onloadedmetadata = function(e) { + // Do something with the video here. + }; +}</pre> + </dd> + <dt><code><var>errorCallback</var></code></dt> + <dd>呼び出しが失敗した場合、<code>errorCallback</code> で指定され、{{domxref("MediaStreamError")}} が唯一の引数に与えられた関数が呼び出されますこのオブジェクトは、{{domxref("DOMException")}} をひな形としています。エラーコードは以下のとおり:</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>{{domxref("undefined")}}.</p> + +<h3 id="Errors" name="Errors">エラー</h3> + +<p>{{page("/ja/docs/Web/API/MediaDevices/getUserMedia", "Errors")}}</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Width_and_height" name="Width_and_height">幅と高さ</h3> + +<p>これは、様々のブラウザの接頭辞に対処したコードを含む、<code>getUserMedia()</code> の使用例です。ただし、これは非推奨の使用方法なので注意してください。現在の API の使用例は、{{domxref("MediaDevices.getUserMedia()")}} 下の <a href="/ja/docs/Web/API/MediaDevices/getUserMedia#Frame_rate">例</a> セクションを参照してください。</p> + +<pre class="brush: js notranslate">navigator.getUserMedia = navigator.getUserMedia || + navigator.webkitGetUserMedia || + navigator.mozGetUserMedia; + +if (navigator.getUserMedia) { + navigator.getUserMedia({ audio: true, video: { width: 1280, height: 720 } }, + function(stream) { + var video = document.querySelector('video'); + video.srcObject = stream; + video.onloadedmetadata = function(e) { + video.play(); + }; + }, + function(err) { + console.log("The following error occurred: " + err.name); + } + ); +} else { + console.log("getUserMedia not supported"); +} +</pre> + +<h2 id="Permissions" name="Permissions">許可設定</h2> + +<p>インストール可能アプリ (例えば <a href="/ja/Apps/Build/Building_apps_for_Firefox_OS/Firefox_OS_app_beginners_tutorial">Firefox OS アプリ</a>) で <code>getUserMedia()</code> を使用するには、次のどちらか、または両方の項目をマニフェストファイルに記述する必要があります:</p> + +<pre class="brush: js notranslate">"permissions": { + "audio-capture": { + "description": "Required to capture audio using getUserMedia()" + }, + "video-capture": { + "description": "Required to capture video using getUserMedia()" + } +}</pre> + +<p>詳しい情報は、<a href="/ja/Apps/Developing/App_permissions#audio-capture">permission: audio-capture</a> および <a href="/ja/Apps/Developing/App_permissions#video-capture">permission: video-capture</a> を参照してください。</p> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="warning"> +<p>新しいコードでは代わりに {{domxref("Navigator.mediaDevices.getUserMedia()")}} を使用してください。</p> +</div> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.getUserMedia")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>この非推奨のメソッドに代わる {{domxref("MediaDevices.getUserMedia()")}}。</li> + <li><a href="/ja/docs/WebRTC">WebRTC</a> - この API の前置きページ。</li> + <li><a href="/ja/docs/WebRTC/MediaStream_API">MediaStream API</a> - メディアストリームオブジェクト向けの API。</li> + <li><a href="/ja/docs/WebRTC/taking_webcam_photos">Taking webcam photos</a> - <code>getUserMedia()</code> を使って、動画ではなく写真を撮るためのチュートリアル。</li> +</ul> diff --git a/files/ja/web/api/navigator/getvrdisplays/index.html b/files/ja/web/api/navigator/getvrdisplays/index.html new file mode 100644 index 0000000000..7c4e56bb9d --- /dev/null +++ b/files/ja/web/api/navigator/getvrdisplays/index.html @@ -0,0 +1,68 @@ +--- +title: Navigator.getVRDisplays() +slug: Web/API/Navigator/getVRDisplays +tags: + - API + - Experimental + - HTML DOM + - Media + - Method + - Navigator + - Reference + - VR + - Virtual Reality + - WebVR + - getVRDisplays() +translation_of: Web/API/Navigator/getVRDisplays +--- +<div>{{DefaultAPISidebar("WebVR API")}}{{Obsolete_header}}</div> + +<p><strong><code>getVRDisplays()</code></strong> は {{domxref("Navigator")}} インターフェイスのメソッドで、コンピューターに接続されている利用可能な VR 機器を表す {{domxref("VRDisplay")}} オブジェクトの配列へ解決するためのプロミスを返します．</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">navigator.getVRDisplays().then(function(displays) { + // 利用可能な VR display で何かする +});</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<p>なし。</p> + +<h3 id="Return_values" name="Return_values">返値</h3> + +<p>{{domxref("VRDisplay")}} オブジェクトの配列へ解決するためのプロミスです。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<p>{{page("/Web/API/VRDisplay", "Examples")}}</p> + +<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("WebVR 1.1", '#navigator-getvrdisplays-attribute', 'getVRDisplays()')}}</td> + <td>{{Spec2("WebVR 1.1")}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<p>{{Compat("api.Navigator.getVRDisplays")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/WebVR_API">WebVR API ホームページ</a></li> + <li><a href="http://mozvr.com/">MozVr.com</a> — Mozilla VRチームのデモ，ダウンロード，その他のリソース．</li> +</ul> diff --git a/files/ja/web/api/navigator/id/index.html b/files/ja/web/api/navigator/id/index.html new file mode 100644 index 0000000000..375c08c5de --- /dev/null +++ b/files/ja/web/api/navigator/id/index.html @@ -0,0 +1,52 @@ +--- +title: navigator.id +slug: Web/API/Navigator/id +tags: + - BrowserID + - DOM + - Gecko DOM Reference + - Persona + - Security +translation_of: Archive/Navigator-id +--- +<div> + {{ ApiRef() }} {{ non-standard_header() }}</div> +<div class="note"> + <strong>注記:</strong> この機能は、まだどのブラウザでもサポートされていません。Persona を使用する Web サイトは、そのページに <a class="link-https" href="https://login.persona.org/include.js" title="https://login.persona.org/include.js">https://login.persona.org/include.js</a> でホストされているポリフィルライブラリを含めなければなりません。</div> +<h2 id="Summary" name="Summary">要約</h2> +<p><a href="/docs/Persona" title="Persona">BrowserID プロトコル</a> は、BrowserID API を開示する {{ domxref ("window.navigator")}} オブジェクトに新しい <code>id</code> プロパティを定義しています。この API はいくつかの重要なリビジョンを経ています。各世代別の API は以下の通りです。</p> +<h2 id="ObserverMethods" name="ObserverMethods">"Observer" API (現在)</h2> +<p>Observer API は、初めて利用したユーザに対する検証後の振る舞いの改善、自動的なログインの持続、ネイティブアプリケーションへの簡単な統合など、多くのリクエストがあった機能を導入しています。</p> +<dl> + <dt> + {{ domxref("navigator.id.watch()")}}</dt> + <dd> + ユーザが Web サイトにログインまたはログアウトした時に呼び出されるコールバックを登録します。</dd> + <dt> + {{ domxref("navigator.id.request()")}}</dt> + <dd> + ユーザからの署名付き ID アサーションを要求します。</dd> + <dt> + {{ domxref("navigator.id.logout()")}}</dt> + <dd> + ユーザを Web サイトからログアウトし、次回そのユーザが Web サイトを訪れた時に自動的に <code>onlogin</code> が実行されることを防ぎます。</dd> +</dl> +<div class="note"> + <p>ユーザがサードパーティーのクッキーを無効にしている場合、Observer API を使用してのログイン時に問題が発生する可能性があります（※参照: <a href="https://github.com/mozilla/browserid/issues/2999" title="https://github.com/mozilla/browserid/issues/2999">onlogout called immediately after onlogin if 3rd party cookies are disabled · Issue #2999 · mozilla/browserid</a> ）</p> +</div> +<h2 id="CallbackMethods" name="CallbackMethods">"Callback" API (現在)</h2> +<p>Callback API は、2011 年 11 月に導入されました。この API は、<code>navigator.id.get()</code> にオプションが渡されることを許可し、BrowserID が管理する持続的なセッションの実験的なサポートを提供して初期の API を改善するためのものです。</p> +<dl> + <dt> + {{ domxref("navigator.id.get()")}}</dt> + <dd> + ユーザの署名付きアサーション内の BrowserID を取得します。</dd> +</dl> +<h2 id="VerifiedEmailMethods" name="VerifiedEmailMethods">"VerifiedEmail" API (非推奨)</h2> +<p>VerifiedEmail API は、BrowserID の最初の API でした。この API は、2011 年末に非推奨になりました。</p> +<dl> + <dt> + {{ domxref("navigator.id.getVerifiedEmail()")}} {{ deprecated_inline() }}</dt> + <dd> + ユーザの署名付きアサーション内の BrowserID を取得します。このメソッドは非推奨です。代わりに、後方互換性を持つ {{ domxref("navigator.id.get()")}} を使用してください。</dd> +</dl> diff --git a/files/ja/web/api/navigator/index.html b/files/ja/web/api/navigator/index.html new file mode 100644 index 0000000000..12d424434a --- /dev/null +++ b/files/ja/web/api/navigator/index.html @@ -0,0 +1,178 @@ +--- +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 class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("api.Navigator")}}</div> diff --git a/files/ja/web/api/navigator/keyboard/index.html b/files/ja/web/api/navigator/keyboard/index.html new file mode 100644 index 0000000000..ae173b1ab7 --- /dev/null +++ b/files/ja/web/api/navigator/keyboard/index.html @@ -0,0 +1,51 @@ +--- +title: Navigator.keyboard +slug: Web/API/Navigator/keyboard +tags: + - API + - Experimental + - Keyboard API + - Keyboard Map + - Navigator + - Property + - Reference + - keyboard + - プロパティ +translation_of: Web/API/Navigator/keyboard +--- +<div>{{SeeCompatTable}}{{APIRef("Keyboard API")}}</div> + +<p><span class="seoSummary"><strong><code>keyboard</code></strong> は {{domxref("Navigator")}} インターフェイスの読み取り専用プロパティで、物理キーボードのキーボードレイアウトマップを受け取ったり、キー押下のキャプチャの切り替えたりするための {{domxref('Keyboard')}} オブジェクトを返します。</span></p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">var <var>keyboard</var> = navigator.keyboard</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref('Keyboard')}} オブジェクト。</p> + +<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('Keyboard Map','#navigator-interface','keyboard')}}</td> + <td>{{Spec2('Keyboard Map')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.navigator.keyboard")}}</p> diff --git a/files/ja/web/api/navigator/locks/index.html b/files/ja/web/api/navigator/locks/index.html new file mode 100644 index 0000000000..8197eaaec3 --- /dev/null +++ b/files/ja/web/api/navigator/locks/index.html @@ -0,0 +1,47 @@ +--- +title: Navigator.locks +slug: Web/API/Navigator/locks +tags: + - API + - Experimental + - LockManager + - Property + - Reference + - Web Locks API + - locks +translation_of: Web/API/Navigator/locks +--- +<p>{{SeeCompatTable}}{{APIRef("Web Locks")}}</p> + +<p><span class="seoSummary">{{domxref("Navigator")}} インターフェイスの <strong><code>locks</code></strong> 読み取り専用プロパティは、新しい{{domxref('Lock')}} オブジェクトを要求するためのメソッドを提供する {{domxref("LockManager")}} オブジェクトを返します。既存の <code>Lock</code> オブジェクトを照会します。</span></p> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox notranslate">var <var>lockManager</var> = Navigator.locks</pre> + +<h3 id="値">値</h3> + +<p>{{domxref("LockManager")}} オブジェクト。</p> + +<h2 id="仕様">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">ステータス</th> + <th scope="col">備考</th> + </tr> + <tr> + <td>{{SpecName('Web Locks','#navigator-mixins','locks')}}</td> + <td>{{Spec2('Web Locks')}}</td> + <td>初回定義。</td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザー実装状況">ブラウザー実装状況</h2> + + + +<p>{{Compat("api.Navigator.locks")}}</p> diff --git a/files/ja/web/api/navigator/maxtouchpoints/index.html b/files/ja/web/api/navigator/maxtouchpoints/index.html new file mode 100644 index 0000000000..55418aaed1 --- /dev/null +++ b/files/ja/web/api/navigator/maxtouchpoints/index.html @@ -0,0 +1,58 @@ +--- +title: Navigator.maxTouchPoints +slug: Web/API/Navigator/maxTouchPoints +tags: + - API + - DOM + - Navigator + - Property + - Reference + - maxTouchPoints + - ポインターイベント +translation_of: Web/API/Navigator/maxTouchPoints +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p>{{domxref("Navigator")}} インターフェイスの <strong><code>maxTouchPoints</code></strong> プロパティは読み取り専用で、現在の端末で対応している同時タッチコンタクト点の最大数を返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><var>touchPoints</var> = <var>navigator</var>.maxTouchPoints; +</pre> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush: js">if (navigator.maxTouchPoints > 1) { + // ブラウザーがマルチタッチに対応 +} +</pre> + +<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('Pointer Events 2','#extensions-to-the-navigator-interface', 'maxTouchPoints')}}</td> + <td>{{Spec2('Pointer Events 2')}}</td> + <td>非安定バージョン。</td> + </tr> + <tr> + <td>{{SpecName('Pointer Events', '#extensions-to-the-navigator-interface', 'maxTouchPoints')}}</td> + <td>{{Spec2('Pointer Events')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("api.Navigator.maxTouchPoints")}}</div> diff --git a/files/ja/web/api/navigator/mediacapabilities/index.html b/files/ja/web/api/navigator/mediacapabilities/index.html new file mode 100644 index 0000000000..f2a8b7b740 --- /dev/null +++ b/files/ja/web/api/navigator/mediacapabilities/index.html @@ -0,0 +1,76 @@ +--- +title: Navigator.mediaCapabilities +slug: Web/API/Navigator/mediaCapabilities +tags: + - API + - Experimental + - MediaCapabilities + - Navigator + - メディア + - メディア能力 API +translation_of: Web/API/Navigator/mediaCapabilities +--- +<p>{{SeeCompatTable}}</p> + +<p><code><strong>Navigator.mediaCapabilities</strong></code> プロパティは読み取り専用で、 <a href="/ja/docs/Web/API/Media_Capabilities_API">Media Capabilities API</a> で定義されているように、指定された形式のエンコードとデコードおよび出力能力についての情報を取得することができる {{domxref("MediaCapabilities")}} オブジェクトを返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>mediaCapabilitiesObj</em> = <em>globalObj</em>.navigator.mediaCapabilities +</pre> + +<h2 id="Value" name="Value">値</h2> + +<p>{{domxref("MediaCapabilities")}} オブジェクト。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">navigator.mediaCapabilities.decodingInfo({ + type : 'file', + audio : { + contentType : "audio/mp3", + channels : 2, + bitrate : 132700, + samplerate : 5200 + } +}).then(function(result) { + console.log('This configuration is ' + + (result.supported ? '' : 'not ') + 'supported, ' + + (result.smooth ? '' : 'not ') + 'smooth, and ' + + (result.powerEfficient ? '' : 'not ') + 'power efficient.') +}); +</pre> + +<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('Media Capabilities')}}</td> + <td>{{Spec2('Media Capabilities')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_Compatibility" name="Browser_Compatibility">ブラウザーの対応</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.Navigator.mediaCapabilities")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/Media_Capabilities_API">Media Capabilities API</a></li> + <li>{{domxref("Navigator")}}</li> +</ul> + +<p>{{APIRef("HTML DOM")}}</p> diff --git a/files/ja/web/api/navigator/mediadevices/index.html b/files/ja/web/api/navigator/mediadevices/index.html new file mode 100644 index 0000000000..cd6d6c4dc4 --- /dev/null +++ b/files/ja/web/api/navigator/mediadevices/index.html @@ -0,0 +1,59 @@ +--- +title: Navigator.mediaDevices +slug: Web/API/Navigator/mediaDevices +tags: + - Media + - Media Capture and Streams API + - Media Streams API + - MediaDevices + - Navigator + - Property + - Read-only + - Reference + - Web +translation_of: Web/API/Navigator/mediaDevices +--- +<div>{{APIRef("Media Capture and Streams")}}</div> + +<p><strong><code>Navigator.mediaDevices</code></strong> 読み取り専用プロパティは、カメラやマイク、画面共有のような接続されたメディア入力装置へのアクセスを提供する {{domxref("MediaDevices")}} オブジェクトを返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">var <em>mediaDevices</em> = navigator.mediaDevices; +</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>{{domxref("MediaDevices")}} シングルトンオブジェクト。例えば {{domxref("navigator.mediaDevices.getUserMedia()")}} などを呼び出すなど、通常は、このオブジェクトのメンバーを直接使用するだけです。</p> + +<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('Media Capture', '#mediadevices', 'NavigatorUserMedia.mediaDevices')}}</td> + <td>{{Spec2('Media Capture')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.mediaDevices")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/Media_Streams_API">Media Capture and Streams API</a>: すべての media stream API についてのドキュメントのエントリーポイント。</li> + <li><a href="/ja/docs/Web/API/WebRTC_API">WebRTC API</a>: 密接に関連する WebRTC API についてのドキュメント。</li> +</ul> diff --git a/files/ja/web/api/navigator/mozcameras/index.html b/files/ja/web/api/navigator/mozcameras/index.html new file mode 100644 index 0000000000..2b67cbfe87 --- /dev/null +++ b/files/ja/web/api/navigator/mozcameras/index.html @@ -0,0 +1,52 @@ +--- +title: Navigator.mozCameras +slug: Web/API/Navigator/mozCameras +tags: + - API + - DOM + - Firefox OS + - Gecko DOM Reference + - Graphics + - Non Standard + - Property + - WebAPI +translation_of: Archive/B2G_OS/API/Navigator/mozCameras +--- +<p>{{APIRef("Firefox OS")}}</p> + +<p>{{ non-standard_header() }}</p> + +<p>{{B2GOnlyHeader2('privileged')}}</p> + +<h2 id="Summary" name="Summary">概要</h2> + +<p>ユーザの端末で利用可能なカメラへのアクセスに用いる {{domxref("CameraManager")}} オブジェクトを返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="eval">var cameraManager = window.navigator.mozCameras; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p><code>navigator.mozCameras</code> は、端末で利用可能なカメラへのアクセスに用いる {{domxref("CameraManager")}} オブジェクトです。</p> + +<h2 id="Specification" name="Specification">仕様</h2> + +<p>標準仕様には含まれていません。WebRTC がモバイル端末で広くサポートされるようになった時、これと置き換えられる予定です。</p> + +<h2 id="Permissions" name="Permissions">許可設定</h2> + +<p>Firefox OS 1.4 まで、Camera API は Certified API だったためサードパーティアプリからはアクセスできませんでした。Firefox OS 2.0 からは許可レベルが Privileged に下げられたため、開発者が独自のアプリで利用できるようになりました。</p> + +<pre class="brush: json">"permissions": { + "camera": { + "description": "Required for accessing cameras on the device." + } +}</pre> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/docs/WebRTC" title="/docs/WebRTC">WebRTC API</a></li> +</ul> diff --git a/files/ja/web/api/navigator/mozfmradio/index.html b/files/ja/web/api/navigator/mozfmradio/index.html new file mode 100644 index 0000000000..271629e8d7 --- /dev/null +++ b/files/ja/web/api/navigator/mozfmradio/index.html @@ -0,0 +1,36 @@ +--- +title: Navigator.mozFMRadio +slug: Web/API/Navigator/mozFMRadio +tags: + - API + - Non-standard + - Property +translation_of: Archive/B2G_OS/API/Navigator/mozFMRadio +--- +<p>{{APIRef}}{{ non-standard_header() }}</p> + +<p>{{ B2GOnlyHeader2('installed') }}</p> + +<h2 id="Summary" name="Summary">概要</h2> + +<p>端末の FM ラジオへのアクセスに使用できる {{ domxref("FMRadio") }} オブジェクトを返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="eval">var WebFM = navigator.mozFMRadio; +</pre> + +<h2 id="Value" name="Value">値</h2> + +<p><code>navigator.mozFMRadio</code> は {{domxref("FMRadio")}} オブジェクトです。</p> + +<h2 id="Specification" name="Specification">仕様書</h2> + +<p>仕様の一部ではありません。</p> + +<h2 id="参照">参照</h2> + +<ul> + <li>{{domxref("FMRadio")}}</li> + <li><a href="/docs/WebAPI/WebFM_API" title="/docs/WebAPI/WebFM_API">WebFM API</a></li> +</ul> diff --git a/files/ja/web/api/navigator/mozislocallyavailable/index.html b/files/ja/web/api/navigator/mozislocallyavailable/index.html new file mode 100644 index 0000000000..78c3efa6db --- /dev/null +++ b/files/ja/web/api/navigator/mozislocallyavailable/index.html @@ -0,0 +1,54 @@ +--- +title: Navigator.mozIsLocallyAvailable() +slug: Web/API/Navigator/mozIsLocallyAvailable +tags: + - API + - Mozilla 拡張 + - Navigator + - Non-standard + - Obsolete + - mozIsLocallyAvailable + - メソッド +translation_of: Web/API/Navigator/mozIsLocallyAvailable +--- +<div>{{APIRef("HTML DOM")}}{{non-standard_header}}{{obsolete_header}}</div> + +<p><strong><code>Navigator.mozIsLocallyAvailable()</code></strong> メソッドは、アドオンが指定されたリソースが両可能かどうかを判断できるようにします。</p> + +<p>{{Note("リクエストされた URI が同じオリジンでないと、セキュリティ例外が発生することがあります。")}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">navigator.mozIsLocallyAvailable(<em>uri</em>, <em>ifOffline</em>); +</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code>uri</code></dt> + <dd>閲覧可能かどうかチェックするリソースの URI を表す文字列です。</dd> + <dt><code>ifOffline</code></dt> + <dd> + <p>オフラインリソースのキャッシュをチェックをするべきかどうかを指定します。オフラインリソースのキャッシュを考慮する場合は、<code>true</code> を指定します。</p> + </dd> +</dl> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush: js">var available = navigator.mozIsLocallyAvailable("my-image-file.png", true); +if (available) { + /* オフラインリソースが存在 */ +} else { + alert("必要なリソースは、ネットワークに接続するまで閲覧不可能です。"); +} +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<p>どの仕様書でも定義されていません。</p> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.Navigator.mozIsLocallyAvailable")}}</p> diff --git a/files/ja/web/api/navigator/mozpay/index.html b/files/ja/web/api/navigator/mozpay/index.html new file mode 100644 index 0000000000..5226b8eb62 --- /dev/null +++ b/files/ja/web/api/navigator/mozpay/index.html @@ -0,0 +1,101 @@ +--- +title: Navigator.mozPay() +slug: Web/API/Navigator/mozPay +tags: + - API + - Apps + - B2G + - Firefox OS + - Method + - Non Standard + - Web Payment + - WebAPI +translation_of: Archive/Marketplace/API/Navigator/mozPay +--- +<p>{{ non-standard_header() }}</p> +<p>{{ B2GOnlyHeader2('installed') }}</p> +<h2 id="Summary" name="Summary">概要</h2> +<p><code>mozPay</code> 関数は決済の実行に使用され、アプリ内課金を実現します。</p> +<h2 id="Syntax" name="Syntax">構文</h2> +<pre class="eval">var request = navigator.mozPay(jwts); +</pre> +<dl> + <dt> + jwts</dt> + <dd> + <a href="http://openid.net/specs/draft-jones-json-web-token-07.html">JSON Web トークン</a> の配列。</dd> +</dl> +<div class="warning"> + <p><strong>警告:</strong> 署名は <a href="/ja/docs/Web/Apps/Publishing/In-app_payments">アプリケーション秘密鍵</a> に由来することから、JSON Web トークンへの署名は必ずサーバサイドで行う必要があります。権限のないユーザがアプリケーション秘密鍵へアクセスすることのないよう注意してください。</p> +</div> +<h2 id="Return" name="Return">戻り値</h2> +<p>{{domxref("DOMRequest")}} オブジェクト。</p> +<h2 id="Example" name="Example">例</h2> +<pre class="brush: js">// 購入を開始します。具体的にはこれを「購入」ボタン上のクリックハンドラに設定します。 +purchaseSomething("A nice unicorn"); + +function purchaseSomething(productID) { + var xhr = new XMLHttpRequest(); + xhr.responseType = 'json'; + + // productID をサーバへ送信し、 + // JWT の配列を受け取る準備をします。 + xhr.open('POST', '/create_jwts'); + + xhr.addEventListener('load', function () { + // JSON レスポンスから JWT と transactionID を受け取ります。これは以下のような形式です。 + // {"jwts": ["jwt1...", "jwt2..."], "transactionID": "1234"} + var jwts = xhr.response.jwts; + var transactionID = xhr.response.transactionID; + + // JSON Web トークンを決済プロバイダに渡します。 + var request = navigator.mozPay(jwts); + + // 決済ウィンドウのために成功・失敗ハンドラを用意します。 + request.onsuccess = function () { + console.log('ユーザの決済フローが正常に完了しました'); + // 決済フローは完了しましたが、決済が成立したことを確認するため、 + // サーバへポーリングを行って検証された決済結果を待ちます。 + waitForPaymentResult(transactionID); + }; + request.onerror = function () { + console.log('申し訳ありませんが、決済フローにエラーが発生しました: ', this.error.name); + }; + }) + + // 情報を送信して決済リクエストを開始し、 + // 署名済み JSON Web トークンを受け取ります。 + // この例では、productID はユーザが購入したい商品の ID です。 + xhr.send(productID); +} + +function waitForPaymentResult(transactionID) { + var xhr = new XMLHttpRequest(); + xhr.responseType = 'json'; + + // transactionID のためにポストバック・チャージバックを受信したことを確認する準備をします。 + xhr.open('GET', '/payment_result/' + transactionID); + + xhr.addEventListener('load', function () { + // 以下のような結果を取得します。 + // {"result": "postback received"} or {"result": "still waiting"} + if (xhr.response.result == 'postback received') { + // ポストバック通知を受信し、そこに含まれる JWT 署名を検証しました。 + console.log('成功！ 商品は購入されました'); + } else { + // ポストバック・チャージバックがまだサーバへ送信されていません。3 秒後に再試行します。 + window.setTimeout(function() { waitForPaymentResult(transactionID); }, 3000); + } + }); + + // リクエストを送信し transactionID のステータスを確認します。 + xhr.send(); +}</pre> +<h2 id="Specification" name="Specification">仕様</h2> +<p>どの仕様書にも含まれていません。ただしこの話題は W3C の <a href="http://www.w3.org/community/webpayments/">Web Payment Community Group</a> において盛んに議論されています。</p> +<h2 id="See_also" name="See_also">関連記事</h2> +<ul> + <li><a href="/ja/docs/Web/Apps/Publishing/In-app_payments">アプリ内課金</a></li> + <li>Mozilla <a href="https://wiki.mozilla.org/WebAPI/WebPayment">Web Payment 仕様全文</a> (Mozilla Wiki)</li> + <li>{{domxref("DOMRequest")}}</li> +</ul> diff --git a/files/ja/web/api/navigator/mozsettings/index.html b/files/ja/web/api/navigator/mozsettings/index.html new file mode 100644 index 0000000000..fb06aa962c --- /dev/null +++ b/files/ja/web/api/navigator/mozsettings/index.html @@ -0,0 +1,32 @@ +--- +title: window.navigator.mozSettings +slug: Web/API/Navigator/mozSettings +tags: + - B2G + - Firefox OS + - Non Standard + - WebAPI +translation_of: Archive/B2G_OS/API/Navigator/mozSettings +--- +<div>{{non-standard_header}}{{B2GOnlyHeader2("certified")}}</div> + + +<h2 id="Summary" name="Summary">概要</h2> +<p>デバイス設定へのアクセス及びデバイス設定の変更のための {{domxref("SettingsManager")}} オブジェクトを返します。</p> + + + +<h2 id="Syntax" name="Syntax">構文</h2> +<pre class="syntaxbox"><var>settings</var> = window.navigator.mozSettings; +</pre> + + +<h2 id="Specification" name="Specification">仕様</h2> +<p>この API はまだ標準仕様に含まれるものではありませんが、現在、 W3C の <a href="http://www.w3.org/2012/sysapps/" rel="external">System Applications Working Group</a> で議論されています。</p> + + +<h2 id="See_also" name="See_also">関連情報</h2> +<ul> + <li>{{domxref("SettingsManager")}}</li> + <li>{{domxref("SettingsLock")}}</li> +</ul> diff --git a/files/ja/web/api/navigator/mozsms/index.html b/files/ja/web/api/navigator/mozsms/index.html new file mode 100644 index 0000000000..defb9326b5 --- /dev/null +++ b/files/ja/web/api/navigator/mozsms/index.html @@ -0,0 +1,53 @@ +--- +title: window.navigator.mozSms +slug: Web/API/Navigator/mozSms +tags: + - DOM + - Gecko DOM Reference + - Mobile + - WebSMS +translation_of: Archive/B2G_OS/API/Navigator/mozSms +--- +<div> + {{ApiRef}}{{non-standard_header}}</div> +<h2 id="Summary" name="Summary">概要</h2> +<p>SMS メッセージの送受信に用いることが出来る {{domxref("SmsManager")}} オブジェクトを返します。</p> +<h2 id="Syntax" name="Syntax">構文</h2> +<pre class="syntaxbox">var sms = window.navigator.mozSms; +</pre> +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2> +<p>主にモバイルブラウザでのサポートが期待されます。</p> +<table class="compat-table"> + <tbody> + <tr> + <th>機能</th> + <th>Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>基本サポート</td> + <td>{{CompatNo}}</td> + <td>{{CompatGeckoMobile("12.0")}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + </tr> + </tbody> +</table> +<h2 id="Preferences_.26_availability" name="Preferences_.26_availability">設定 / 可用性</h2> +<ul> + <li>WebSMS はデフォルトで無効となっており、 <code>dom.sms.enabled</code> を true とする事で有効にする事が出来ます。</li> + <li>WebSMS API の使用を許可するホスト名のカンマ区切りのホワイトリストは、 <code>dom.sms.whitelist</code> 設定を使用して指定しなければなりません。デフォルトでは空文字となっています。</li> + <li>WebSMS は、Firefox OS (B2G) に認定されたアプリでのみ利用できます。</li> +</ul> +<h2 id="Specification" name="Specification">仕様書</h2> +<p>標準仕様には含まれていません。ただし、<a class="link-https" href="https://wiki.mozilla.org/WebAPI/WebSMS" title="https://wiki.mozilla.org/WebAPI/WebSMS">WebSMS design document</a> に基づく提案が予定されています。</p> +<h2 id="See_also" name="See_also">関連情報</h2> +<ul> + <li><a href="/ja/docs/API/WebSMS" title="API/WebSMS">WebSMS API</a></li> + <li>{{domxref("SmsManager")}}</li> + <li>{{domxref("window.navigator.mozTelephony")}} - 電話の呼び出しの制御</li> +</ul> diff --git a/files/ja/web/api/navigator/mozsocial/index.html b/files/ja/web/api/navigator/mozsocial/index.html new file mode 100644 index 0000000000..b5e28e701f --- /dev/null +++ b/files/ja/web/api/navigator/mozsocial/index.html @@ -0,0 +1,49 @@ +--- +title: navigator.mozSocial +slug: Web/API/Navigator/mozSocial +tags: + - DOM + - Gecko DOM Reference + - Social +translation_of: Archive/mozSocial +--- +<div> + {{ApiRef}}{{non-standard_header}}{{fx_minversion_header("17.0")}}</div> +<p><code>navigator.mozSocial</code> プロパティによって返される <code>MozSocial</code> オブジェクトは、ソーシャルメディアプロバイダーパネル内で利用することができます。ソーシャルメディアプロバイダーパネルが必要とする機能を提供します。</p> +<div class="note"> + <p><strong>注記:</strong> Mozilla は最終的に標準化のためにこの API の提出を予定していますが、まだ実行には至っていません。</p> +</div> +<h2 id="Attributes" name="Attributes">属性</h2> +<dl> + <dt> + {{domxref("MozSocial.isVisible")}}</dt> + <dd> + 真偽値を返す。コンテンツが表示されている場合は <code>true</code> を、表示されていない場合は <code>false</code> を返す。</dd> +</dl> +<h2 id="Methods" name="Methods">メソッド</h2> +<dl> + <dt> + {{domxref("MozSocial.closePanel()")}}</dt> + <dd> + 現在開いているフライアウトパネルを閉じます。</dd> + <dt> + {{domxref("MozSocial.getAttention()")}}</dt> + <dd> + ユーザの注意を引くために設計されたいくつかのアクションを実行します。実際の動作はプラットフォームによって異なる場合があり、ヴィジュアル効果、音声通知、画面の点滅、または他のいくつかの技術が用いられる場合があります。</dd> + <dt> + {{domxref("MozSocial.getWorker()")}}</dt> + <dd> + サービスワーカーへの参照を返します。コンテンツが一度この参照を持つと、サービスとの通信のために、<code>worker.port.postMessage()</code> メソッドを呼び出すことが可能となります。</dd> + <dt> + {{domxref("MozSocial.openChatWindow()")}}</dt> + <dd> + ブラウザウィンドウの下部に固定されたチャットウィンドウを開きます。その機能は概ね個人チャットとなると考えられますが、提供者によって異なる場合があります。</dd> + <dt> + {{domxref("MozSocial.openPanel()")}}</dt> + <dd> + 指定された垂直オフセットで、サイドバーに付属するフライアウトパネルを開きます。これは例えば、サイドバー通知に対応する実際の対話の表示に用いられます。</dd> +</dl> +<h2 id="See_also" name="See_also">関連情報</h2> +<ul> + <li><a href="/ja/docs/Social_API" title="Social_API">Social API</a></li> +</ul> diff --git a/files/ja/web/api/navigator/oscpu/index.html b/files/ja/web/api/navigator/oscpu/index.html new file mode 100644 index 0000000000..2648c08ac8 --- /dev/null +++ b/files/ja/web/api/navigator/oscpu/index.html @@ -0,0 +1,114 @@ +--- +title: Navigator.oscpu +slug: Web/API/Navigator/oscpu +tags: + - API + - CPU + - HTML DOM + - Navigator + - NavigatorID + - Property + - Reference + - oscpu + - processor +translation_of: Web/API/Navigator/oscpu +--- +<p>{{ ApiRef("HTML DOM") }}</p> + +<p><code><strong>Navigator.oscpu</strong></code> プロパティは、現在のオペレーティングシステムを識別する文字列を返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="eval notranslate"><var>oscpuInfo</var> = navigator.oscpu +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("DOMString")}} はブラウザーが実行されているオペレーティングシステムを識別する文字列を提供します。</p> + +<table class="standard-table"> + <tbody> + <tr> + <th>オペレーティングシステム</th> + <th><code>oscpuInfo</code> の文字列形式</th> + </tr> + <tr> + <td>OS/2</td> + <td>OS/2 Warp x (3, 4, 4.5 のいずれか)</td> + </tr> + <tr> + <td>Windows CE</td> + <td>WindowsCE x.y<sup>1</sup></td> + </tr> + <tr> + <td>Windows 64-bit (64ビット版)</td> + <td>Windows NT x.y; Win64; x64</td> + </tr> + <tr> + <td>Windows 64-bit (32ビット版)</td> + <td>Windows NT x.y; WOW64</td> + </tr> + <tr> + <td>Windows 32-bit</td> + <td>Windows NT x.y</td> + </tr> + <tr> + <td>Mac OS X (PPC 版)</td> + <td>PowerPC Mac OS X version x.y</td> + </tr> + <tr> + <td>Mac OS X (i386/x64 版)</td> + <td>Intel Mac OS X or macOS version x.y</td> + </tr> + <tr> + <td>Linux 64ビット (32ビット版)</td> + <td><code>uname -s</code> の出力結果に <code>i686 on x86_64</code>を加えたもの</td> + </tr> + <tr> + <td>Linux</td> + <td><code>uname -sm</code> の出力結果</td> + </tr> + </tbody> +</table> + +<ol> + <li>x.y はオペレーティングシステムのバージョンを参照</li> +</ol> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush: js notranslate">function osInfo() { + alert(window.navigator.oscpu); +} + +osInfo(); // alerts "Windows NT 6.0" for example +</pre> + +<h2 id="Usage_notes" name="Usage_notes">使用上の注意</h2> + +<p>コードが特権 ({{Glossary("Chrome", "クローム")}}であるか、少なくとも UniversalBrowserRead privilege) を持っていない場合は、実際のプラットフォームの代わりに <code>general.oscpu.override</code> 設定の値が得られる可能性があります。</p> + +<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', '#dom-navigator-oscpu', 'NavigatorID: oscpu')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.oscpu")}}</p> diff --git a/files/ja/web/api/navigator/permissions/index.html b/files/ja/web/api/navigator/permissions/index.html new file mode 100644 index 0000000000..daab836b4e --- /dev/null +++ b/files/ja/web/api/navigator/permissions/index.html @@ -0,0 +1,66 @@ +--- +title: Navigator.permissions +slug: Web/API/Navigator/permissions +tags: + - API + - Experimental + - Navigator + - Permissions + - Property + - Reference +translation_of: Web/API/Navigator/permissions +--- +<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p> + +<p><strong><code>Navigator.permissions</code></strong> 読み取り専用プロパティは、<a href="/ja/docs/Web/API/Permissions_API">Permissions API</a> の対象となる API のパーミッションの状態を照会および更新するために使用できる {{domxref("Permissions")}} オブジェクトを返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>permissionsObj</em> = <em>globalObj</em>.navigator.permissions +</pre> + +<h2 id="Value" name="Value">値</h2> + +<p>{{domxref("Permissions")}} オブジェクト。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">navigator.permissions.query({name:'geolocation'}).then(function(result) { + if (result.state === 'granted') { + showMap(); + } else if (result.state === 'prompt') { + showButtonToEnableMap(); + } + // パーミッションが拒否された場合は、何もしないでください。 +}); +</pre> + +<h2 id="Specification" name="Specification">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">状態</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('Permissions API')}}</td> + <td>{{Spec2('Permissions API')}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.Navigator.permissions")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/Permissions_API">Permissions API</a></li> + <li>{{domxref("Navigator")}}</li> +</ul> diff --git a/files/ja/web/api/navigator/presentation/index.html b/files/ja/web/api/navigator/presentation/index.html new file mode 100644 index 0000000000..9faf73374a --- /dev/null +++ b/files/ja/web/api/navigator/presentation/index.html @@ -0,0 +1,47 @@ +--- +title: Navigator.presentation +slug: Web/API/Navigator/presentation +translation_of: Web/API/Navigator/presentation +--- +<p>{{SeeCompatTable}}{{securecontext_header}}{{APIRef("Presentation API")}}</p> + +<p><code>presentation</code> は {{DOMxRef("Navigator")}} のプロパティで、 <a href="/ja/docs/Web/API/Presentation_API">Presentation API</a> のエントリーポイントを提供し、 {{DOMxRef("Presentation")}} オブジェクトへの参照を返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">const presentation = navigator.presentation +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{DOMxRef("Presentation")}} オブジェクトへの参照。</p> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">状態</th> + <th scope="col">備考</th> + </tr> + <tr> + <td>{{SpecName("Presentation","#dom-navigator-presentation","Navigator.presentation")}}</td> + <td>{{Spec2('Presentation')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.presentation")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/Presentation_API">Presentation API</a></li> + <li>{{DOMxRef("Presentation")}}</li> +</ul> diff --git a/files/ja/web/api/navigator/productsub/index.html b/files/ja/web/api/navigator/productsub/index.html new file mode 100644 index 0000000000..5a89b80831 --- /dev/null +++ b/files/ja/web/api/navigator/productsub/index.html @@ -0,0 +1,65 @@ +--- +title: Navigator.productSub +slug: Web/API/Navigator/productSub +tags: + - API + - DOM + - Navigator + - Property + - Read-only +translation_of: Web/API/Navigator/productSub +--- +<div>{{ ApiRef("HTML DOM") }}</div> + +<p><code><strong>Navigator.productSub</strong></code> プロパティは読み取り専用で、現在のブラウザーのビルド番号を返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><em>prodSub</em> = window.navigator.productSub</pre> + +<ul> + <li><code>prodSub</code> は、文字列です。</li> +</ul> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush:js"><script> +function prodsub() { + var dt = document.getElementById("d").childNodes[0]; + dt.data = window.navigator.productSub; +} +</script> + +<button onclick="prodsub();">productSub</button> +// 20010725 などを返します。</pre> + +<h2 id="Notes" name="Notes">メモ</h2> + +<p>IE では、このプロパティは、 <code>undefined</code> を返します。</p> + +<p>Google Chrome および Apple Safari では、このプロパティは常に <code>20030107</code> を返します。</p> + +<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', '#dom-navigator-productsub', 'NavigatorID: productSub')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.Navigator.productSub")}}</p> diff --git a/files/ja/web/api/navigator/registercontenthandler/index.html b/files/ja/web/api/navigator/registercontenthandler/index.html new file mode 100644 index 0000000000..03967ad941 --- /dev/null +++ b/files/ja/web/api/navigator/registercontenthandler/index.html @@ -0,0 +1,76 @@ +--- +title: Navigator.registerContentHandler() +slug: Web/API/Navigator/registerContentHandler +tags: + - API + - MIME + - Method + - Navigator + - registerContentHandler + - ウェブベースプロトコルハンドラー + - 廃止 +translation_of: Web/API/Navigator/registerContentHandler +--- +<div>{{ ApiRef("HTML DOM") }}{{ Obsolete_header }}</div> + +<p><span class="seoSummary">ウェブサイトが自分自身を、特定の MIME タイプのコンテンツのハンドラーとして可能な限り登録します。</span></p> + +<p>{{Note("ウェブサイトは自分自身のコンテンツハンドラーのみを登録できます、。セキュリティ上の理由で、拡張機能やウェブサイトが他のサイトを対象とするコンテンツハンドラーを登録することはできません。")}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">navigator.registerContentHandler(<em>mimeType</em>, <em>uri</em>, <em>title</em>);</pre> + +<ul> + <li><code>mimeType</code> は、関連付けたい MIME タイプを表す文字列です。</li> + <li><code>uri</code> は、関連づける URI を表す文字列です。</li> + <li><code>title</code> は、ユーザ向けの関連付けの名称を表す文字列です。</li> +</ul> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush:js;auto-links:false;">navigator.registerContentHandler( + "application/vnd.mozilla.maybe.feed", + "http://www.example.tld/?foo=%s", + "My Feed Reader" +);</pre> + +<h2 id="Notes" name="Notes">メモ</h2> + +<p><a href="/ja/docs/Firefox_2_for_developers" title="Firefox_2_for_developers">Firefox 2</a> 以降では、 MIME タイプのうち <code>application/vnd.mozilla.maybe.feed</code>, <code>application/atom+xml</code>, <code>application/rss+xml</code> のみに対応しています。これらの値は全て、同じ効果を持っています。また、関連付けは、全てのバージョンの Atom と RSS におけるフィードに対して適用されます。</p> + +<p>Firefox はこの機能が実装された唯一のブラウザーであり、標準には一致していません。この機能は HTML 標準から削除されており、使用しないでください。</p> + +<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('HTML5.2', 'webappapis.html#dom-navigator-registercontenthandler', 'registerContentHandler()')}}</td> + <td>{{Spec2('HTML5.2')}}</td> + <td>この機能は HTML 5.2 に存在するが、 WHATWG HTML Living Standard からは削除済み。</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_Compatibility" name="Browser_Compatibility">ブラウザーの対応</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.Navigator.registerContentHandler")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web-based_protocol_handlers" title="Web-based_protocol_handlers">ウェブベースのプロトコルハンドラー</a></li> + <li>{{domxref("Navigator.registerProtocolHandler()")}}</li> + <li><a href="/ja/docs/WebAPI/Web_Activities" title="/ja/docs/WebAPI/Web_Activities">Web activities</a>、特に view 及び open</li> + <li><a href="/ja/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsIWebContentHandlerRegistrar#registerContentHandler">XPCOM Interface Reference > nsIWebContentHandlerRegistrar > registerContentHandler</a> - この機能を XPCOM のスコープから使用する方法を紹介</li> +</ul> diff --git a/files/ja/web/api/navigator/registerprotocolhandler/index.html b/files/ja/web/api/navigator/registerprotocolhandler/index.html new file mode 100644 index 0000000000..1eda18c297 --- /dev/null +++ b/files/ja/web/api/navigator/registerprotocolhandler/index.html @@ -0,0 +1,150 @@ +--- +title: Navigator.registerProtocolHandler() +slug: Web/API/Navigator/registerProtocolHandler +tags: + - API + - DOM + - DOM Reference + - Method + - Navigator + - Reference + - Web-Based Protocol Handlers + - registerProtocolHandler +translation_of: Web/API/Navigator/registerProtocolHandler +--- +<div>{{APIRef("HTML DOM")}}{{securecontext_header}}</div> + +<p><span class="seoSummary"><strong>{{domxref("Navigator")}}</strong> の <code><strong>registerProtocolHandler()</strong></code> メソッドは、ウェブサイトが特定の URL スキーム (別名プロトコル) を開いたり処理したりする能力を登録することを可能にします。</span></p> + +<p>例えば、この API はウェブメールサイトを <code>mailto:</code> の URL で開かせたり、 <abbr title="Voice over Internet Protocol, also called IP telephony">VoIP</abbr> サイトを <code>tel:</code> の URL で開かせたりします。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">navigator.registerProtocolHandler(<var>scheme</var>, <var>url</var>, <var>title</var>); +</pre> + +<div class="note"><strong>注:</strong> 最近になって <code>navigator.registerProtocolHandler(<var>scheme</var>, <var>url</var>)</code> と更新されましたが、こちらに対応しているブラウザーは今のところありませx。</div> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>scheme</var></code></dt> + <dd>サイトが処理したいプロトコルを指定する文字列。例えば、 <code>"sms"</code> スキームを渡すことで、SMS テキストメッセージリンクを扱うように登録することができます。</dd> + <dt><code><var>url</var></code></dt> + <dd>ハンドラーの URL を指定する文字列。この文字列には、処理される文書の URL をエスケープした者で置き換えられるプレイスホルダー "%s" を含めてください。この URL は本物の URL のほか、電話番号、メールアドレスなどにすることもできます。 + <div class="note"><strong>注:</strong> ハンドラー URL のスキームは <code>https</code> でなければなりません。ブラウザーによってはセキュリティのため、 HTTPS の URL であることを求めるため、<em>そうするべきです</em>。</div> + </dd> + <dt><code><var>title</var></code> {{Obsolete_Inline}}</dt> + <dd>ハンドラーを表す人間が読めるタイトル文字列です。これは、「このサイトで [スキーム] リンクを扱うことを許可しますか？」というプロンプトや、ブラウザーの設定で登録されたハンドラーを一覧表示するなどの形で<strong>ユーザーに表示されます</strong>。 + <div class="note"><strong>注:</strong> タイトルはなりすましの懸念から仕様から削除されましたが、現在のすべてのブラウザーでは<strong>まだ必要とされています</strong>。更新された仕様に対応しているブラウザーはほとんどの場合、下位互換性があり、まだ受け付けている可能性が高いので、<strong>常にタイトルを設定</strong>しておくことをお勧めします (ただし、使用はしません)。</div> + </dd> +</dl> + +<h3 id="Exceptions" name="Exceptions">例外</h3> + +<dl> + <dt>{{Exception("SecurityError")}}</dt> + <dd>ユーザーエージェントが登録をブロックしました。以下のような場合に起こる可能性があります。</dd> +</dl> + +<ul> + <li>ブラウザーが独自に処理するスキーム (<code>https:</code>, <code>about:</code>, など) など、登録されているスキーム (プロトコル) が無効です。</li> + <li>ハンドラーの URL の{{Glossary("origin", "オリジン")}}が、本 API を呼び出すページのオリジンと一致しない。</li> + <li>ブラウザーが、この関数を安全なコンテキストから呼び出す必要がある。</li> + <li>ブラウザーがハンドラーの URL が HTTPS 以上であることを要求している。</li> +</ul> + +<dl> + <dt>{{Exception("SyntaxError")}}</dt> + <dd><code>%s</code> が指定されたハンドラー URL に含まれていない。</dd> +</dl> + +<h2 id="Permitted_schemes" name="Permitted_schemes">許可されたスキーム</h2> + +<p>セキュリティ上の理由により <code>registerProtocolHandler()</code> は登録可能なスキームに制限を設けています。</p> + +<p><strong>カスタムスキーム</strong>は次のような場合に登録されます。</p> + +<ul> + <li>カスタムスキームの名前が <code>web+</code> で始まる</li> + <li>カスタムスキームの名前が <code>web+</code> 接頭辞の後に1文字以上ある</li> + <li>カスタムスキームの名前に小文字の ASCII 文字のみが含まれている</li> +</ul> + +<p>例えば下の {{anch("Example", "例")}} で使われている <code>web+burger</code> などが挙げられます。</p> + +<p>もしくは、以下のホワイトリストに挙げられているスキームでなければなりません。</p> + +<div class="threecolumns"> +<ul> + <li><code>bitcoin</code></li> + <li><code>geo</code></li> + <li><code>im</code></li> + <li><code>irc</code></li> + <li><code>ircs</code></li> + <li><code>magnet</code></li> + <li><code>mailto</code></li> + <li><code>mms</code></li> + <li><code>news</code></li> + <li><code>nntp</code></li> + <li><code>openpgp4fpr</code></li> + <li><code>sip</code></li> + <li><code>sms</code></li> + <li><code>smsto</code></li> + <li><code>ssh</code></li> + <li><code>tel</code></li> + <li><code>urn</code></li> + <li><code>webcal</code></li> + <li><code>wtai</code></li> + <li><code>xmpp</code></li> +</ul> +</div> + +<h2 id="Example" name="Example">例</h2> + +<p>ウェブアプリケーションが <code>burgers.example.com</code> にある場合、次のようにして <code>web+burger:</code> リンクを処理するプロトコルハンドラーを登録できます:</p> + +<pre class="brush: js notranslate">navigator.registerProtocolHandler("web+burger", + "https://burgers.example.com/?burger=%s", + "Burger handler"); +</pre> + +<p>これは、 <code>web+burger:</code> リンクがアクセスしたバーガーの URL を <code>%s</code> プレースホルダーに挿入し、ユーザーをサイトに誘導するハンドラーを作成します。</p> + +<p>このスクリプトはハンドラーの URL と同じオリジン (すなわち、 <code>https://burgers.example.com</code> にあるページのいずれか) から実行する必要があり、ハンドラーの URL は <code>http</code> または <code>https</code> である必要があります。</p> + +<p>あなたのコードがプロトコルハンドラーを登録しようとしていることはユーザーに通知され、ユーザーは登録を許可するかどうか決めることができます。以下のスクリーンショットは <code>google.co.uk</code> での例です。</p> + +<p><img alt="A browser notification reads “Add Burger handler (www.google.co.uk) as an application for burger links?”, and offers an “Add Application” button and a close to ignore the handler request." src="https://mdn.mozillademos.org/files/9683/protocolregister.png"></p> + +<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', 'system-state.html#custom-handlers', 'registerProtocolHandler()')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Living standard</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.registerProtocolHandler")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web-based_protocol_handlers">ウェブベースのプロトコルハンドラー</a></li> + <li>Mozilla Webdev の <a href="http://blog.mozilla.com/webdev/2010/07/26/registerprotocolhandler-enhancing-the-federated-web/">RegisterProtocolHandler Enhancing the Federated Web</a></li> +</ul> diff --git a/files/ja/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html b/files/ja/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html new file mode 100644 index 0000000000..e131010da8 --- /dev/null +++ b/files/ja/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html @@ -0,0 +1,132 @@ +--- +title: ウェブベースのプロトコルハンドラー +slug: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers +tags: + - Advanced + - HTML5 + - Web-Based Protocol Handlers +translation_of: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers +--- +<div>{{Fx_minversion_header(3)}}</div> + +<h2 id="Background" name="Background">背景</h2> + +<p>ウェブページで <code>http</code> ではないプロトコルを使用したリソースへのリンクを見つけることがよくあります。例えば、 <code>mailto:</code> プロトコルです。</p> + +<div style="overflow: hidden;"> +<pre class="brush:html"><a href="mailto:webmaster@example.com">ウェブマスター</a></pre> +</div> + +<p>ウェブ制作者は、ユーザーがウェブページから直接 E メールを送るのに便利な方法を提供したいときに、 <code>mailto:</code> リンクを用いることができます。リンクがアクティブ化されたとき、ブラウザは、E メールを扱うための標準のデスクトップアプリケーションを起動させるはずです。これは、<em>デスクトップベース</em> プロトコルハンドラーと考えることができます。</p> + +<p>ウェブベースプロトコルハンドラーは、ウェブベースアプリーケーションもその処理に追加することを可能にします。これはアプリケーションをウェブに移行させるうえでますます重要になってきています。実際、 <code>mailto</code> リンクを処理できる可能性がある多くのウェブベースの E メールを扱うアプリケーションが存在しています。</p> + +<h2 id="Registering" name="Registering">登録</h2> + +<p>ウェブアプリケーションをプロトコルハンドラーとして設定するのは、難しい処理ではありません。基本的に、ウェブアプリケーションは自身を指定したプロトコルのための可能なハンドラーとしてブラウザに登録するために <code><a href="/ja/docs/DOM/window.navigator.registerProtocolHandler">registerProtocolHandler()</a></code> を使用します。</p> + +<pre class="brush: js">navigator.registerProtocolHandler("web+burger", + "http://www.google.co.uk/?uri=%s", + "Burger handler");</pre> + +<p>ここでの引数は次の通りです。</p> + +<ul> + <li>プロトコル。</li> + <li>URL のテンプレート。"%s" は、リンクの <code>href</code> 属性の値に置換され、GET は置換後の URL に対して実行されます。</li> + <li>プロトコルハンドラーのためのユーザーにわかりやすい名前。</li> +</ul> + +<p>ブラウザがこのコードを実行するとき、ユーザーにプロンプトを表示し、そのプロトコルのためのハンドラーとしてそのウェブアプリケーションを登録して良いかどうかの許可を求めるはずです。Firefox は、情報バーエリアに以下のプロンプトを表示します。</p> + +<p><img alt="" src="https://mdn.mozillademos.org/files/9683/protocolregister.png" style="display: block; height: 401px; margin: 0px auto; width: 700px;"></p> + +<div class="note"><strong>メモ:</strong> URL テンプレートが提供されるとき、登録する URL は登録が行われようとするウェブページと同じドメインである<strong>必要があります</strong>。異なるドメインであった場合は、登録は失敗します。 例えば <code>http://example.com/homepage.html</code> では <code>http://example.com/handle_mailto/%s</code> はプロトコルハンドラーとして登録可能ですが、 <code>http://example.<em><strong>org</strong></em>/handle_mailto/%s</code> はプロトコルハンドラーとして登録することはできません。</div> + +<p>同じプロトコルハンドラーを二回以上登録すると、そのプロトコルハンドラーが既に登録済みであることを示す別のポップアップが表示されます。従って、プロトコルハンドラーの登録を呼び出すのを防ぐために、以下のように既に登録済みであるかどうかを確認するのが良いでしょう。</p> + +<h3 id="Example" name="Example">例</h3> + +<pre class="brush: js"><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<html lang="ja"> +<head> + <title>ウェブプロトコルハンドラーサンプル - 登録</title> + <script type="text/javascript"> + navigator.registerProtocolHandler("web+burger", + "http://www.google.co.uk/?uri=%s", + "Burger handler"); + </script> +</head> +<body> + <h1>ウェブプロトコルハンドラーサンプル</h1> + <p>このウェブページは、 <code>fake:</code> プロトコルのためのウェブプロトコルハンドラーをインストールします。</p> +</body> +</html> +</pre> + +<h2 id="Activating" name="Activating">有効化</h2> + +<p>登録すると、ユーザーが登録されたプロトコルを用いたリンクを有効化したときに、ブラウザはウェブアプリケーションが登録されたときに提供された URL へアクションを送るようになります。Firefox は、既定では、アクションを実行する前にユーザーにプロンプトを表示します。</p> + +<h3 id="Example_2" name="Example_2">例</h3> + +<pre class="brush: html"><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<html lang="ja"> +<head> + <title>ウェブプロトコルハンドラーサンプル - テスト</title> +</head> +<body> + <p>やあ、前に<a href="web+burger:cheeseburger">これ</a>を見たことある？</p> +</body> +</html> +</pre> + +<h2 id="Handling" name="Handling">ハンドリング</h2> + +<p>次の段階は、アクションをハンドリング（実行）することです。ブラウザはアクティブ化されたリンクから <code>href</code> 属性の値を展開し、ハンドラー登録時に提供された URL テンプレートと結合し、その URL 上で HTTP GET を行います。ですから、上記の例では、ブラウザは、次の URL 上で GET を行います。</p> + +<pre>http://www.google.co.uk/?uri=web+burger:cheeseburger +</pre> + +<p>サーバー側コードは、クエリ文字列パラメータを展開し、要求されたアクションを行います。</p> + +<div class="note"><strong>メモ:</strong> サーバー側コードには <code>href</code> 属性の値の <strong>完全</strong> な内容が渡されます。つまり、サーバー側コードは、そのデータからプロトコルを解釈しなければならないということです。</div> + +<h3 id="Example_3" name="Example_3">例</h3> + +<pre class="brush: php"><?php +$value = ""; +if ( isset ( $_GET["value"] ) ) { + $value = $_GET["value"]; +} +?> + +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<html lang="ja"> +<head> + <title>ウェブプロトコルハンドラーサンプル</title> +</head> +<body> + <h1>ウェブプロトコルハンドラーサンプル - ハンドラ</h1> + <p>このウェブページは、 <code>web+burger:</code> プロトコルアクションをハンドリングしたときに呼び出されます。次のデータが送られました。</p> + <textarea> +<?php echo(htmlspecialchars($value, ENT_QUOTES, 'UTF-8')); ?> + </textarea> +</body> +</html> +</pre> + +<h2 id="References" name="References">仕様書</h2> + +<ul> + <li><a href="http://www.w3.org/TR/2011/WD-html5-20110525/timers.html#custom-handlers">http://www.w3.org/TR/2011/WD-html5-20110525/timers.html#custom-handlers</a></li> +</ul> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/DOM/window.navigator.registerContentHandler">window.navigator.registerContentHandler</a></li> + <li><a href="/ja/docs/XPCOM_Interface_Reference/nsIProtocolHandler">nsIProtocolHandler</a> (XUL のみ)</li> + <li><a class="external" href="http://blog.mozilla.com/webdev/2010/07/26/registerprotocolhandler-enhancing-the-federated-web/">RegisterProtocolHandler Enhancing the Federated Web</a> at Mozilla Webdev</li> + <li><a href="https://developers.google.com/web/updates/2011/06/Registering-a-custom-protocol-handler">Register a custom protocolHandler</a> at Google Developers.</li> +</ul> diff --git a/files/ja/web/api/navigator/sendbeacon/index.html b/files/ja/web/api/navigator/sendbeacon/index.html new file mode 100644 index 0000000000..9854c2fa49 --- /dev/null +++ b/files/ja/web/api/navigator/sendbeacon/index.html @@ -0,0 +1,112 @@ +--- +title: Navigator.sendBeacon() +slug: Web/API/Navigator/sendBeacon +tags: + - API + - Beacon + - Method + - Navigator + - Networking + - Reference + - Web Performance + - sendBeacon + - ネットワーク + - ビーコン + - メソッド +translation_of: Web/API/Navigator/sendBeacon +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p><span class="seoSummary"><code><strong>navigator.sendBeacon()</strong></code> メソッドは、ウェブサーバーに{{glossary("Asynchronous", "非同期")}}に少量のデータを {{Glossary("HTTP")}} で送るために使用することができます。</span></p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">navigator.sendBeacon(<var>url</var>, <var>data</var>); +</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>url</var></code></dt> + <dd><var>data</var> を受け取る URL です。相対でも絶対でも可能です。</dd> + <dt><code><var>data</var></code></dt> + <dd>送るデータを含む {{domxref("ArrayBuffer")}}, {{domxref("ArrayBufferView")}}, {{domxref("Blob")}}, {{domxref("DOMString")}}, {{domxref("FormData")}}, {{domxref("ReadableStream")}}, {{domxref("URLSearchParams")}} のいずれかのオブジェクトです。</dd> +</dl> + +<h3 id="Return_values" name="Return_values">返値</h3> + +<p><code><strong>sendBeacon()</strong></code> メソッドが <code>true</code> を返した場合は、{{glossary("user agent", "ユーザーエージェント")}}が転送のために <code>data</code> をキューに入れることに成功したことを表します。それ以外の場合は <code>false</code> を返します。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>このメソッドは、アナリティクスや診断のために、データの送信が早すぎるとデータ収集の機会を失う可能性があるような場合、文書がアンロードされる前にサーバーにデータを送信するものです。例えば、他のページに移動してページがアンロードされる前にユーザーがどのリンクをクリックしたかなどです。</p> + +<p>文書のアンロード時に確実にデータが送信されるようにするのは開発者にとってずっと難しいことでした。ユーザーエージェントは通常 {{domxref("Window/unload_event", "unload")}} ハンドラーの中で生成された非同期 {{domxref("XMLHttpRequest")}} を無視するからです。</p> + +<p>伝統的には、これは以下のような回避方法を使用して、ある URL にデータを送信するまでページのアンロードを遅らせるよう位置づけられていました。</p> + +<ul> + <li>ブロックする同期 <code>XMLHttpRequest</code> の呼び出しを <code>unload</code> または {{domxref("Window/beforeunload_event", "beforeunload")}} イベントハンドラーの中で行い、データを送信する。</li> + <li>{{HTMLElement("img")}} 要素を作成し、その <code>src</code> を <code>unload</code> ハンドラーの中で設定する。ほとんどのユーザーエージェントは画像を読み込むためにアンロードを遅延させる。</li> + <li><code>unload</code> ハンドラー内で何もしないループを作成する。</li> +</ul> + +<p>これらの方法はすべて、文書のアンロードをブロックするので、次への遷移が遅くなります。次のページがこれをやめさせる方法は存在しないので、前のページの問題であるにもかかわらず、次のページが遅いように見えます。</p> + +<p>次の例は <code>unload</code> ハンドラーで同期 <code>XMLHttpRequest</code> を送ってサーバにデータを送信しようとする理論的なアナリティクスのコードです。これは、次のページの読み込みが遅らせられる結果になります。</p> + +<pre class="brush: js">window.addEventListener("unload", function logData() { + var xhr = new XMLHttpRequest(); + xhr.open("POST", "/log", false); // third parameter of `false` means synchronous + xhr.send(analyticsData); +}); +</pre> + +<p>これが <code><strong>sendBeacon()</strong></code> で置き換わるところです。 <code>sendBeacon()</code> メソッドにより、ユーザーエージェントが行う機会があればデータが非同期に送信され、アンロードや次への遷移が遅れることはありません。<strong>これはアナリティクスのデータを送信する際の問題をすべて解決します。</strong></p> + +<ul> + <li>データの送信の信頼性が高い</li> + <li>非同期に送信される</li> + <li>次のページの読み込みへの影響がない</li> + <li>加えて、どの古いテクニックよりも簡単にコードを書くことができる。</li> +</ul> + +<p>次の例は、 <code>sendBeacon()</code> メソッドを使用してサーバーにデータを送信する、理論的なアナリティクスのコードパターンです。</p> + +<pre class="brush: js">window.addEventListener("unload", function logData() { + navigator.sendBeacon("/log", analyticsData); +}); +</pre> + +<p>ビーコンは HTTP リクエストを POST メソッドで送信し、関連する Cookie も呼び出し時にすべて利用できます。</p> + +<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('Beacon', '#sendbeacon-method', 'sendBeacon()')}}</td> + <td>{{Spec2('Beacon')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.sendBeacon")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("navigator", "navigator")}}</li> +</ul> diff --git a/files/ja/web/api/navigator/serviceworker/index.html b/files/ja/web/api/navigator/serviceworker/index.html new file mode 100644 index 0000000000..834bd49ae8 --- /dev/null +++ b/files/ja/web/api/navigator/serviceworker/index.html @@ -0,0 +1,68 @@ +--- +title: Navigator.serviceWorker +slug: Web/API/Navigator/serviceWorker +tags: + - API + - Navigator + - Property + - Reference + - Service Workers + - Service worker API + - ServiceWorker +translation_of: Web/API/Navigator/serviceWorker +--- +<div>{{APIRef("Service Workers API")}}</div> + +<p><span class="seoSummary"><code><strong>Navigator.serviceWorker</strong></code> は読み取り専用のプロパティで、<a href="https://html.spec.whatwg.org/multipage/browsers.html#concept-document-window">関連付けられた文書</a>で {{domxref("ServiceWorker")}} の登録、削除、更新、通信へのアクセスを提供する {{domxref("ServiceWorkerContainer")}} オブジェクトを返します。</span></p> + +<p>この機能はプライベートモードでは利用できない可能性があります。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">var workerContainerInstance = navigator.serviceWorker; +</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>{{domxref("ServiceWorkerContainer")}}</p> + +<h2 id="Examples" name="Examples">例</h2> + +<p>このコードは、ブラウザーがサービスワーカーに対応しているかをチェックします。</p> + +<pre class="brush: js notranslate">if ('serviceWorker' in navigator) { + // Supported! +} +</pre> + +<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('Service Workers', '#navigator-serviceworker', 'navigator.serviceWorker')}}</td> + <td>{{Spec2('Service Workers')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.serviceWorker")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/ja/docs/Web/API/ServiceWorker_API/Using_Service_Workers">サービスワーカーの使用</a></li> +</ul> diff --git a/files/ja/web/api/navigator/share/index.html b/files/ja/web/api/navigator/share/index.html new file mode 100644 index 0000000000..63d289c4e9 --- /dev/null +++ b/files/ja/web/api/navigator/share/index.html @@ -0,0 +1,94 @@ +--- +title: Navigator.share() +slug: Web/API/Navigator/share +tags: + - Method + - Navigator + - Reference + - Share + - Web + - メソッド +translation_of: Web/API/Navigator/share +--- +<div>{{APIRef("HTML DOM")}}{{securecontext_header}}</div> + +<p><strong><code>Navigator.share()</code></strong> メソッドは、 Web Share API の一部としてのネイティブの共有メカニズムを呼び出します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">var sharePromise = navigator.share(<var>data</var>); +</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>data</var></code></dt> + <dd>シェアするデータを含むオブジェクトです。以下のフィールドのうち少なくとも一つを指定しなければなりません。利用可能なオプションは下記のとおりです。</dd> +</dl> + +<ul> + <li><code>url</code>: シェアする URL を表す {{domxref("USVString")}}。</li> + <li><code>text</code>: シェアするテキストを表す {{domxref("USVString")}}。</li> + <li><code>title</code>: シェアするタイトルを表す {{domxref("USVString")}}。</li> +</ul> + +<dl> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>ユーザーがシェア操作を完了させたとき (ふつうはユーザーがシェア先のアプリケーションを選択したとき) に解決する {{domxref("Promise")}} です。引数 <var>data</var> が正しく指定されなかった場合は直ちに拒否され、ユーザーがシェアをキャンセルした場合も拒否されます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<p><a href="https://mdn.github.io/dom-examples/web-share/">ウェブシェアテスト</a> (<a href="https://github.com/mdn/dom-examples/blob/master/web-share/index.html">ソースコードを参照</a>) では、ボタンが一つあり、クリックすると Web Share API を呼び出して MDN の URL をシェアします。 JavaScript は以下のようになります。</p> + +<pre class="brush: js">const shareData = { + title: 'MDN', + text: 'MDN でウェブ開発を学びましょう。', + url: 'https://developer.mozilla.org', +} + +const btn = document.querySelector('button'); +const resultPara = document.querySelector('.result'); + +// Must be triggered some kind of "user activation" +btn.addEventListener('click', async () => { + try { + await navigator.share(shareData) + resultPara.textContent = 'MDN shared successfully' + } catch(err) { + resultPara.textContent = 'Error: ' + e + } +});</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table> + <thead> + <tr> + <th scope="col">仕様書</th> + <th scope="col">状態</th> + <th scope="col">備考</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('Web Share API','#share-method','share()')}}</td> + <td>{{Spec2('Web Share API')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.share")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref('navigator.canShare', 'navigator.canShare()')}}</li> +</ul> diff --git a/files/ja/web/api/navigator/vendor/index.html b/files/ja/web/api/navigator/vendor/index.html new file mode 100644 index 0000000000..2172c91bb6 --- /dev/null +++ b/files/ja/web/api/navigator/vendor/index.html @@ -0,0 +1,60 @@ +--- +title: Navigator.vendor +slug: Web/API/Navigator/vendor +tags: + - API + - HTML DOM + - Navigator + - Read-only + - プロパティ +translation_of: Web/API/Navigator/vendor +--- +<p>{{ APIRef("HTML DOM") }}</p> + +<p>現在のブラウザーのブラウザーベンダーの名前を返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="eval"><var>venString</var> = window.navigator.vendor +</pre> + +<h3 id="Value" name="Value">値</h3> + +<ul> + <li><var>venString</var> は、 {{domxref("DOMString")}} です。</li> +</ul> + +<h2 id="Example" name="Example">例</h2> + +<pre>window.navigator.vendor +// "Netscape6" などの文字列が返る +</pre> + +<h2 id="Notes" name="Notes">メモ</h2> + +<p><code>vendor</code> は、ユーザエージェントを表す文字列の内の一部分です。 product と vendor は異なる可能性があります。例えば、Netscape 6.1 の場合、レンダリングに Gecko product を利用しています。 <a href="/ja/docs/DOM/window.navigator.product">navigator.product</a>、<a href="/ja/docs/DOM/window.navigator.userAgent">navigator.userAgent</a> も参照してください。</p> + +<h2 id="Specification" name="Specification">仕様書</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', '#dom-navigator-vendor', 'NavigatorID: vendor')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.Navigator.vendor")}}</p> diff --git a/files/ja/web/api/navigator/vendorsub/index.html b/files/ja/web/api/navigator/vendorsub/index.html new file mode 100644 index 0000000000..f54ccdc550 --- /dev/null +++ b/files/ja/web/api/navigator/vendorsub/index.html @@ -0,0 +1,61 @@ +--- +title: Navigator.vendorSub +slug: Web/API/Navigator/vendorSub +tags: + - API + - HTML DOM + - Navigator + - Property + - Read-only +translation_of: Web/API/Navigator/vendorSub +--- +<div>{{ApiRef}}{{deprecated_header}}</div> + +<p><code><strong>Navigator.vendorSub</strong></code> プロパティは読み取り専用で、ベンダーバージョン番号が付いたベンダーの部分文字列です。仕様書ではブラウザーが常に空文字列を返して良いことになっているため、このプロパティから頼れる回答を期待しないでください。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><var>venSub</var> = window.navigator.vendorSub +</pre> + +<h3 id="Value" name="Value">値</h3> + +<ul> + <li><var>venSub</var> は {{domxref("DOMString")}} です。</li> +</ul> + +<h2 id="Example" name="Example">例</h2> + +<pre class="brush:js">window.navigator.vendorSub +// "6.1" を返す場合、userAgent のべンダー名は、 +// Netscape6/6.1 などです。 +</pre> + +<h2 id="Notes" name="Notes">メモ</h2> + +<p><code>vendorSub</code> は、ユーザーエージェント文字列全体の一部分です。バージョン番号は、ベンダー自身がそのブラウザーに与えたものです (製品のバージョンとは異なるかもしれません)。 Netscape 6.1 では、 <code>productSub</code> は <code>"5.0"</code> ですが、 <code>vendorSub</code> は <code>"6.1"</code> です。 {{domxref("window.navigator.productSub","navigator.productSub")}}, {{domxref("window.navigator.userAgent","navigator.userAgent")}}, {{domxref("window.navigator.vendor","navigator.vendor")}} も参照してください。</p> + +<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', '#dom-navigator-vendorsub', 'NavigatorID: vendorSub')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("api.Navigator.vendorSub")}}</p> diff --git a/files/ja/web/api/navigator/vibrate/index.html b/files/ja/web/api/navigator/vibrate/index.html new file mode 100644 index 0000000000..fedd3c8f2e --- /dev/null +++ b/files/ja/web/api/navigator/vibrate/index.html @@ -0,0 +1,65 @@ +--- +title: Navigator.vibrate() +slug: Web/API/Navigator/vibrate +tags: + - API + - Method + - Navigator + - Reference + - Vibration API +translation_of: Web/API/Navigator/vibrate +--- +<div>{{APIRef("Vibration API")}}</div> + +<p><strong><code>Navigator.vibrate()</code></strong> メソッドは、端末のバイブレーションハードウェアがあればパルスを送ります。端末がバイブレーションに対応していない場合は、このメソッドは効果はありません。このメソッドが呼び出されたときに、すでにバイブレーションパターンが進行中であった場合は、前のパターンが停止され、代わりに新しいパターンが始まります。</p> + +<p>引数が無効であるためこのメソッドがバイブレーションを実行できなかった場合は <code>false</code> を返し、それ以外の場合は <code>true</code> を返します。パターンによってとても長いバイブレーションが指定された場合は、短縮されます。最大長は実装に依存します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">var <em>successBool</em> = window.navigator.vibrate(<em><var>pattern</var></em>); +</pre> + +<dl> + <dt><code><var>pattern</var></code></dt> + <dd>バイブレーションと停止の間隔のパターンを提供します。それぞれの値はミリ秒単位の数値でバイブレーションと停止の長さを交互に表します。単一の値 (そのミリ秒だけ一度バイブレーションを行う) か、値の配列でバイブレーション、停止、再度バイブレーションと交互の値の配列で指定することができます。詳しくは <a href="/ja/docs/WebAPI/Vibration">Vibration API</a> を参照してください。</dd> +</dl> + +<p><code>0</code> の値、空の配列、すべての値がゼロである配列を渡すと、現在進行中のバイブレーションパターンをすべて中止します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">window.navigator.vibrate(200); // vibrate for 200ms +window.navigator.vibrate([100,30,100,30,100,30,200,30,200,30,200,30,100,30,100,30,100]); // モールス信号で 'SOS' とバイブレーションします。 +</pre> + +<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('Vibration API')}}</td> + <td>{{Spec2('Vibration API')}}</td> + <td>Linked to spec is the latest editor's draft; W3C version is a REC.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.Navigator.vibrate")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/WebAPI/Vibration">Vibration API</a></li> +</ul> diff --git a/files/ja/web/api/navigator/webdriver/index.html b/files/ja/web/api/navigator/webdriver/index.html new file mode 100644 index 0000000000..9f23436f63 --- /dev/null +++ b/files/ja/web/api/navigator/webdriver/index.html @@ -0,0 +1,58 @@ +--- +title: Navigator.webdriver +slug: Web/API/Navigator/webdriver +tags: + - API + - Navigator + - Property + - Reference + - WebDriver + - weblock + - プロパティ +translation_of: Web/API/Navigator/webdriver +--- +<div>{{SeeCompatTable}}{{APIRef("WebDriver")}}</div> + +<p><span class="seoSummary"><strong><code>webdriver</code></strong> は {{domxref("navigator")}} インターフェイスの読み取り専用プロパティで、ユーザーエージェントが自動制御されているかどうかを示します。</span></p> + +<p>これは協調動作をするユーザーエージェントが <a href="/ja/docs/Web/WebDriver">WebDriver</a> によって制御されていることを文書に伝えるための標準の方法を定めており、例えば自動制御の間は異なるコードを実行したりすることができます。</p> + +<p>次のような場合に <code>navigator.webdriver</code> プロパティが true になります。</p> + +<dl> + <dt>Chrome</dt> + <dd><code>--enable-automation</code> または <code>--headless</code> フラグまたは <code>--remote-debugging-port</code> が使用されているとき。</dd> + <dt>Firefox</dt> + <dd>設定の <code>marionette.enabled</code> または <code>--marionette</code> フラグが渡されたとき。</dd> +</dl> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">var <var>isAutomated</var> = navigator.webdriver</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>A {{JSxRef("Boolean")}}</p> + +<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("WebDriver","#dom-navigatorautomationinformation-webdriver","webdriver")}}</td> + <td>{{Spec2("WebDriver")}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div>{{Compat("api.Navigator.webdriver")}}</div> diff --git a/files/ja/web/api/navigator/xr/index.html b/files/ja/web/api/navigator/xr/index.html new file mode 100644 index 0000000000..66a7070864 --- /dev/null +++ b/files/ja/web/api/navigator/xr/index.html @@ -0,0 +1,72 @@ +--- +title: Navigator.xr +slug: Web/API/Navigator/xr +tags: + - API + - AR + - Augmented Reality + - Getter + - Graphics + - Navigator + - Property + - Reference + - VR + - Virtual Reality + - WebXR + - XR +translation_of: Web/API/Navigator/xr +--- +<div>{{APIRef("WebXR Device API")}}</div> + +<p><span class="seoSummary">{{domxref("Navigator")}} インターフェイスまたは {{domxref("WorkerNavigator")}} インターフェイスによって提供される <strong><code>xr</code></strong> 読み取り専用プロパティは、<a href="/ja/docs/Web/API/WebXR_Device_API">WebXR Device API</a> へのアクセスに使用できる {{domxref("XRSystem")}} オブジェクトを返します。</span></p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">const <var>xr</var> = navigator.xr</pre> + +<h3 id="Value" name="Value">値</h3> + +<p>現在のコンテキストで <a href="/ja/docs/Web/API/WebXR_Device_API">WebXR Device API</a> とのインターフェイスに使用する {{domxref("XRSystem")}} オブジェクト。 これを使用して、拡張現実や仮想現実の画像をユーザーに提示することができます。</p> + +<h2 id="Usage_notes" name="Usage_notes">使用上の注意</h2> + +<p>各 {{domxref("Window")}} には独自の {{domxref("Navigator")}} のインスタンスがあり、{{domxref("Window.navigator","window.navigator")}} または単に {{domxref("Window.navigator", "navigator")}} としてアクセスできます。 同時に、新しい {{domxref("XRSystem")}} インスタンスも作成され、{{domxref("Navigator.xr", "navigator.xr")}} として <code>navigator</code> インスタンスにアタッチされます。 <code>xr</code> プロパティが存在する場合は、それを使用して <a href="/ja/docs/Web/API/WebXR_Device_API">WebXR Device API</a> にアクセスできます。</p> + +<p>WebXR が利用可能かどうかを判断するには、次のようにします。</p> + +<pre class="brush: js notranslate">if ("xr" in window.navigator) { + /* WebXR can be used! */ +} else { + /* WebXR isn't available */ +} +</pre> + +<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("WebXR","#navigator-xr-attribute","Navigator.xr")}}</td> + <td>{{Spec2("WebXR")}}</td> + <td>初期定義</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<p>{{Compat("api.Navigator.xr")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/ja/docs/Web/API/WebGL_API">WebGL API</a>: ウェブの 2D および 3D グラフィック</li> + <li><a href="/ja/docs/Web/API/Canvas_API">Canvas API</a>: 簡単な 2D グラフィック API</li> +</ul> |