APIテストのトラブルシューティング

APIテストが失敗した場合や予期しない結果が生じた場合に、問題を切り分けるためのステップについて説明します。

失敗したステップの調査

[テスト詳細] ページで失敗したステップをクリックすると、何が起きたか詳細な情報を得ることができます。

トラブルシューティングの手がかりとなるポイントには、以下のようなものがあります。

📘
変数とアサーションの再確認
JSONレスポンスボディからのアサーションや変数の割り当て時にステップが失敗する場合、APIテストエディターを開いて、JSONパスが正しいかどうかを確認します。

クラウド実行での変数の初期値と最終値を確認するには、[テスト詳細] ページで [すべて表示] をクリックします。

失敗したAPIテストが以前は成功していた場合、最後に成功したテストが参考になるかもしれません。個々のステップを調査して、2つの実行の間で異なる結果が生じた原因と思われる違いを特定します。

ステップで何が起きているかについて、詳細な情報が必要な場合は、デバッグのためにコンソールログ出力を追加できます。

APIテストの結果がローカル実行とクラウド実行で異なる場合は、mablがURLエンドポイントにアクセスできるかどうかを確認する必要があります。

パブリックインターネットからURLエンドポイントにアクセスできない場合、ネットワーク問題のトラブルシューティングと設定を行うための方法がいくつか考えられます。

ワークスペースで、エンドポイントへのアクセスにmabl Linkを使用している場合は、次の手順を実行します。

Link Agentがアクティブであることを確認する
- [ワークスペース設定] > [ネットワーク] にアクセスして、Link Agentがアクティブであることを確認します。
Link Agentを使用するように環境が設定されていることを確認する
- [テスト環境設定] > [アプリケーション] にアクセスします。
- Link Agentを使用すべき[環境]の横にある鉛筆アイコンをクリックします。環境の設定を変更するEdit environment ページが表示されます。
- Advanced セクションで、Use link agent ボックスがオンになっていることと、ドロップダウンでLink Agentが選択されていることを確認します。

APIテストがアドホックのクラウド実行では成功するのに、プラン実行では失敗する場合、プランの設定とアドホック実行の設定を比較します。

テストがプラン実行の一部であった場合、そのプランは [プラン] 列の上部に表示されます。プラン名をクリックすると、プランの詳細を確認できます。

APIテストがアドホック実行された場合、[テスト詳細] ページの [プラン] 列に「Ad hoc run」と表示されます。[すべて表示] リンクをクリックすると、アドホック実行の設定が表示されます。

トラブルシューティングの手がかりとなるポイントには、以下のようなものがあります。

コレクションがPostmanからインポートされたものである場合、その段階でテストが成功しているかどうかを確認します。成功している場合、Postmanの実行結果とmablの実行結果の間にどのような違いがあるかを確認します。