PostmanでAPIのテスト自動化するときの初期化とカウンタ変数処理

APIのテストにPostmanを使えないか調べたときのメモ。ループで処理させたときのカウンタをどうするか悩んだけど、お風呂に入っているときに思いついた。お風呂すごい。

困ったこと

Postmanは言わずと知れたリクエストを簡単に送れるツール。たとえば、

• API: https://daipresents.wordpress.com/api?user=daiを投げて
• 返ってきたレスポンスを確認したい

ときに以下のように使う。

{{user}}で変数を使える。

Pre-request Scriptというタブでは、実行前のスクリプトをJavascriptで書ける。

Testsというタブでは、レスポンスのチェックを同じくJavascriptで書ける。Post-request Scriptみたいにも使える。

Postmanをつかって以下のようなフローを流したい。

1. ログインする
2. ログインしたユーザで購入する
3. 購入を１０回繰り返す

１と２はいいんだけど、３の「購入を１０回繰り返す」が難しい。

Postmanは１リクエスト１レスポンスのやりとりはすごく得意。さらに、Runnerを使えば連続でAPIを叩くことも可能。

Runnerは繰り返しも可能。Iterationに繰り返したい回数を入れれば繰り返してくれる。

ただ、繰り返しは、スクリプト単体かコレクションと呼ばれるスクリプトをまとめたフォルダごとに行えるっぽいので、先にも書いた

1. ログインする
2. ログインしたユーザで購入する
3. 購入を１０回繰り返す

３が難しい。１２３１２３１２３と実行はできるわけです。でも１２３３３３３３３・・・が多分できない。

調べてもいい情報が見つからなかったので、コレクションをわけて実行することにした。実行した各コレクションの結果をpostman.setEnvironmentVariable("key", "value");に保存しておけば、データをキープできるので、次に実行するコレクションで使える！

これをふまえて以下のようなコレクションを作成。

めんどうだけど、

1. 「000 SETUP」を１回実行
2. 「001 LOGIN」を１回実行
3. 「002 YOUR ACTION」を１０回実行

とやればやりたいことができた。

POSTMANを使った初期化例

適当にリクエストを投げるコマンドの中で（投げ先はどこでもいい）、postman.setEnvironmentVariable()を使って初期化。繰り返しで使いたいカウンター変数もここで初期化（０を設定）する。

設定した値をURLのクエリパラメタとして使いたい場合は、URLエンコードを忘れずに。

カウンタ変数をインクリメンタルする

以下、例。

Arrayに詰め込んだ文字列データをpostman.setEnvironmentVariable()すると"aaa,bbb,ccc"みたいな文字列になるみたいなので、environment.users.split(',')が必要だった。

カウンタ変数（ここではcounter）をとりだしてusers[counter]とすればプログラミングっぽくデータアクセスできる。

カウンタのインクリメントはpostman.setEnvironmentVariable("counter", counter + 1);で再設定すればOK。

TESTタブで tests["counter:" + counter] = true;のように書けば、実行結果にログっぽく出力できるのも工夫したところ。