From 50eb9521b9070a315f5e9d618e92c3c32596bef6 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 8 Sep 2024 09:28:16 +0900 Subject: [PATCH] =?UTF-8?q?fetch()=20=E3=81=AE=E8=A8=98=E4=BA=8B=E3=81=B8?= =?UTF-8?q?=E3=81=AE=E3=83=AA=E3=83=B3=E3=82=AF=E3=82=92=E4=B8=80=E6=8B=AC?= =?UTF-8?q?=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../ja/web/api/baseaudiocontext/decodeaudiodata/index.md | 8 ++++---- files/ja/web/api/cache/index.md | 4 ++-- files/ja/web/api/cache/put/index.md | 2 +- files/ja/web/api/document/lastmodified/index.md | 2 +- files/ja/web/api/fetchevent/request/index.md | 2 +- files/ja/web/api/fetchevent/respondwith/index.md | 2 +- files/ja/web/api/formdata/index.md | 2 +- files/ja/web/api/html_dom_api/microtask_guide/index.md | 4 ++-- .../ja/web/api/htmlscriptelement/attributionsrc/index.md | 2 +- files/ja/web/api/mediasource/endofstream/index.md | 2 +- .../api/performanceresourcetiming/initiatortype/index.md | 2 +- 11 files changed, 16 insertions(+), 16 deletions(-) diff --git a/files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md b/files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md index c3bde80949a1a4..1aa0f2508552d6 100644 --- a/files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md +++ b/files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md @@ -8,7 +8,7 @@ l10n: {{ APIRef("Web Audio API") }} -`decodeAudioData()` は {{ domxref("BaseAudioContext") }} のメソッドで、 {{jsxref("ArrayBuffer")}} に書き込まれた音声ファイルデータを非同期にデコードするために使用されます。この場合、{{jsxref("ArrayBuffer")}} は {{domxref("fetch()")}}、{{domxref("XMLHttpRequest")}}、{{domxref("FileReader")}} などから読み込まれます。デコードされた {{domxref("AudioBuffer")}} は {{domxref("AudioContext")}} のサンプリングレートにリサンプリングされ、コールバックやプロミスに渡されます。 +`decodeAudioData()` は {{ domxref("BaseAudioContext") }} のメソッドで、 {{jsxref("ArrayBuffer")}} に書き込まれた音声ファイルデータを非同期にデコードするために使用されます。この場合、{{jsxref("ArrayBuffer")}} は {{domxref("Window/fetch", "fetch()")}}、{{domxref("XMLHttpRequest")}}、{{domxref("FileReader")}} などから読み込まれます。デコードされた {{domxref("AudioBuffer")}} は {{domxref("AudioContext")}} のサンプリングレートにリサンプリングされ、コールバックやプロミスに渡されます。 この方法は、オーディオトラックからウェブオーディオ API 用のオーディオソースを作成する際に推奨される方法です。この方法は、音声ファイルの断片的なデータではなく、完全なファイルデータに対してのみ動作します。 @@ -28,7 +28,7 @@ decodeAudioData(arrayBuffer, successCallback, errorCallback) ### 引数 - `arrayBuffer` - - : デコードする音声データが入った ArrayBuffer です。通常は {{domxref("fetch()")}}、{{domxref("XMLHttpRequest")}}、{{domxref("FileReader")}} から取得します。 + - : デコードする音声データが入った ArrayBuffer です。通常は {{domxref("Window/fetch", "fetch()")}}、{{domxref("XMLHttpRequest")}}、{{domxref("FileReader")}} から取得します。 - `successCallback` {{optional_inline}} - : デコードが完了すると呼び出されるコールバック関数です。このコールバックの引数は 1 つで、 {{domxref("AudioBuffer")}} であり _decodedData_ （デコードされた PCM 音声データ）を表します。通常は、デコードされたデータを {{domxref("AudioBufferSourceNode")}} に入れて、そこから再生したり、好きなように操作したりすることができます。 - `errorCallback` {{optional_inline}} @@ -44,7 +44,7 @@ _decodedData_ で履行される {{jsxref("Promise") }} オブジェクトです ### プロミスベースの構文 -この例では、 `loadAudio()` は {{domxref("fetch()")}} を使用して音声ファイルを取得し、それを {{domxref("AudioBuffer")}} にデコードします。そして、後で再生できるように `audioBuffer` をグローバル変数 `buffer` にキャッシュします。 +この例では、 `loadAudio()` は {{domxref("Window/fetch", "fetch()")}} を使用して音声ファイルを取得し、それを {{domxref("AudioBuffer")}} にデコードします。そして、後で再生できるように `audioBuffer` をグローバル変数 `buffer` にキャッシュします。 > **メモ:** [完全な例をライブで実行](https://mdn.github.io/webaudio-examples/decode-audio-data/promise/)したり、[ソースを表示](https://github.com/mdn/webaudio-examples/blob/main/decode-audio-data/promise/)したりすることができます。 @@ -67,7 +67,7 @@ async function loadAudio() { ### コールバックの構文 -この例では `loadAudio()` は {{domxref("fetch()")}} を用いて音声ファイルを取得し、コールバックベースの `decodeAudioData()` を用いて {{domxref("AudioBuffer")}} にデコードします。コールバックでは、デコードしたバッファーが再生されます。 +この例では `loadAudio()` は {{domxref("Window/fetch", "fetch()")}} を用いて音声ファイルを取得し、コールバックベースの `decodeAudioData()` を用いて {{domxref("AudioBuffer")}} にデコードします。コールバックでは、デコードしたバッファーが再生されます。 > **メモ:** [完全な例をライブで実行](https://mdn.github.io/webaudio-examples/decode-audio-data/callback/)したり、[ソースを表示](https://github.com/mdn/webaudio-examples/blob/main/decode-audio-data/callback/)したりすることができます。 diff --git a/files/ja/web/api/cache/index.md b/files/ja/web/api/cache/index.md index af3f66a3a18863..ea05fc0d74660a 100644 --- a/files/ja/web/api/cache/index.md +++ b/files/ja/web/api/cache/index.md @@ -46,7 +46,7 @@ l10n: そしてこのコードは、 {{domxref("Cache.match()")}} を使用してすでにキャッシュ内に一致するフォントがあるかどうかを確認し、もしあれば、それを返します。一致するフォントがなかった場合は、コードはネットワークからフォントを取得して、 {{domxref("Cache.put()")}} を用いて取得したリソースをキャッシュします。 -このコードは {{domxref("fetch()")}} の操作で発生する例外を処理します。なお、 HTTP のエラーレスポンス（404 など）はこの例外を発生させません。適切なエラーコードを持つ通常のレスポンスオブジェクトを返します。 +このコードは {{domxref("Window/fetch", "fetch()")}} の操作で発生する例外を処理します。なお、 HTTP のエラーレスポンス（404 など）はこの例外を発生させません。適切なエラーコードを持つ通常のレスポンスオブジェクトを返します。 このコードスニペットでは、サービスワーカーで使用されるバージョン付きキャッシュのベストプラクティスも示しています。この例ではキャッシュが 1 つしかありませんが、キャッシュが複数でも同じアプローチが利用できます。これはキャッシュの一括指定識別子を、具体的なバージョン付けされたキャッシュ名に対応させます。このコードはまた、 `CURRENT_CACHES` で名前が指定されていないキャッシュをすべて削除します。 @@ -172,7 +172,7 @@ self.addEventListener("fetch", (event) => { ### クッキーとキャッシュオブジェクト -[フェッチ API](/ja/docs/Web/API/Fetch_API) では {{httpheader("Set-Cookie")}} ヘッダーを、 {{domxref("Response")}} オブジェクトを {{domxref("fetch()")}} から返す前に削除することを要求しています。したがって、 `Response` は `Cache` へ格納されるとき `Set=Cookie` ヘッダーを含まず、クッキーを格納する操作も行われません。 +[フェッチ API](/ja/docs/Web/API/Fetch_API) では {{httpheader("Set-Cookie")}} ヘッダーを、 {{domxref("Response")}} オブジェクトを {{domxref("Window/fetch", "fetch()")}} から返す前に削除することを要求しています。したがって、 `Response` は `Cache` へ格納されるとき `Set=Cookie` ヘッダーを含まず、クッキーを格納する操作も行われません。 ## 仕様書 diff --git a/files/ja/web/api/cache/put/index.md b/files/ja/web/api/cache/put/index.md index c362186ae1b394..759772fb234487 100644 --- a/files/ja/web/api/cache/put/index.md +++ b/files/ja/web/api/cache/put/index.md @@ -10,7 +10,7 @@ l10n: **`put()`** は {{domxref("Cache")}} インターフェイスのメソッドで、キーと値のペアを現在の {{domxref("Cache")}} オブジェクトに追加することができます。 -多くの場合、やりたいことは、ただ 1 つ以上のリクエストを {{domxref("fetch()")}} して、その結果を直接キャッシュに追加するだけです。そのような場合は、{{domxref("Cache.add","Cache.add()")}} や {{domxref("Cache.addAll","Cache.addAll()")}} を使用した方がよいでしょう。 これらはこうした操作を 1 つ以上行うための一括操作関数であるためです。 +多くの場合、やりたいことは、ただ 1 つ以上のリクエストを {{domxref("Window/fetch", "fetch()")}} して、その結果を直接キャッシュに追加するだけです。そのような場合は、{{domxref("Cache.add","Cache.add()")}} や {{domxref("Cache.addAll","Cache.addAll()")}} を使用した方がよいでしょう。 これらはこうした操作を 1 つ以上行うための一括操作関数であるためです。 ```js fetch(url).then((response) => { diff --git a/files/ja/web/api/document/lastmodified/index.md b/files/ja/web/api/document/lastmodified/index.md index 143ad3a6e72e1b..146e64bba3bc64 100644 --- a/files/ja/web/api/document/lastmodified/index.md +++ b/files/ja/web/api/document/lastmodified/index.md @@ -80,7 +80,7 @@ if (Number.isNaN(lastVisit) || lastModif > lastVisit) { } ``` -外部ページが変更されたかどうかを知りたい場合、{{HTTPMethod("HEAD")}} リクエストを {{domxref("fetch()")}} API によって行い、{{HTTPHeader("Last-Modified")}} レスポンスヘッダーを調べます。 +外部ページが変更されたかどうかを知りたい場合、{{HTTPMethod("HEAD")}} リクエストを {{domxref("Window/fetch", "fetch()")}} API によって行い、{{HTTPHeader("Last-Modified")}} レスポンスヘッダーを調べます。 ## 仕様書 diff --git a/files/ja/web/api/fetchevent/request/index.md b/files/ja/web/api/fetchevent/request/index.md index 599b4e88fda0c2..1af56625ceb3bb 100644 --- a/files/ja/web/api/fetchevent/request/index.md +++ b/files/ja/web/api/fetchevent/request/index.md @@ -20,7 +20,7 @@ l10n: このコードスニペットは、[サービスワーカーのフェッチの例](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/prefetch/service-worker.js)からのものです（[フェッチの例をライブで実行](https://googlechrome.github.io/samples/service-worker/prefetch/)）。 {{domxref("ServiceWorkerGlobalScope.fetch_event", "onfetch")}} イベントハンドラーは、`fetch` イベントを待ち受けします。イベントが発生、{{domxref("FetchEvent.respondWith", "FetchEvent.respondWith()")}} に、制御されたページに戻すプロミスを渡します。 このプロミスは、{{domxref("Cache")}} オブジェクトで最初に一致した URL リクエストに解決されます。 一致が見つからない場合、コードはネットワークからレスポンスをフェッチします。 -このコードは、{{domxref("fetch()")}} 操作で発生した例外も処理します。 HTTP のエラーレスポンス（404 など）でも例外は発生しないことに注意してください。然るべきエラーコードが設定された通常のレスポンスオブジェクトを返します。 +このコードは、{{domxref("Window/fetch", "fetch()")}} 操作で発生した例外も処理します。 HTTP のエラーレスポンス（404 など）でも例外は発生しないことに注意してください。然るべきエラーコードが設定された通常のレスポンスオブジェクトを返します。 ```js self.addEventListener("fetch", (event) => { diff --git a/files/ja/web/api/fetchevent/respondwith/index.md b/files/ja/web/api/fetchevent/respondwith/index.md index 136ee6e9fd8fca..77aa873c835b25 100644 --- a/files/ja/web/api/fetchevent/respondwith/index.md +++ b/files/ja/web/api/fetchevent/respondwith/index.md @@ -25,7 +25,7 @@ Firefox 59 以降、サービスワーカーが {{domxref("FetchEvent.respondWit たいていのネットワークリクエストに対して、最終 URL を観測できないためこの変更は影響ありません。しかし、少しだけ関係する場合があります。 -- {{domxref("fetch()")}} が介入された場合、結果の {{domxref("Response.url")}} で最終 URL を観測できます。 +- {{domxref("Window/fetch", "fetch()")}} が介入された場合、結果の {{domxref("Response.url")}} で最終 URL を観測できます。 - [ワーカー](/ja/docs/Web/API/Web_Workers_API)スクリプトが介入された場合、最終 URL は [`self.location`](/ja/docs/Web/API/WorkerGlobalScope/location) をセットするのに使われ、ワーカースクリプトの相対 URL の代わりのベース URL として使われます。 - スタイルシートが介入された場合、最終 URL は相対的な {{cssxref("@import")}} 読み込みの代わりのベース URL として使われます。 diff --git a/files/ja/web/api/formdata/index.md b/files/ja/web/api/formdata/index.md index 5362448e71989e..7e78febcba5a6b 100644 --- a/files/ja/web/api/formdata/index.md +++ b/files/ja/web/api/formdata/index.md @@ -7,7 +7,7 @@ l10n: {{APIRef("XMLHttpRequest API")}} -**`FormData`** インターフェイスは、フォームフィールドおよびそれらの値から表現されるキーと値のペアのセットを簡単に構築する手段を提供します。これは {{domxref("fetch()")}}、{{domxref("XMLHttpRequest.send()")}}、{{domxref("navigator.sendBeacon()")}} の各メソッドを用いることで送信が可能です。エンコーディング型を `"multipart/form-data"` に設定した場合にフォームが使用するものと同じ形式を使用します。 +**`FormData`** インターフェイスは、フォームフィールドおよびそれらの値から表現されるキーと値のペアのセットを簡単に構築する手段を提供します。これは {{domxref("Window/fetch", "fetch()")}}、{{domxref("XMLHttpRequest.send()")}}、{{domxref("navigator.sendBeacon()")}} の各メソッドを用いることで送信が可能です。エンコーディング型を `"multipart/form-data"` に設定した場合にフォームが使用するものと同じ形式を使用します。 単純な `GET` の送信を用いる {{HTMLElement("form")}} が行うようなクエリー引数を生成したい場合は、{{domxref("URLSearchParams")}} コンストラクターに直接渡すことも可能です。 diff --git a/files/ja/web/api/html_dom_api/microtask_guide/index.md b/files/ja/web/api/html_dom_api/microtask_guide/index.md index 09d0f5cd3a9edf..c22b360bf158d0 100644 --- a/files/ja/web/api/html_dom_api/microtask_guide/index.md +++ b/files/ja/web/api/html_dom_api/microtask_guide/index.md @@ -141,7 +141,7 @@ customElement.prototype.getData = (url) => { }; ``` -これは、マイクロタスク内で `data` の設定と `load` イベントの発行の両方を処理させることで、節のバランスを取っています（`if` 節では `queueMicrotask()` を使い、 `else` 節では {{domxref("fetch()")}} が使うプロミスを使用する）。 +これは、マイクロタスク内で `data` の設定と `load` イベントの発行の両方を処理させることで、節のバランスを取っています（`if` 節では `queueMicrotask()` を使い、 `else` 節では {{domxref("Window/fetch", "fetch()")}} が使うプロミスを使用する）。 #### 操作のバッチ化 @@ -169,7 +169,7 @@ let sendMessage = (message) => { 配列に追加したメッセージが最初のものであれば、バッチを送信するマイクロタスクをキューに入れます。マイクロタスクは、いつものように、 JavaScript の実行パスが最上位に達したとき、コールバックを実行する直前に実行されます。つまり、その間に行われる `sendMessage()` のさらなる呼び出しは、メッセージをメッセージキューにプッシュしますが、マイクロタスクを追加する前に配列の長さをチェックするため、新しいマイクロタスクはキューに入れません。 -マイクロタスクが実行されるとき、それは潜在的に多くのメッセージが待っている配列を持っています。それは、 {{jsxref("JSON.stringify()")}} メソッドを使用して JSON としてそれをエンコードすることから始まります。その後、配列の内容が不要になったので、 `messageQueue` 配列を空にします。最後に、{{domxref("fetch()")}} メソッドを用いて、 JSON 文字列をサーバーに送信します。 +マイクロタスクが実行されるとき、それは潜在的に多くのメッセージが待っている配列を持っています。それは、 {{jsxref("JSON.stringify()")}} メソッドを使用して JSON としてそれをエンコードすることから始まります。その後、配列の内容が不要になったので、 `messageQueue` 配列を空にします。最後に、{{domxref("Window/fetch", "fetch()")}} メソッドを用いて、 JSON 文字列をサーバーに送信します。 これにより、イベントループの同じイテレーションの中で行われる `sendMessage()` のすべての呼び出しが、タイムアウトなどの他のタスクによって送信が遅れる可能性を排除して、同じ `fetch()` 操作にメッセージを追加することができます。 diff --git a/files/ja/web/api/htmlscriptelement/attributionsrc/index.md b/files/ja/web/api/htmlscriptelement/attributionsrc/index.md index b6a2000beeadb2..0ecf693bab7e00 100644 --- a/files/ja/web/api/htmlscriptelement/attributionsrc/index.md +++ b/files/ja/web/api/htmlscriptelement/attributionsrc/index.md @@ -13,7 +13,7 @@ l10n: サーバー側では、これはレスポンスで {{httpheader("Attribution-Reporting-Register-Source")}} または {{httpheader("Attribution-Reporting-Register-Trigger")}} ヘッダーを送信するトリガーとして用いられ、それぞれ JavaScript ベースの[属性ソース](/ja/docs/Web/API/Attribution_Reporting_API/Registering_sources#javascript-based_event_sources)または[属性トリガー](/ja/docs/Web/API/Attribution_Reporting_API/Registering_triggers#javascript-based_attribution_triggers)を登録します。どのレスポンスヘッダーを送り返すべきかは、登録を行った `Attribution-Reporting-Eligible` ヘッダーの値に依存します。 > [!NOTE] -> 他にも、JavaScript の属性ソースまたはトリガーは、{{domxref("fetch()")}} リクエストに `attributionReporting` オプションをつけて送信するか（`fetch()` 呼び出しで直接設定するか、`fetch()` 呼び出しに渡された {{domxref("Request")}} オブジェクトで）、{{domxref("XMLHttpRequest")}} で {{domxref("XMLHttpRequest.setAttributionReporting", "setAttributionReporting()")}} をリクエストオブジェクトについて呼び出したりすることもできます。 +> 他にも、JavaScript の属性ソースまたはトリガーは、{{domxref("Window/fetch", "fetch()")}} リクエストに `attributionReporting` オプションをつけて送信するか（`fetch()` 呼び出しで直接設定するか、`fetch()` 呼び出しに渡された {{domxref("Request")}} オブジェクトで）、{{domxref("XMLHttpRequest")}} で {{domxref("XMLHttpRequest.setAttributionReporting", "setAttributionReporting()")}} をリクエストオブジェクトについて呼び出したりすることもできます。 詳細は[属性レポート API](/ja/docs/Web/API/Attribution_Reporting_API) です。 diff --git a/files/ja/web/api/mediasource/endofstream/index.md b/files/ja/web/api/mediasource/endofstream/index.md index fdb84e47d0d37d..8db29c071de007 100644 --- a/files/ja/web/api/mediasource/endofstream/index.md +++ b/files/ja/web/api/mediasource/endofstream/index.md @@ -24,7 +24,7 @@ endOfStream(endOfStreamError) - : 文字列で、ストリームの終わりに達したときに発生したエラーを表します。可能な値は次のとおりです。 - `network` - - : 再生を終了し、ネットワークエラーが発生したことを通知します。 これを使用して、メディアストリームに関連するカスタムエラーハンドラーを作成できます。 例えば、他のネットワーク要求とは別に、メディアチャンク要求を処理する関数があるとします。メディアチャンクを {{domxref("fetch()")}} リクエストしてネットワークエラーが発生した場合、 `endOfStream('network')` を呼び出し、 UI に説明的なメッセージを表示し、ネットワークリクエストをすぐに再試行するか、ネットワークが（何らかのポーリングで）復旧するまで待ちます。 + - : 再生を終了し、ネットワークエラーが発生したことを通知します。 これを使用して、メディアストリームに関連するカスタムエラーハンドラーを作成できます。 例えば、他のネットワーク要求とは別に、メディアチャンク要求を処理する関数があるとします。メディアチャンクを {{domxref("Window/fetch", "fetch()")}} リクエストしてネットワークエラーが発生した場合、 `endOfStream('network')` を呼び出し、 UI に説明的なメッセージを表示し、ネットワークリクエストをすぐに再試行するか、ネットワークが（何らかのポーリングで）復旧するまで待ちます。 - `decode` - : 再生を終了し、デコードエラーが発生したことを通知します。 これは、メディアデータの取得中に解析エラーが発生したことを示すために使用できます。 データが破損しているか、ブラウザーがデコード方法を知らないコーデックを使用してエンコードされている可能性があります。 diff --git a/files/ja/web/api/performanceresourcetiming/initiatortype/index.md b/files/ja/web/api/performanceresourcetiming/initiatortype/index.md index 63fca7e4bca5ac..9437b6d3e8fd51 100644 --- a/files/ja/web/api/performanceresourcetiming/initiatortype/index.md +++ b/files/ja/web/api/performanceresourcetiming/initiatortype/index.md @@ -29,7 +29,7 @@ l10n: - `embed` - : このリクエストが {{HTMLElement("embed")}} 要素の `src` 属性によって開始された場合。 - `fetch` - - : このリクエストが {{domxref("fetch()")}} メソッドによって開始された場合。 + - : このリクエストが {{domxref("Window/fetch", "fetch()")}} メソッドによって開始された場合。 - `frame` - : このリクエストが {{HTMLElement("frame")}} 要素の読み込みによって開始された場合。 - `iframe`