fetch をしっかり学んでみる

2023.11.15

学びの共有

こんにちは、上條（mk-0A0）です。
Web 開発においてデータ通信の実装は避けて通れません。今まで私は GraphQL を使ったりプロジェクト既存の通信作法に従って実装することはあったのですが、基本の fetch については理解不足と感じたので、今回改めて調べてみます。

fetch の使い方

fetch は Web 標準の API なのでライブラリなどのインストールは必要ありません。
構文は以下の通りです。

fetch(resource, options)

resource にリクエストを送る URL を指定し、データを取得します。
以下は users.json から取得したデータを console で表示しているサンプルです。
fetch は Promise を返すため、then で繋げて非同期処理を書くことができます。then の引数には Response オブジェクトが格納されており、その中の json() を使うことで取得したデータを json にパースできます。

fetch("users.json").then((res) => {
  console.log("res", res);
  return res.json().then((json) => {
    json.map((user) => {
      console.log("user", `${user.name},${user.age}`);
    });
  });
});

fetch のメリット

デフォルトでキャッシュが効く

fetch はデフォルトでキャッシュを保持してくれるため、更新頻繁が低いページでは読み込みの時間が短縮され高速化に繋がります。キャッシュが必要な場面でキャッシュが効かないと、アクセスするたびにリソースをダウンロードするためページの描画に時間がかかってしまいます。

サービスワーカーで使用できる

サービスワーカーとは PWA の核となる技術で、web サイトをオフライン状態で利用可能にしたり、サイトのデータをキャッシュしておくことでページの高速化などが期待できるそうです。
サービスワーカーの使用 – Web API | MDN

今のところ触れる機会がないので、詳しくは必要になったときにまた調べてみようと思います。

fetch の注意点とその対策

キャッシュを使いたくない場合はオプションで設定が必要

メリットで「デフォルトでキャッシュが効く」と書きましたが、逆にキャッシュを使いたくない場合はオプションの cache で設定がいるので注意が必要です。
キャッシュにもいくつか種類があり、キャッシュを使わない場合は no-store を指定します。
そのほかの設定は Request オブジェクトの cache をご確認ください。

fetch(resource, { cache: 'no-store' })

ファイルアップロードの progress が取得できない

HTTP クライアントライブラリの axios ではファイルアップロードの progress が取得できるそうですが、fetch は取得できません。用途としては、ユーザーが画像などをアップロードした際にローディングが必要な場合などが挙げられます。
今のところこのような実装が必要な機会がないため、必要になったときに改めて調べてみようと思います。

リクエストを途中でキャンセルできない

fetch は一度送ったリクエストのキャンセルができません。先程 fetch は Promise を返すと書きましたが、Promise は成功 or 失敗なので、キャンセルの処理は AbortController を使って実装します。AbortController のインスタンスから取得できる signal を fetch のオプション signal に渡します。
こちらの記事に掲載されているコードを参考に挙動を確認してみました。console を見るとちゃんとキャンセルされていることが確認できます。

const controller = new AbortController();
const signal = controller.signal;
fetch("users.json", { signal: signal })
  .then((res) => {
    console.log("success", res);
  })
  .catch((err) => {
    console.log(`error: ${err.message}`);
  });

setTimeout(() => controller.abort(), 0);