GraphQL リクエストの Query 名を表示する

GraphQL リクエストの Query 名を表示する のカバー画像

この短い記事では、GraphQL リクエストの QueryName を表示する方法を紹介します。

1. 課題

GraphQL リクエストの Query 名は URL に表示されないため、アプリのどのリクエストなのかを区別するのが非常に困難です。

この問題は、Charles Proxy や Fiddler などの他の Web デバッグプロキシツールでも起きます。

回避するには Body を開いて Query 名を確認する必要があり、手間がかかります。

GraphQL リクエストの Query 名を表示する
GraphQL リクエストの Query 名を表示する

2. GraphQL の QueryName を表示する

Proxyman は GraphQL 開発者のこうした悩みを理解しているため、メインのテーブルに QueryName の列を追加しました。

デフォルトでは、Proxyman が GraphQL リクエストかどうかを検出し、QueryName を抽出して表示します。

特別な操作は必要ありません。

GraphQL リクエストの Query 名を表示する
GraphQL リクエストの Query 名を表示する

3. 次のステップ

ヒント: アプリのコードで、すべての query と mutation に分かりやすいオペレーション名を付けてください。無名のオペレーションは、有用な名前が表示されない場合があります。名前が付いたら、テスト中のオペレーションでフィルタを追加し、ステータスコードやレスポンスボディのフィルタと組み合わせると、失敗を素早く見つけられます。


Proxyman は、iOS デバイス、iOS シミュレータ、Android デバイスの HTTPS 通信をキャプチャできる、高性能な macOS アプリです。

https://proxyman.com からダウンロードできます。

Noah Tran
Noah Tran

2026年7月18日 に改訂。 名前付きオペレーションの説明を明確にし、GraphQL のセッションを絞り込むためのヒントを追加しました。

GraphQL リクエストを見つけやすくする

Proxyman で GraphQL の通信をキャプチャし、オペレーション名を使って同じ URL への呼び出しを区別しましょう。

Proxyman をダウンロード