はじめに

先日、WEAR for iOSで使う新しいAPIクライアントを作ったのですが、その際に Charles for Mac がとても役に立ちました。

色々活躍してくれたのですが、特にシビれたのは レスポンスを書き換え出来る機能 です。

エラーハンドリング実装の際には大活躍してくれたので、この先忘れないためにも自分用のメモとしてQiitaに残しておきたいと思います。

使用するCharlesのバージョン

(1) Charlesを起動し、メニューバー内の [Proxy] > [BreakPoint Settings...] をクリックします。

(2) [Enable Breakpoint] にチェックを入れて、[Add] ボタンをクリックします。

(3) レスポンスを変更したいAPIのURLの詳細を入力します。各項目の説明は以下の通り。

ちなみに今回はレスポンスの変更のみなので [Response]にのみチェックを入れます。
入力が終わったらOKボタンをクリックします。

では、設定が完了したので早速APIを叩いて見ましょう。

下の図のようにBreakpointsタブが出来て、先ほど設定したAPIURLの全ての通信がレスポンスを受け取る直前の状態でストップします。

[Edit Response]をクリックすれば、レスポンスヘッダーやJSON Textを書き換えることが出来ます。

[Headers]をクリックすれば、レスポンスヘッダーを書き換えることが出来ます。このようにステータスコードの書き換えもモチのロン。

[JSON Text]をクリックすればJSONの中身も変更することが可能です。

書き換えが終わったら [Excute]ボタンをクリックします。
すると、先ほど変更したレスポンスを受け取るようになっているはずです。

(注意: タイムアウト時間を短めにしている人は長めに設定しておきましょう。レスポンスの変更時間がタイムアウト時間を超えてしまうとエラーを受け取ってしまうので。)

設定すれば、SSLの通信であってもiPhoneシミュレータや実機のレスポンスも書き換えることが出来ます。

これを入れておけば間違いなく通信周りの開発のスピードは捗ると思ったので、自分用にも1つポチることにしました。

全てのMacに標準で入っててほしい。素敵。