mablにPostmanコレクションをインポートすると、mablはリクエスト前処理用およびリクエスト後処理用スクリプトの各レベルが正しい順序でインポートされるようにします。この記事では、PostmanコレクションのスクリプトがmablのAPIテストにどのようにインポートされるかを説明します。
Postmanとmablにおけるスクリプトの比較
Postmanとmablはどちらも、プリリクエストスクリプトとポストリクエストスクリプトの実行をサポートしています。
- プリリクエストスクリプトは、リクエストが実行される前に実行されます。
- ポストリクエストスクリプトは、Postmanではテストスクリプトと呼ばれ、リクエストが実行された後に実行されます。
Postmanとmablの両方で、これらのリクエスト前処理用およびリクエスト後処理用スクリプトは、さまざまなレベルで設定できます。Postmanのスクリプトがどのようにインポートされるかを理解するには、まず異なるスクリプトレベルについて説明することが重要です。Postmanのスクリプトレベルとmablへのマッピングは、最終的に選択したインポート方法によって決まります。
Postmanスクリプトのレベル
| スクリプトの種類 | 説明 |
| コレクションレベルスクリプト | Postmanコレクション内のすべてのリクエストに適用されます |
| フォルダーレベルスクリプト | この設定は、そのフォルダー直下のすべてのリクエストに適用されます。入れ子になったフォルダー内のリクエストには適用されません。 |
| リクエストレベルスクリプト | 個々のリクエストに適用されます |
mablスクリプトレベル
| スクリプトレベル | 説明 |
| テストレベルスクリプト | APIリクエスト内のすべてのリクエストに適用されます |
| フロー レベルスクリプト | APIフロー内のすべてのリクエストに適用されます |
| リクエストレベルスクリプト | 個々のリクエストに適用されます |
mablへのPostmanスクリプトのインポート
インポートされたPostmanコレクションのスクリプトが正しい順序で実行されるように、ユーザーがコレクションを単一のテストとしてインポートするか、各フォルダーを個別のテストとしてインポートするかによって、mablによるスクリプトの結合方法は異なります。
単一のテストとしてインポートする
Postmanコレクション全体を単一のテストとしてインポートする場合、次のルールが適用されます。
- コレクションレベルのスクリプトは、テストレベルで追加される一度限りのAPIスニペットとなり、テスト内の各リクエストの前に実行されます。
- フォルダーレベルのスクリプトは再利用可能なAPIスニペットとなり、そのフォルダーの直接の子であるすべてのリクエストの前に追加されます。
個別のテストとしてインポートする
Postmanコレクション内のフォルダーを個別のテストとしてインポートする場合、直接の子リクエストを1つ以上持つ各フォルダーは、同じ子リクエストを持つ新しいAPIテストになります。mablはスクリプトの順序を維持するために次の更新を行います。
- コレクションレベルのスクリプトは再利用可能なスニペットとして保存されるため、インポートされたすべてのAPIテストで再利用できます。
- フォルダーレベルのスクリプトは、一度限りのスニペットとして保存されます。