API レスポンスをモックする 実機の上で

ダッシュボードのフィードを開き、そのエンドポイントへの実際のリクエストを見つけます。その行に復号済みのボディが表示されていれば準備完了です。ホストがまだ暗号化と表示されるなら、行のホスト操作か端末の設定から端末の SSL プロキシリストに追加し、呼び出しをもう一度発生させてください。暗号化されたまま通過するホストでは、エンフォーサーはホスト名しか一致させられません。パスは見えないので、パス単位の精密なモックは決して発火しません。

グローバルルールなら設定ナビゲーションから Blocks ページを開き、このスマートフォンだけに適用するルールなら端末を選んでから Blocks を開きます。ルールを追加し、メソッド（任意のメソッドに一致させるなら空欄）とパターンを入力します。パターンはブレークポイントと同じホスト＋パスのワイルドカードです。ホスト、スラッシュ、パス、そして変動するセグメントにはアスタリスクを置きます。

アクションを Mock に設定します。Block は呼び出しを失敗させるため、Drop はネットワークが消えたように見せるためのものですが、Mock は呼び出しを満たすためのものです。ステータス（既定は 200）、アプリが参照するヘッダー、そしてボディを設定します。アプリが解釈する Content-Type を与えてください。テキスト応答を受け取った JSON クライアントは 1 バイトも読む前に失敗します。JSON として保存すると、ルールは次のようになります。

ルールを保存してアプリを使います。次に一致したリクエストはキャプチャ経路から一度も出ることなく応答され、それでもフィードにはモック済みとして表示されるので、何が偽装されたかを正確に確認し、ルールが期待どおりに動いたことを確かめられます。アプリには普通のサーバー応答しか見えません。合成レスポンスには内部用や識別用のヘッダーが一切含まれないため、レスポンスの中に介在を示すものはありません。

終わったら有効スイッチでルールをオフにします。無効化されたルールはコストがかからず、次回のために形を保ちます。

モックの中には 1 回だけ起きなければならないものがあります。典型例は、トークンが期限切れになったとアプリに思わせてリフレッシュフローを走らせる合成 401 です。すべてのリクエストにそう応答すると、アプリはリフレッシュして再試行し、また 401 を受け取り、永遠に回り続けます。Max runs フィールドはルールが発火できる回数を制限します。上限に達すると自動で無効化され、エディタには自動無効化のバッジが表示されます。自分でオフにしたルールとは区別されます。

カウントは端末ごとに記録され、再接続やアプリの再起動をまたいで保持されるので、上限 1 のルールはそのスマートフォンで通算 1 回だけ発火し、セッションごとではありません。上限付きのグローバルルールは、上限を使い切った端末でのみ抑止され、フリート内の他のすべてのスマートフォンでは発火し続けます。BusyBro に自然言語で、あるホストへの 1 回限りのモック 401 を頼むこともでき、同じルールを書いてくれます。

Mock のボディは固定された 1 つの文字列です。応答をリクエストに依存させる必要があるとき、たとえば ID をそのまま返す、タイムスタンプを入れる、実際の応答の 1 フィールドだけ書き換えるといった場合は、ルールのアクションを Script に切り替えるか、Settings、Scripts の順に開いて独立したスクリプトを作成します。リクエスト、レスポンス、ヘルパーオブジェクトの補完が効くコードエディタと、実際にキャプチャしたエントリに対してスクリプトを実行し、ライブ通信に触れずに前後の差分を表示する Test パネルが使えます。このドライランは本番プロキシと同一のサンドボックスを使うので、テストに通ることは本番で動くことを意味します。

例外を投げたりタイムアウトしたりしたスクリプトはフェイルオープンします。元のバイトがそのまま転送され、エントリはインスペクタでフラグ付けされるので、壊れたスクリプトが接続を詰まらせたりアプリに自身を露呈したりすることはありません。スクリプトはキャプチャ経路で任意のコードを実行するため、管理者階層です。