GraphiQL 6、画面を刷新しリクエスト送信の仕組みも変更

2026年11月11日 · BehindLines 編集部

ブラウザ上で GraphQL のクエリを書いて試すためのツール GraphiQL が、バージョン 6 になりました。Trevor Scheer 氏が 2026年11月7日に graphql.org のブログで公表した告知によると、この開発は GraphQL コミュニティ助成プログラムの資金で進められました。GitHub のリリースページでは、6.0.0 の日付は 11月1日とされています。

エディターを軸にした画面の再設計

エディターはバージョン 5 ですでに Monaco に切り替わっていました。バージョン 6 では、ナビゲーション、タブ、メニュー、ダイアログまで含めて作業画面全体を作り直しています。リリースノートには、ライトとダークのテーマ、エンドポイントバー、サイズ変更できるサイドパネル、ステータスバーが挙げられています。告知はさらに、キーボードのフォーカス表示が見やすくなったこと、アクセシビリティの自動チェックが他のテストと並んで実行されるようになったことを説明しています。

日常で役立つ三つの新機能

クエリビルダー:スキーマからフィールドを選ぶと、エディターに操作が書き込まれます。ビルダーとテキストを行き来でき、フィールドを再利用できるフラグメントに切り出したり、引数を変数に昇格させたりできます。
コレクション:操作に名前を付けて保存し、JSON として共有し、重複を作らずに取り込めます。初期状態ではブラウザーに保存され、組織は独自のストレージを接続できます。
三つのレスポンス表示:生の JSON、折りたたみ可能なツリー、テーブルです。選んだ表示は再読み込み後も保たれます。

fetcher に代わる transport API

最も技術的な変更は、リクエストの送り方です。新しい `transport` API は、結果とともに HTTP の情報(メソッド、ステータス、所要時間、レスポンスのサイズ)を返します。メソッドを選ぶために、まず OPTIONS リクエストを送り、`Allow` ヘッダーを読みます。読み取りの操作では QUERY を優先し、次に POST、その次に GET を選びます。探索に失敗した場合は POST に戻り、ミューテーションは常に POST です。プロジェクトは移行を勧めていますが、`fetcher` は引き続き使え、現時点では非推奨にとどまります。

更新の前に確認すべきこと

告知は互換性を損なう変更を一覧にせず、移行ガイドを案内しています。一方、リリースノートはいくつかを挙げています。graphql-js のバージョン 15 と 16.0 から 16.10 は対象外になり、Explorer プラグインはクエリビルダーに置き換えられ、`operationName` プロパティは削除され、従来の `--color-*` CSS 変数は画面のスタイルに効かなくなって OKLCH トークンに替わります。既存の組み込みについては、告知はまず移行ガイドから始めるよう勧めています。