許可されたクライアントエラー
既知のクライアントエラーを許可されたクライアントエラーリストに追加して、特定のエラーが発生したときにテストとステップを引き続き実行できるようにします。レポートレベルを設定して、今後のテストでエラーが発生したときの 自動テストフレームワーク (ATF) の動作を指定します。
クライアントエラーを許可するシナリオ
テスト設計者と開発者は、通常、クライアント側の JavaScript エラーを許可して、特定のタイプの既知の障害がテストの設計と結果に影響を与えないようにします。クライアントエラーが許可されるシナリオには、次のようなものがあります。
- 時間の制約
- 開発者が問題を調査して解決するまで、クライアントエラーを一時的に許可します。たとえば、長期にわたるバグを含む古いフォームをテストする場合などです。
- 古いライブラリの影響を最小限に抑える
- 修正することができない、または将来のテスト実行への影響を排除するために操作に重要でないクライアントエラーを無視します。たとえば、古いライブラリーのバグを見つけたときなどです。
- テストデザインの時間
- テストを作成してエラーを調査するまで、一時的にクライアントエラーを許可します。たとえば、開発者の１人がUIポリシーを変更し、その変更によってエラーが発生します。
- プラットフォームのバグの可能性
- 修正が利用可能になるまで、一時的にクライアントエラーを許可します。プラットフォームのバグをServiceNowテクニカルサポートにレポートする前に、エラーを調査し、カスタマイズエラーではないことを確認し、関連するプラットフォームのバグの種類を特定します。たとえば、UIポリシーはテスト中にエラーを生成します。調査では、問題がカスタマイズエラーではないことが確認され、UIポリシーでプラットフォームの問題が特定されています。
注:
許可されたクライアントエラーリストにクライアントエラーを追加すると、テストフレームワークはテストを続行できますが、テストの合格は保証されません。 テストデザイナーと開発者は、常にクライアントエラーを調査して、ビジネスプロセスに問題があるかどうかを判断する必要があります。詳細については、「クライアントエラーの特定と解決」を参照してください。
許可されたクライアントエラーのレポートレベル
レポートレベルは、テストフレームワークが将来のエラーの発生を警告として報告するのか、それとも無視するのかを示します。許可されたエラーのレポートレベルはいつでも変更できます。たとえば、最初に警告としてエラーを追加した場合、後でレポートレベルを無視して変更するできます。
| レポートレベル | 説明 |
|---|---|
| Warning | 許可されたクライアントエラーを含むテストステップは、ステータスを [成功 (警告あり)] でレポートします。エラーメッセージがテスト結果出力に表示され、ステータスが [警告] でテストログに記録されます。 |
| 無視 | 許可されたクライアントエラーを含むテストステップは、ステータスを [成功] でレポートします。エラーは [無視] ステータスでテストログに記録されます。 |
合わせ手続き
自動テストフレームワーク (ATF) は、完全な文字列一致ではなく、包含検索を使用して、許可されたクライアントエラーを特定します。許可されたクライアントエラー [sys_atf_whitelist] レコードからのメッセージがクライアントエラーに含まれている場合、一致となります。たとえば、エラーメッセージ「テストメッセージ」に対して [無視] のレポートレベルで [許可されたクライアントエラー] レコードを作成すると、この文字列を含むすべてのクライアントエラーは無視されます。
注:
許可されたクライアントエラーレコードを作成または変更すると、クライアントテストランナーは自動的に更新されます。
クライアントエラーの特定と解決
クライアントエラーが発生すると、自動テストフレームワーク (ATF) はエラーが発生したときに実行されていたステップでテストに失敗します。