GraphQLフォーマッタ

使い方

このツールについて

GraphQL クエリと変数を整形し、構文エラーをチェックします。graphql formatter、graphql 整形で検索可能。

使い方

GraphQL クエリと変数（JSON）を入力するか、ファイルから読み込み。整形結果を表示・コピー。構文エラー時はエラー箇所を表示。

ユースケース

• GraphQL クエリの可読性向上 • 構文エラーのデバッグ • 変数（JSON）の整形 • API 開発時のクエリ確認

技術的な仕組み

■ GraphQL とは GraphQL は、API 用のクエリ言語およびスキーマ言語です。クライアントが必要なデータだけを指定して取得でき、REST のオーバーフェッチを避けられます。クエリ（query）、ミューテーション（mutation）、サブスクリプション（subscription）をサポートし、変数（Variables）でパラメータを渡せます。

よくある質問

Q: GraphQLの変数（variables）に対応していますか？

A: はい。クエリフィールドにクエリを、変数フィールドにJSON変数を貼り付けてください。それぞれ独立してフォーマットされ、構文エラーも個別に報告されます。

Q: どのようなGraphQLドキュメントに対応していますか？

A: クエリ・ミューテーション・サブスクリプション・フラグメント・スキーマ定義（SDL）すべてに対応しています。

Q: APIに送信する前のクエリ検証に使えますか？

A: GraphQL構文のチェック（波括弧の漏れ、不正なキーワードなど）は行いますが、特定のスキーマに対する検証は行いません。フィールド名の誤りは検出されません。

Q: IDEのフォーマット結果と異なるのはなぜですか？

A: フォーマッターによってスタイルの選択（フィールド間の空行など）が異なる場合があります。本ツールはgraphql-jsリファレンスライブラリの標準的なフォーマット規則に従っています。

Q: クエリはサーバーに送信されますか？

A: いいえ。すべてのフォーマットと構文チェックはブラウザ内で行われます。クエリや変数がサーバーに送られることはありません。