Skip to content

Commit

Permalink
fetch() の記事へのリンクを一括更新
Browse files Browse the repository at this point in the history
  • Loading branch information
mfuji09 committed Sep 12, 2024
1 parent 567682d commit 50eb952
Show file tree
Hide file tree
Showing 11 changed files with 16 additions and 16 deletions.
8 changes: 4 additions & 4 deletions files/ja/web/api/baseaudiocontext/decodeaudiodata/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 用のオーディオソースを作成する際に推奨される方法です。この方法は、音声ファイルの断片的なデータではなく、完全なファイルデータに対してのみ動作します。

Expand All @@ -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}}
Expand All @@ -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/)したりすることができます。
Expand All @@ -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/)したりすることができます。
Expand Down
4 changes: 2 additions & 2 deletions files/ja/web/api/cache/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ l10n:

そしてこのコードは、 {{domxref("Cache.match()")}} を使用してすでにキャッシュ内に一致するフォントがあるかどうかを確認し、もしあれば、それを返します。一致するフォントがなかった場合は、コードはネットワークからフォントを取得して、 {{domxref("Cache.put()")}} を用いて取得したリソースをキャッシュします。

このコードは {{domxref("fetch()")}} の操作で発生する例外を処理します。なお、 HTTP のエラーレスポンス(404 など)はこの例外を発生させません。適切なエラーコードを持つ通常のレスポンスオブジェクトを返します。
このコードは {{domxref("Window/fetch", "fetch()")}} の操作で発生する例外を処理します。なお、 HTTP のエラーレスポンス(404 など)はこの例外を発生させません。適切なエラーコードを持つ通常のレスポンスオブジェクトを返します。

このコードスニペットでは、サービスワーカーで使用されるバージョン付きキャッシュのベストプラクティスも示しています。この例ではキャッシュが 1 つしかありませんが、キャッシュが複数でも同じアプローチが利用できます。これはキャッシュの一括指定識別子を、具体的なバージョン付けされたキャッシュ名に対応させます。このコードはまた、 `CURRENT_CACHES` で名前が指定されていないキャッシュをすべて削除します。

Expand Down Expand Up @@ -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` ヘッダーを含まず、クッキーを格納する操作も行われません。

## 仕様書

Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/cache/put/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) => {
Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/document/lastmodified/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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")}} レスポンスヘッダーを調べます。
## 仕様書
Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/fetchevent/request/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) => {
Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/fetchevent/respondwith/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 として使われます。

Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/formdata/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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")}} コンストラクターに直接渡すことも可能です。

Expand Down
4 changes: 2 additions & 2 deletions files/ja/web/api/html_dom_api/microtask_guide/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@ customElement.prototype.getData = (url) => {
};
```

これは、マイクロタスク内で `data` の設定と `load` イベントの発行の両方を処理させることで、節のバランスを取っています(`if` 節では `queueMicrotask()` を使い、 `else` 節では {{domxref("fetch()")}} が使うプロミスを使用する)。
これは、マイクロタスク内で `data` の設定と `load` イベントの発行の両方を処理させることで、節のバランスを取っています(`if` 節では `queueMicrotask()` を使い、 `else` 節では {{domxref("Window/fetch", "fetch()")}} が使うプロミスを使用する)。

#### 操作のバッチ化

Expand Down Expand Up @@ -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()` 操作にメッセージを追加することができます。

Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/htmlscriptelement/attributionsrc/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) です。

Expand Down
2 changes: 1 addition & 1 deletion files/ja/web/api/mediasource/endofstream/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ endOfStream(endOfStreamError)
- : 文字列で、ストリームの終わりに達したときに発生したエラーを表します。可能な値は次のとおりです。

- `network`
- : 再生を終了し、ネットワークエラーが発生したことを通知します。 これを使用して、メディアストリームに関連するカスタムエラーハンドラーを作成できます。 例えば、他のネットワーク要求とは別に、メディアチャンク要求を処理する関数があるとします。メディアチャンクを {{domxref("fetch()")}} リクエストしてネットワークエラーが発生した場合、 `endOfStream('network')` を呼び出し、 UI に説明的なメッセージを表示し、ネットワークリクエストをすぐに再試行するか、ネットワークが(何らかのポーリングで)復旧するまで待ちます。
- : 再生を終了し、ネットワークエラーが発生したことを通知します。 これを使用して、メディアストリームに関連するカスタムエラーハンドラーを作成できます。 例えば、他のネットワーク要求とは別に、メディアチャンク要求を処理する関数があるとします。メディアチャンクを {{domxref("Window/fetch", "fetch()")}} リクエストしてネットワークエラーが発生した場合、 `endOfStream('network')` を呼び出し、 UI に説明的なメッセージを表示し、ネットワークリクエストをすぐに再試行するか、ネットワークが(何らかのポーリングで)復旧するまで待ちます。
- `decode`
- : 再生を終了し、デコードエラーが発生したことを通知します。 これは、メディアデータの取得中に解析エラーが発生したことを示すために使用できます。 データが破損しているか、ブラウザーがデコード方法を知らないコーデックを使用してエンコードされている可能性があります。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ l10n:
- `embed`
- : このリクエストが {{HTMLElement("embed")}} 要素の `src` 属性によって開始された場合。
- `fetch`
- : このリクエストが {{domxref("fetch()")}} メソッドによって開始された場合。
- : このリクエストが {{domxref("Window/fetch", "fetch()")}} メソッドによって開始された場合。
- `frame`
- : このリクエストが {{HTMLElement("frame")}} 要素の読み込みによって開始された場合。
- `iframe`
Expand Down

0 comments on commit 50eb952

Please sign in to comment.