クライアント中心のエラー処理-jsチュートリアル-php.cn

Client-Centered Error Handling

エラーの理解と処理

エラーを効果的に処理するには、発生する可能性のあるエラーの種類を理解することが不可欠です。まずは、発生する可能性のあるエラーを分類することから始めましょう。

Web クライアント環境におけるエラーの種類

ネットワークエラー

接続の問題: サーバーへの接続の確立に関する問題。
タイムアウト: リクエストが応答を受け取るまでに時間がかかりすぎます。
DNS エラー: ドメイン名解決に関する問題。
HTTP エラー: 404 Not Found、500 Internal Server Error などのエラー

サーバーAPIエラー

無効な応答: サーバーからの予期しないデータまたは不正なデータ。
認証エラー: ユーザーの認証または認可に関する問題。
レート制限: API 使用制限の超過による制限。

ユーザーのブラウザ環境エラー

ブラウザの互換性: ブラウザによる特定の機能の処理方法の違いから生じる問題。
JavaScript エラー: クライアント側の JavaScript コードのエラー。
リソース読み込みエラー: 画像、スクリプト、スタイルシートなどのリソースの読み込み時に問題が発生します。

その他のエラー

クライアント側エラー: ユーザーのデバイスまたはオペレーティングシステムに関連するエラー。
UI/UX エラー: リンク切れやレイアウトの誤りなど、ユーザーインターフェイスまたはユーザーエクスペリエンスに関する問題。

さまざまな種類のエラーが発生する可能性があります。ただし、これらのエラーは通常、次の 2 つのカテゴリに分類できます。

予期されるエラー: 発生と性質が事前にわかっているエラー。
予期しないエラー: 発生や性質が事前に不明なエラー。

これまで説明してきたエラーをこれらの分類に分類してみましょう。

エラーは予測できるかどうか?

予期されるエラー

明確なステータスコードを持つサーバー API から受信したエラーは、事前に予測して対処できるため、予想されるエラーと見なすことができます。

例えば、不正アクセス(401)や禁止アクセス(403)などのエラーに対して、状況に応じて適切に対処することができます。また、エラーに応答してアプリケーションロジックを管理するために、ステータスコードごとにさらに詳細なエラーコードを定義することも一般的です。これらは予期されるエラーと呼ばれます。

予期しないエラー

一方、500 範囲のサーバーエラーは、予測不可能であるため、予期しないエラー として分類されます。何らかの理由でサーバーが応答できない状況はいつでも発生する可能性があります。また、ユーザーのネットワーク環境やブラウザ環境によって発生する可能性のあるエラーは予測が難しいため、予期しないエラーとして分類されます。

ユーザーとエラー

エラーは、環境だけでなく、ユーザーとの対話に基づいて分類することもできます。エラーを分類する 1 つの方法は、ユーザーがエラーに対して何かできるかどうかを検討することです。この分類の基準は次のとおりです:

ユーザーが理解して解決できるエラー (ユーザーがアプリケーションを使い続けるのに役立つエラー)。
ユーザーが解決できないエラー (ユーザーに何の支援も提供しないエラー)。

解決可能なエラー

たとえば、認証または認可エラーがこのカテゴリに分類されます。ログインしていないユーザーは、401 ステータスエラーが発生する可能性があります。この場合、ログイン画面を提供するか、ログインが必要であることを示すメッセージを表示できます。

ユーザーが特定の画面にアクセスする権限を持っていない場合は、管理者からのアクセスをリクエストするようにユーザーを誘導できます。

ユーザーの放棄を歓迎する製品開発者はいません。エラーが発生したユーザーに状況を克服するためのガイダンスを提供することが不可欠です。たとえば、一時的なネットワークエラーに対する更新ボタンや、存在しないページにアクセスしたときに前の画面に戻るボタンを提供します。

解決できないエラー

ただし、エラー状況をユーザーに通知してもまったく役に立たない場合もあります。たとえば、低スペックのデバイスやブラウザでは動作しないコンポーネントがコードに含まれている場合、ユーザーはそれに対して何もすることができません。 (おそらく別のブラウザの使用を示唆するメッセージ?)

ケース 1 とケース 2 の両方に、メッセージの提供が含まれます。違いは、ケース 1 には、ユーザーに手順の実行を促すアクションまたはガイダンスが含まれていることです。

発生したエラーはユーザーが自分で解決できるものですか?

エラーの処理方法

では、発生したエラーにはどのように対処すればよいのでしょうか?エラーが発生した場合、アプリケーションはユーザーにどのようなインターフェイスを提供する必要がありますか?さまざまなタイプのエラーにその特性に基づいて対処する方法を見てみましょう。

予測不可能だが解決可能なエラー

典型的な例はネットワークエラーです。これらは、ユーザーのネットワーク環境に応じて、いつでも発生する可能性があります。最も簡単な解決策は、これが「一時的なエラー」であることをユーザーに通知し、前のアクションを再試行するためのガイダンスを提供することです。

誤差範囲

これらのエラーについては、アプリケーション全体に悪影響が及ばないようにすることが重要です。たとえば、アプリケーションが 1 つの画面で 10 個の API を呼び出した場合、1 つの API が失敗しても、アプリケーション全体でエラーメッセージがトリガーされることはなく、すべての呼び出しを再試行する必要があります。

代わりに、障害が発生した領域のみを回復することに重点を置きます。

予測不可能で解決できないエラー

これらは予期することが困難なエラーであり、簡単な解決策はありません。このようなエラーは開発中に最小限に抑える必要があり、エラーが発生した場合の処理計画を立てておく必要があります。ユーザーはこれらのエラーを自分で解決できないため、カスタマーサポートに簡単に連絡できる方法を提供することが必要になる場合があります。

監視

開発者の制御が及ばないエラーは、Sentry などのツールを使用して監視する必要があります。ユーザーがこれらのエラーに遭遇しないようにするには、これらのエラーを修正する必要があります。さらに、そのようなエラーが発生した場合にユーザーがアプリケーションに戻るメカニズムがあることを確認してください。

予測可能だが解決できないエラー

これらは既知のエラーであり、ユーザーが利用できる解決策はありません。ユーザーが自分で問題を解決できない場合は、エラー処理の機会を逃していることを意味します。ユーザーが意図的に異常なアクションを実行した場合、それはセキュリティ上の脆弱性の兆候である可能性があります。

セキュリティ関連のエラー

これらのエラーは、アプリケーションを悪用する悪意がある場合に発生します。これらは通常、セキュリティの脆弱性に起因するものであり、開発中に防止する必要があります。 CORS や XSS などの基本的なセキュリティの問題に対処し、セキュリティチームと協力して安全なアプリケーションを構築することが重要です。