エラーとステータスコードを処理する
response.ok を確認して失敗を処理します。
「エラーとステータスコードを処理する」はCoddyKit上の無料JavaScript Academyレッスンです。 これはレッスン3/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはJavaScript Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 JavaScript Academyコースには全4レッスンが含まれています。
Fetch は HTTP エラーで reject しない
意外と見落としやすい点があります。fetch が reject するのはネットワーク障害が発生した場合だけです。404 や 500 のレスポンスでも、Promise は正常に resolve されます。ステータスは自分で確認する必要があります。
response.ok の確認
response.ok が true になるのは、ステータスコードが 200〜299 の範囲にある場合だけです。HTTP エラーの検出に使用します。
const response = await fetch(url);
if (!response.ok) {
console.log("HTTP error:", response.status);
}ステータスコードの読み取り
response.status は数値のコードを返し、response.statusText は短いメッセージを返します。これらに応じて処理を分岐し、特定のケースに対応します。
if (response.status === 404) console.log("Not found");
if (response.status === 401) console.log("Unauthorized");ステータス不良時の throw
レスポンスが ok でない場合に Error を throw するのが、すっきりしたパターンです。これにより、ネットワーク障害と HTTP エラーの両方を 1 つの catch で処理できます。
if (!response.ok) {
throw new Error("Request failed: " + response.status);
}try/catch でラップする
async/await を使用する場合は、処理全体を try/catch で囲みます。ネットワークエラーは Promise を reject して catch に入り、throw した HTTP エラーも同様に処理されます。
try {
const res = await fetch(url);
if (!res.ok) throw new Error("Status " + res.status);
const data = await res.json();
} catch (err) {
console.log("Failed:", err.message);
}エラーの種類を区別する
fetch が reject された場合、通常はサーバーに到達できなかった、DNS に失敗した、または CORS によってブロックされたことを意味します。ok でないレスポンスは、サーバーは応答したもののエラーを返したことを意味します。必要に応じて、両者を異なる方法で処理します。
エラーボディの読み取り
API は、エラーの内容を説明する JSON を返すことがよくあります。役立つメッセージを表示できるよう、throw する前に読み取ります。
if (!res.ok) {
const errBody = await res.json().catch(() => ({}));
throw new Error(errBody.message || ("Status " + res.status));
}よく使うステータスコード
各グループを覚えておきましょう。2xx は成功、3xx はリダイレクト、4xx はクライアントエラー（送信内容に誤りがある）、5xx はサーバーエラー（サーバー側の問題）です。Fetch はほとんどのリダイレクトを自動的に追従します。
再利用可能なヘルパー
確認処理を 1 つのヘルパーに集約し、すべての呼び出し箇所で一貫したエラー処理を行えるようにします。
async function getJSON(url) {
const res = await fetch(url);
if (!res.ok) throw new Error("HTTP " + res.status);
return res.json();
}一時的な障害のリトライ
不安定なネットワークでは、5xx エラーやネットワークエラーが発生したときにリトライしてもよいでしょう。サーバーに過剰な負荷をかけないよう、リトライ回数は少なくし、遅延も追加します。
for (let i = 0; i < 3; i++) {
try { return await getJSON(url); }
catch (e) { if (i === 2) throw e; }
}ユーザーへの通知
UI 層でエラーを catch し、画面を空白にするのではなく、わかりやすいメッセージを表示します。未処理の reject によってリクエストの失敗を黙って見逃さないでください。
getJSON(url)
.then(render)
.catch(() => showToast("Could not load data"));クイックチェック
Fetch のエラー処理です。
まとめ
Fetch が reject するのはネットワーク障害だけなので、常に response.ok/response.status を確認し、ステータスが不良なら throw します。呼び出しを try/catch で囲み、メッセージのためにエラーボディを読み取り、確認処理をヘルパーに集約し、UI にはわかりやすいエラーを表示します。
よくある質問
「エラーとステータスコードを処理する」レッスンは無料ですか？
はい。「エラーとステータスコードを処理する」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、JavaScript Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 JavaScript Academyコースには全4レッスンが含まれています。
「エラーとステータスコードを処理する」で何を学びますか？
response.ok を確認して失敗を処理します。 ブラウザで直接実行するハンズオンコードでJavaScript Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
JavaScript Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのJavaScript Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン3/4です。
「エラーとステータスコードを処理する」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このJavaScript Academyレッスンでコードを書いて実行できますか？
はい。すべてのJavaScript Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- GET リクエストを送信する
- POST とデータの送信
- エラーとステータスコードを処理する
- AbortController でリクエストを中止する