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 リクエスト:

例

fetch('https://api.example.com/data')
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));

この例では、fetch はデフォルトで GET リクエストを実行し、返された response は Response オブジェクトです。.json() メソッドを呼び出すことで、JSON データを解析します。

2. POST リクエストを送信する:

例

fetch('https://api.example.com/data', {
    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. レスポンスステータスを処理する:

例

fetch('https://api.example.com/data')
    .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. 資格情報を含むリクエストを送信する:

例

fetch('https://api.example.com/data', {
    credentials: 'include' // リクエストに cookies を含める
});

credentials: 'include' を使用すると、クロスドメインリクエストで cookies を送信できます。

5. Request オブジェクトと Response オブジェクトを使用する:

例

const request = new Request('flowers.jpg');
fetch(request)
    .then(response => response.blob())
    .then(imageBlob => {
        const imageObjectUrl = URL.createObjectURL(imageBlob);
        img.src = imageObjectUrl;
    });

Request オブジェクトを作成してリクエストをカスタマイズできます。fetch は Response オブジェクトを返すので、それを使用して blob、text、json などのさまざまなタイプのレスポンスボディを取得できます。

6. エラーハンドリング:

例

fetch('https://api.example.com/data')
    .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 ヘッダー情報を追加できます。

例

fetch('https://example.com/api', {
    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 として扱わないため、レスポンスステータスの確認が依然として必要です。

例

fetch('https://example.com/api')
  .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 オブジェクトを使用して、フォームデータをサーバーに送信できます:

例

const formData = new 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 などの資格情報を送信するかどうかを指定することもできます。

例

fetch('https://example.com/api', {
    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 を次のように使用できます:

例

fetch('server.php?query=123')
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));

PHP 側では、リクエストパラメータを解析してレスポンスを返します:

例

<?php
// server.php
$queryString = $_SERVER['QUERY_STRING'];
parse_str($queryString, $params);
$responseData = array('status' => 'success', 'data' => $params);
echo json_encode($responseData);
?>

これで、クライアント側で Fetch API を使用して PHP バックエンドと通信できます。

その他の拡張