Repolode
graphql

graphql/graphql-js

Node.jsやブラウザで型付きスキーマを構築し、クエリを実行するための、GraphQLのJavaScriptリファレンス実装です。

スター
20,340
フォーク
2,089
未解決の Issue
102
最終コミット
9 時間前

これは何?

GraphQL.jsは、Facebookで開発されたAPI向けクエリ言語GraphQLのJavaScriptによるリファレンス実装です。コードに対応する型スキーマを定義し、そのスキーマに対するクエリを処理できます。クエリは実行前に構文と意味の両面で妥当性を検証され、無効な場合は構造化されたエラーが返されます。

このライブラリはnpmで`graphql`として公開されており、Node.jsサーバーとブラウザの両方で動作します。CommonJS版とES module版が用意されているため、webpackやrollupなどのバンドラーで、使用する部分だけを取り込めます。ブラウザ内で動作するIDEのGraphiQLも、GraphQL.jsを基盤として構築されています。

このパッケージはMITライセンスで提供され、graphql organizationのもとでメンテナンスされています。また、メジャーリリースを対象としたバージョンサポートポリシーが公開されています。

主な機能

  • 01JavaScriptのオブジェクトとresolver関数から、型付きのGraphQLスキーマを構築できます。
  • 02実行前にクエリの構文と意味を検証し、分かりやすいエラーを返します。
  • 03`graphql`関数でクエリを実行でき、resolverは値またはPromiseを返せます。
  • 04Node.jsとブラウザで動作し、CommonJS版とES module版が用意されています。

ユースケース

  • Node.jsでGraphQL APIサーバーを構築する。
  • 既存のJavaScriptデータソースの上にGraphQLレイヤーを追加する。
  • GraphiQLのようなIDEの構築など、ブラウザでGraphQLツールを利用する。
  • 使用する機能だけを含む、tree-shaking対応のクライアントまたはサーバーバンドルを作成する。

クイックスタート

  1. 1

    npmからGraphQL.jsをインストールする

    npm install --save graphql
  2. 2

    スキーマを作成し、graphql({ schema, source })でクエリを実行する

トピック

よくある質問

graphql-js とは?
Node.jsやブラウザで型付きスキーマを構築し、クエリを実行するための、GraphQLのJavaScriptリファレンス実装です。 GraphQL.jsは、Facebookで開発されたAPI向けクエリ言語GraphQLのJavaScriptによるリファレンス実装です。コードに対応する型スキーマを定義し、そのスキーマに対するクエリを処理できます。クエリは実行前に構文と意味の両面で妥当性を検証され、無効な場合は構造化されたエラーが返されます。
graphql-js は無料で使えますか?ライセンスは?
graphql-js は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
graphql-js は今もメンテナンスされていますか?
活発にメンテナンス中。graphql-js の最終コミットは 2026年10月20日 です。
graphql-js は何に使えますか?
Node.jsでGraphQL APIサーバーを構築する。 既存のJavaScriptデータソースの上にGraphQLレイヤーを追加する。 GraphiQLのようなIDEの構築など、ブラウザでGraphQLツールを利用する。 使用する機能だけを含む、tree-shaking対応のクライアントまたはサーバーバンドルを作成する。
graphql-js のインストール方法は?
npmからGraphQL.jsをインストールする: npm install --save graphql スキーマを作成し、graphql({ schema, source })でクエリを実行する
graphql-js はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/graphql/graphql-js

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト