Svelte入門：SvelteKitでのエラー処理 -Vol.3-

用語解説

2024.11.08

この記事は約3分で読めます。

よっしー

こんにちは。よっしーです(^^)

今日は、SvelteKitでのエラー処.理について解説しています。

背景
エラー処理
Unexpected errors
おわりに

背景

SvelteKitでのエラー処理について調査する機会がありましたので、その時の内容を備忘として記事に残しました。

エラー処理

エラーはソフトウェア開発において避けられない事実です。SvelteKit は、エラーの発生場所、エラーの種類、受信したリクエストの性質に応じて、エラーを異なる方法で処理します。

Unexpected errors

予期しないエラーは、リクエストの処理中に発生するその他の例外のことです。これらは機密情報を含む可能性があるため、予期しないエラーメッセージやスタックトレースはユーザーに露出されません。

デフォルトでは、予期しないエラーはコンソール（または本番環境ではサーバーログ）に出力されます。一方、ユーザーに露出されるエラーは一般的な形式を持ちます：

{ "message": "Internal Error" }

予期しないエラーは handleError フックを通過します。ここで独自のエラーハンドリングを追加できます。例えば：

エラーをレポーティングサービスに送信する
カスタムエラーオブジェクトを返す（これが $page.error になります）

例えば：

/** @type {import('@sveltejs/kit').HandleServerError} */
export function handleError({ error, event }) {
  // エラーをレポーティングサービスに送信
  console.error(error);
  sendToErrorReportingService(error);

  // カスタムエラーオブジェクトを返す
  return {
    message: '予期しないエラーが発生しました。すみませんが、後でもう一度お試しください。',
    code: 'UNEXPECTED_ERROR',
    id: generateUniqueErrorId()
  };
}

このアプローチには以下のような利点があります：