Fetch API
Fetch API は、JavaScript を介してリソースを非同期的に要求できる、現代的で強力なネットワークリクエストツールです。従来の XMLHttpRequest オブジェクトを使用する必要はありません。
Fetch API は、HTTP リクエストを簡潔に送信し、サーバーのレスポンスを処理できます。
Fetch API は Promise に基づいて設計されており、非同期操作をより簡潔で理解しやすくなっています。
Fetch の利点:
- 基づいてPromises、コードがより簡潔で読みやすくなります。
- より良いエラーハンドリングメカニズム:ネットワークエラー(サーバーに接続できない場合など)の場合にのみ返し
catch、ステータスコードエラーではありません。 - JSON、テキスト、バイナリなど、複数のデータ形式をサポートします。
- クロスドメインリクエストを処理でき、
CORSメカニズム設定によって。
fetch の基本用法
fetch の構文は非常に簡潔で、最も基本的な形式は次のとおりです:
fetch(url)
.then(response => response.json()) // 解析 JSON 数据
.then(data => console.log(data)) // 处理数据
.catch(error => console.error('Error:', error)); // 错误处理
パラメータ:
- url:リクエストを送信する対象のURL。
- options(オプション):リクエストメソッド(GET、POST など)、リクエストヘッダー、リクエストボディなどを指定できます。
戻り値
Promise オブジェクトを返します。Promise はリクエスト成功時に Response オブジェクトを返し、リクエスト失敗時には拒否されます。
Fetch を使用する
1. 基本的な GET リクエスト:
例
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
この例では、fetch はデフォルトで GET リクエストを実行し、返された response は Response オブジェクトです。.json() メソッドを呼び出すことで、JSON データを解析します。
2. POST リクエストを送信する:
例
method: 'POST', // リクエストメソッドを指定
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
key: 'value'
})
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
ここでは、method を 'POST' に設定することで POST リクエストを送信し、リクエストボディ body に JSON 形式のデータを送信します。
3. レスポンスステータスを処理する:
例
.then(response => {
if (!response.ok) {
throw new Error('Network response was not ok ' + response.statusText);
}
return response.json();
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
レスポンスを処理する際、まずレスポンスステータスが成功かどうか(response.ok)を確認し、成功しない場合はエラーをスローします。
4. 資格情報を含むリクエストを送信する:
例
credentials: 'include' // リクエストに cookies を含める
});
credentials: 'include' を使用すると、クロスドメインリクエストで cookies を送信できます。
5. Request オブジェクトと Response オブジェクトを使用する:
例
fetch(request)
.then(response => response.blob())
.then(imageBlob => {
const imageObjectUrl = URL.createObjectURL(imageBlob);
img.src = imageObjectUrl;
});
Request オブジェクトを作成してリクエストをカスタマイズできます。fetch は Response オブジェクトを返すので、それを使用して blob、text、json などのさまざまなタイプのレスポンスボディを取得できます。
6. エラーハンドリング:
例
.then(response => {
if (response.ok) {
return response.json();
}
throw new Error('Something went wrong');
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
チェーン呼び出しでは、どこでスローされたエラーも .catch() によってキャッチされます。
7. リクエストヘッダーの設定
headers プロパティを使用して、Content-Type、Authorization など、リクエストにカスタム HTTP ヘッダー情報を追加できます。
例
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer your-token'
},
body: JSON.stringify({ name: 'John', age: 30 })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
8. 200 以外のレスポンスステータスの処理
fetch は、HTTP エラーステータス(404 や 500 など)を自動的に拒否された Promise として扱わないため、レスポンスステータスの確認が依然として必要です。
例
.then(response => {
if (!response.ok) { // レスポンスステータスを確認
throw new Error('Network response was not ok ' + response.statusText);
}
return response.json();
})
.then(data => console.log(data))
.catch(error => console.error('Fetch error:', error));
9. フォームデータの送信
FormData オブジェクトを使用して、フォームデータをサーバーに送信できます:
例
formData.append('username', 'John');
formData.append('email', 'john@example.com');
fetch('https://example.com/api/form', {
method: 'POST',
body: formData
})
.then(response => response.text())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
10. クロスドメインリクエスト
クロスドメインリクエストが必要な場合は、サーバー側で CORS(Cross-Origin Resource Sharing)を設定できます。フロントエンドでは、credentials オプションを使用して cookies などの資格情報を送信するかどうかを指定することもできます。
例
method: 'GET',
credentials: 'include' // クロスドメインリクエスト時に cookie を送信することを許可
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Fetch と PHP
PHP で AJAX リクエストを使用することは、他のバックエンド言語で AJAX を使用することと本質的に違いはありません。PHP スクリプトはサーバー側でリクエストを受信し、データを処理して、レスポンスを返します。
クライアント側の JavaScript コードは、Fetch API を使用してリクエストを送信し、レスポンスを処理します。
たとえば、GET リクエストを受け取り、データを返す PHP ファイル server.php がある場合、Fetch を次のように使用できます:
例
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
PHP 側では、リクエストパラメータを解析してレスポンスを返します:
例
// server.php
$queryString = $_SERVER['QUERY_STRING'];
parse_str($queryString, $params);
$responseData = array('status' => 'success', 'data' => $params);
echo json_encode($responseData);
?>
これで、クライアント側で Fetch API を使用して PHP バックエンドと通信できます。
その他の拡張