diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/ja/web/api/response | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/ja/web/api/response')
-rw-r--r-- | files/ja/web/api/response/error/index.html | 63 | ||||
-rw-r--r-- | files/ja/web/api/response/headers/index.html | 73 | ||||
-rw-r--r-- | files/ja/web/api/response/index.html | 128 | ||||
-rw-r--r-- | files/ja/web/api/response/redirect/index.html | 85 | ||||
-rw-r--r-- | files/ja/web/api/response/response/index.html | 75 | ||||
-rw-r--r-- | files/ja/web/api/response/usefinalurl/index.html | 60 |
6 files changed, 484 insertions, 0 deletions
diff --git a/files/ja/web/api/response/error/index.html b/files/ja/web/api/response/error/index.html new file mode 100644 index 0000000000..28ad1c1995 --- /dev/null +++ b/files/ja/web/api/response/error/index.html @@ -0,0 +1,63 @@ +--- +title: Response.error() +slug: Web/API/Response/error +translation_of: Web/API/Response/error +--- +<div>{{APIRef("Fetch")}}</div> + +<p>{{domxref("Response")}} インターフェイスの <strong><code>error()</code></strong> メソッドはネットワークエラーに関連付けられた新規の <code>Response</code> オブジェクトを返します。</p> + +<div class="note"> +<p><strong>Note</strong>: これは主に <a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorkers</a> に関連しています。エラーメソッドは、必要に応じてエラーを返す為に使用されます。 エラーレスポンスの {{domxref("Response.type","type")}} は <code>error</code> に設定されています。</p> +</div> + +<div class="note"> +<p><strong>Note</strong>: "エラー" <code>Response</code> は実際にスクリプトに公開されません。 {{domxref("GlobalFetch.fetch","fetch()")}} に対するそのような応答は、 promise を拒否します。</p> +</div> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox notranslate">var <em>errorResponse</em> = Response.error();</pre> + +<h3 id="引数">引数</h3> + +<p>無し</p> + +<h3 id="返り値">返り値</h3> + +<p>{{domxref("Response")}} オブジェクト</p> + +<h2 id="例">例</h2> + +<p>TBD (まだどこでもサポートされていません。)</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('Fetch','#dom-response-error','error()')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザー実装状況">ブラウザー実装状況</h2> + + + +<p>{{Compat("api.Response.error")}}</p> + +<h2 id="関連項目">関連項目</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/response/headers/index.html b/files/ja/web/api/response/headers/index.html new file mode 100644 index 0000000000..96dd993ea7 --- /dev/null +++ b/files/ja/web/api/response/headers/index.html @@ -0,0 +1,73 @@ +--- +title: Response.headers +slug: Web/API/Response/headers +tags: + - API + - Experimental + - Fetch + - Headers + - Property + - Reference + - Response +translation_of: Web/API/Response/headers +--- +<div>{{APIRef("Fetch")}}</div> + +<p>{{domxref("Response")}} インターフェイスの <code><strong>headers</strong></code> 読み取り専用プロパティはレスポンスに関連付けられた {{domxref("Headers")}} オブジェクトが含まれています。</p> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox notranslate">var <var>myHeaders</var> = <var>response</var>.headers;</pre> + +<h3 id="値">値</h3> + +<p>{{domxref("Headers")}} オブジェクト</p> + +<h2 id="例">例</h2> + +<p><a href="https://github.com/mdn/fetch-examples/tree/master/fetch-response">Fetch Response の例</a> ( <a href="http://mdn.github.io/fetch-examples/fetch-response/">Fetch Response live</a> を参照) では、 {{domxref("Request.Request","Request()")}} コンストラクタを使用して新しい {{domxref("Request")}} オブジェクトを作成し、 JPG のパスを渡します。次に {{domxref("GlobalFetch.fetch","fetch()")}} を使用してこのリクエストをフェッチし、 {{domxref("Body.blob")}} を使用してリクエストから blob を抽出し、 {{domxref("URL.createObjectURL")}} を使用してオブジェクトURLを作成し、これを {{htmlelement("img")}} に表示します。</p> + +<p><code>fetch()</code> ブロックの上部でレスポンス <code>headers</code> の値をコンソールに記録している事に注意して下さい。</p> + +<pre class="brush: js notranslate">var myImage = document.querySelector('img'); + +var myRequest = new Request('flowers.jpg'); + +fetch(myRequest).then(function(response) { + console.log(response.headers); // returns a Headers{} object + response.blob().then(function(myBlob) { + var objectURL = URL.createObjectURL(myBlob); + myImage.src = objectURL; + }); +});</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('Fetch','#dom-response-headers','headers')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td>初回定義</td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザーの互換性">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.Response.headers")}}</p> + +<h2 id="関連項目">関連項目</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/response/index.html b/files/ja/web/api/response/index.html new file mode 100644 index 0000000000..3884020535 --- /dev/null +++ b/files/ja/web/api/response/index.html @@ -0,0 +1,128 @@ +--- +title: Response +slug: Web/API/Response +tags: + - API + - Experimental + - Fetch + - Fetch API + - Interface + - Reference + - Response +translation_of: Web/API/Response +--- +<div>{{APIRef("Fetch API")}}</div> + +<p><a href="/ja/docs/Web/API/Fetch_API">Fetch API</a> の <strong><code>Response</code></strong> インターフェイスは、リクエストのレスポンスを表します。</p> + +<p>{{domxref("Response.Response()")}} コンストラクタを使い、新しい Response オブジェクトを作ることができます。しかし、ServiceWorker の {{domxref("Fetchevent.respondWith")}} や {{domxref("GlobalFetch.fetch()")}} などのように、他のAPIからResponseオブジェクトが返されるのをより頻繁に目にするでしょう。</p> + +<h2 id="コンストラクタ">コンストラクタ</h2> + +<dl> + <dt>{{domxref("Response.Response","Response()")}}</dt> + <dd>新しい <code>Response</code> オブジェクトを返します。</dd> +</dl> + +<h2 id="プロパティ">プロパティ</h2> + +<dl> + <dt>{{domxref("Response.headers")}} {{readonlyinline}}</dt> + <dd>レスポンスに関連した {{domxref("Headers")}} オブジェクトを含む。</dd> + <dt>{{domxref("Response.ok")}} {{readonlyinline}}</dt> + <dd>レスポンスが成功(200-299 の範囲のステータス)したか否かを通知する boolean 値を含む。</dd> + <dt>{{domxref("Response.redirected")}} {{ReadOnlyInline}}</dt> + <dd>レスポンスがリダイレクトの結果であるかどうかを示します。 つまり、その URL リストには複数のエントリーがあります。</dd> + <dt>{{domxref("Response.status")}} {{readonlyinline}}</dt> + <dd>HTTPステータスコードを返す。(例:200 成功)</dd> + <dt>{{domxref("Response.statusText")}} {{readonlyinline}}</dt> + <dd>ステータスコードに対応したステータスメッセージを含む(たとえば、200 で OK)。</dd> + <dt>{{domxref("Response.type")}} {{readonlyinline}}</dt> + <dd>レスポンスのタイプを示す。(例:basic,cors)</dd> + <dt>{{domxref("Response.url")}} {{readonlyinline}}</dt> + <dd>レスポンスのURLを返す。</dd> + <dt>{{domxref("Response.useFinalURL")}}</dt> + <dd>レスポンスの最後の URL かどうかを通知する boolean 値を含む。</dd> +</dl> + +<p><code>Response</code> は {{domxref("Body")}} を実装しているため、次のプロパティも使用可能です:</p> + +<dl> + <dt>{{domxref("Body.body")}} {{readonlyInline}}</dt> + <dd>コンテンツのボディを示す {{domxref("ReadableStream")}} の単純なゲッターです。</dd> + <dt>{{domxref("Body.bodyUsed")}} {{readonlyInline}}</dt> + <dd>レスポンスで body が既に使用されているかどうかを示す {{domxref("Boolean")}} 値を保持する。</dd> +</dl> + +<h2 id="メソッド">メソッド</h2> + +<dl> + <dt>{{domxref("Response.clone()")}}</dt> + <dd><code>Response</code> オブジェクトのクローンを生成する。</dd> + <dt>{{domxref("Response.error()")}}</dt> + <dd>ネットワークエラーに関連した新しい <code>Response</code> オブジェクトを返す。</dd> + <dt>{{domxref("Response.redirect()")}}</dt> + <dd>異なる URL で新しい response を生成する</dd> +</dl> + +<p><code>Response</code> は {{domxref("Body")}} を実装しているため、次のメソッドも使用可能です:</p> + +<dl> + <dt>{{domxref("Body.arrayBuffer()")}}</dt> + <dd>{{domxref("Response")}} ストリームを取得し、それを完全に読み込む。これは、{{domxref("ArrayBuffer")}} で解決する promise を返す。</dd> + <dt>{{domxref("Body.blob()")}}</dt> + <dd>{{domxref("Response")}} ストリームを取得し、それを完全に読み込む。これは、 {{domxref("Blob")}} で解決する promise を返す。</dd> + <dt>{{domxref("Body.formData()")}}</dt> + <dd>{{domxref("Response")}} ストリームを取得し、それを完全に読み込む。これは、 {{domxref("FormData")}} オブジェクトで解決する promise を返す。</dd> + <dt>{{domxref("Body.json()")}}</dt> + <dd>{{domxref("Response")}} ストリームを取得し、それを完全に読み込む。これは、 {{jsxref("JSON")}} オブジェクトで解決する promise を返す。</dd> + <dt>{{domxref("Body.text()")}}</dt> + <dd>{{domxref("Response")}} ストリームを取得し、それを完全に読み込む。これは、{{domxref("USVString")}} (text)で解決する promise を返す。</dd> +</dl> + +<h2 id="例">例</h2> + +<p><a href="https://github.com/mdn/fetch-examples/tree/gh-pages/basic-fetch">basic fetch example</a> (<a href="http://mdn.github.io/fetch-examples/basic-fetch/">run example live</a>) では image を取得するために単純な <code>fetch()</code> を使用し、それを {{htmlelement("img")}} タグの中に入れて表示しています。<code>fetch()</code> はプロミスを返し、then の引数として Response オブジェクトを渡します。image をリクエストするとき、レスポンスに正しい MIME タイプを設定するために、{{domxref("Body.blob")}}({{domxref("Response")}} は body を実装しています)を実行する必要があることに注意してください。</p> + +<pre class="brush: js">var myImage = document.querySelector('.my-image'); +fetch('flowers.jpg').then(function(response) { + return response.blob(); +}).then(function(blob) { + var objectURL = URL.createObjectURL(blob); + myImage.src = objectURL; +});</pre> + +<p>カスタム <code>Response</code> オブジェクトを生成するために、{{domxref("Response.Response()")}} コンストラクタを使用することもできます:</p> + +<pre class="brush: js">var myResponse = new Response();</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('Fetch','#response-class','Response')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザー実装状況">ブラウザー実装状況</h2> + + + +<p>{{Compat("api.Response")}}</p> + +<h2 id="関連項目">関連項目</h2> + +<ul> + <li><a href="/ja/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/ja/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/ja/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/response/redirect/index.html b/files/ja/web/api/response/redirect/index.html new file mode 100644 index 0000000000..3fe304bfc4 --- /dev/null +++ b/files/ja/web/api/response/redirect/index.html @@ -0,0 +1,85 @@ +--- +title: Response.redirect() +slug: Web/API/Response/redirect +translation_of: Web/API/Response/redirect +--- +<div>{{APIRef("Fetch")}}</div> + +<p>{{domxref("Response")}} インターフェイスの <strong><code>redirect()</code></strong> メソッドは、指定されたURLへのレダイレクトをもたらす <code>Response</code> を返します。</p> + +<div class="note"> +<p><strong>Note</strong>: これは主に <a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a> に関連しています。制御service worker は、ページのリクエストを中断し、必要に応じてリダイレクトできます。もし Service worker が上流に送信を行うと、実際に本当のリダイレクトが発生します。</p> +</div> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox notranslate">var <em>response</em> = Response.redirect(<em>url</em>, <em>status</em>);</pre> + +<h3 id="引数">引数</h3> + +<dl> + <dt><code>url</code></dt> + <dd>新しい reponse の発信元URL。</dd> + <dt><code>status</code> {{optional_inline}}</dt> + <dd>response のオプションのステータスコード (例 <code>302</code> )</dd> +</dl> + +<h3 id="返り値">返り値</h3> + +<p>{{domxref("Response")}} オブジェクト</p> + +<h3 id="例外">例外</h3> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">例外</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>RangeError</code></td> + <td>指定されたステータスはリダイレクトステータスではありません。</td> + </tr> + <tr> + <td><code>TypeError</code></td> + <td>指定されたURLは無効です。</td> + </tr> + </tbody> +</table> + +<h2 id="例">例</h2> + +<pre class="brush: js notranslate">responseObj.redirect('https://www.example.com', 302);</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('Fetch','#dom-response-redirect','redirect()')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザー実装状況">ブラウザー実装状況</h2> + + + +<p>{{Compat("api.Response.redirect")}}</p> + +<h2 id="関連項目">関連項目</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/response/response/index.html b/files/ja/web/api/response/response/index.html new file mode 100644 index 0000000000..d61b3de4f3 --- /dev/null +++ b/files/ja/web/api/response/response/index.html @@ -0,0 +1,75 @@ +--- +title: Response() +slug: Web/API/Response/Response +translation_of: Web/API/Response/Response +--- +<div>{{APIRef("Fetch")}}</div> + +<p><code><strong>Response()</strong></code> コンストラクターは、新しい {{domxref("Response")}} オブジェクトを生成します。</p> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox">var <var>myResponse</var> = new Response(<var>body</var>, <var>init</var>);</pre> + +<h3 id="引数">引数</h3> + +<dl> + <dt><em>body</em> {{optional_inline}}</dt> + <dd><em>body</em>オブジェクトに<em>は、</em>レスポンスの本体を定義する。なお、これは <code>null</code> でも問題ない: + <ul> + <li>{{domxref("Blob")}}</li> + <li>{{domxref("BufferSource")}}</li> + <li>{{domxref("FormData")}}</li> + <li>{{domxref("ReadableStream")}}</li> + <li>{{domxref("URLSearchParams")}}</li> + <li>{{domxref("USVString")}}</li> + </ul> + </dd> + <dt><em>init</em> {{optional_inline}}</dt> + <dd>レスポンスに適用したオプションで、カスタム設定したい場合の可能なオプションは、次のとおりです。: + <ul> + <li><code>status</code>: レスポンス[応答]のステータスコードです。(例: <code>200</code>)</li> + <li><code>statusText</code>: ステータスメッセージは次のようなものです。(例:<code>OK</code>など)</li> + <li><code>headers</code>: レスポンス[応答]に追加するヘッダーは、{{domxref("ByteString")}} のキーと値のペアか、もしくは{{domxref("Headers")}} 、または文字どおりの状態で含まれます。(詳細は、<a href="/en-US/docs/Web/HTTP/Headers">HTTP headers</a>を参照)</li> + </ul> + </dd> +</dl> + +<h2 id="例">例</h2> + +<p>In our <a href="https://github.com/mdn/fetch-examples/tree/master/fetch-response">Fetch Response example</a> (see <a href="http://mdn.github.io/fetch-examples/fetch-response/">Fetch Response live</a>) we create a new <code>Response</code> object using the constructor, passing it a new {{domxref("Blob")}} as a body, and an init object containing a custom <code>status</code> and <code>statusText</code>:</p> + +<pre class="brush: js">var myBlob = new Blob(); +var init = { "status" : 200 , "statusText" : "SuperSmashingGreat!" }; +var myResponse = new Response(myBlob,init);</pre> + +<h2 id="仕様">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('Fetch','#dom-response','Response()')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザーの対応">ブラウザーの対応</h2> + + + +<p>{{Compat("api.Response.Response")}}</p> + +<h2 id="関連情報">関連情報</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/response/usefinalurl/index.html b/files/ja/web/api/response/usefinalurl/index.html new file mode 100644 index 0000000000..6f18f681d8 --- /dev/null +++ b/files/ja/web/api/response/usefinalurl/index.html @@ -0,0 +1,60 @@ +--- +title: Response.useFinalURL +slug: Web/API/Response/useFinalURL +tags: + - API + - Experimental + - Fetch + - Obsolete + - Property + - Reference + - Response + - useFinalURL +translation_of: Web/API/Response/useFinalURL +--- +<div>{{APIRef("Fetch")}}{{obsolete_header}}</div> + +<p>{{domxref("Response")}} インターフェイスの <strong><code>useFinalURL</code></strong> プロパティには、これが response の最終URLかどうかを示すbook値が含まれています。</p> + +<div class="note"> +<p>このプロパティは <a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorkers</a> にのみに適用されます。他のコンテキストの場合、 <code>undefined</code> を返します。</p> +</div> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox notranslate">var <var>isfinalURL</var> = <var>Response</var>.useFinalURL;</pre> + +<h3 id="値">値</h3> + +<p>URLがリダイレクトでなく最終的なものかどうかを示す {{domxref("Boolean")}}</p> + +<h2 id="例">例</h2> + +<p>ページ <code>index.html</code> にあるスクリプトで考えてみます:</p> + +<pre class="brush: js notranslate">fetch('/test').then((r) => console.log(r.url))</pre> + +<p><code>test.html</code> は service worker <code>sw.js</code> によって制御されています:</p> + +<pre class="brush: js notranslate">onfetch = (e) => { + e.respondWith(fetch('/page2').then((r) => { + r.usefinalURL = true; + return r; + }) +}</pre> + +<p><code>usefinalURL</code> を設定すると、 response のURLが要求のURLに設定されないため、出力は <code>index.html</code> の <code>/test</code> ではなく <code>/page2</code> になります。</p> + +<h2 id="ブラウザーの互換性">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.Response.useFinalURL")}}</p> + +<h2 id="関連項目">関連項目</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> +</ul> |