マッピングファイルは、リクエストとレスポンスの配列を含むエントリの配列を含む JSON ファイルです。各リクエストは、単一のレスポンスに複数回マッピングできます。JSON は、HAR ファイルにあるようなエントリを持つ必要があります。以下の要素が必須です:
- リクエスト内の URL
- レスポンス内のステータスまたはリダイレクト URL
- GET呼び出しをマッピングしない場合は、リクエストの一部としてメソッドタイプを指定
URL には、ワイルドカードとして*を使用できます。これは、パターンにマッチするすべてのリクエストがキャッチされ、ファイル内のレスポンスにマッピングされることを意味します。
マッピングファイルはローカルに保存する必要があります。
マッピングファイルの有用な例
レスポンスに JSON オブジェクトを含むマッピングファイル
{ "entries": [ { "request": { "url": "*/urlRequestYouWantToMock/*?=yourQueryParam" }, "response": { "status": 200, "headers": [ { "name": "Content-Type", "value": "application/json; charset=utf-8" } ], "content": { "text": "{\"mock\": \"network\"}" } } } ]}メソッドを指定したマッピングファイル（GET 以外のマッピング用）
{ "entries": [ { "request": { "method": "POST", "url": "*/urlRequestYouWantToMock/*?=yourQueryParam" }, "response": { "status": 200, "headers": [ { "name": "Content-Type", "value": "application/json; charset=utf-8" } ], "content": { "text": "{\"mock\": \"network\"}" } } } ]}レスポンスにリダイレクト URL を含むマッピングファイル
{ "entries": [ { "request": { "url": "*/urlRequestYouWantToMock/*?=yourQueryParam" }, "response": { "redirectUrl": "https://www.google.com" } } ]}レスポンスにテキストを含むマッピングファイル
{ "entries": [ { "request": { "url": "*/urlRequestYouWantToMock/*?=yourQueryParam" }, "response": { "status": 200, "headers": [ { "name": "Content-Type", "value": "text/html; charset=UTF-8" } ], "content": { "text": "mock network" } } } ]}ログイン用のパススルー認証を有効にするマッピングファイルの作成
テストにサーバーへの認証情報の受け渡しを含むログインプロセスが含まれている場合、モックネットワーク上でテストを実行すると、ログインリクエストがタイムアウトするため、正しく動作しない可能性があります。この問題を解決するには、ログインリクエストとパススルー認証プロパティを有効にしたマッピングファイルを作成する必要があります。次の例は、ログインリクエストのパススルー認証を有効にします:
{ "entries": [ { "request": { "url": "https://your_app_domain/login/*" }, "response": { "passthrough": true } } ]}URL をログイン URL に置き換えてください。
マッピングファイルのアップロード
マッピングファイルをアップロードするには:
- テストプロパティペインで、カスタムマッピングファイルをアップロードをクリックします。
- 保存したカスタムマッピングファイルを見つけて、開くをクリックしてアップロードします。
- 保存をクリックして、アクティベートを保存します。
