Repolode
graphql

graphql/graphql-js

Референсная реализация GraphQL на JavaScript для создания типизированных схем и выполнения запросов в Node.js и браузерах.

Звёзды
20,340
Форки
2,089
Открытые issues
102
Последний коммит
9 часов назад

Что это?

GraphQL.js — написанная на JavaScript референсная реализация GraphQL — языка запросов для API, изначально созданного в Facebook. С её помощью можно описать типизированную схему, связанную с кодом, а затем выполнять запросы к этой схеме. Перед выполнением запросы проверяются на синтаксическую и семантическую корректность; некорректные запросы возвращают структурированные ошибки.

Библиотека публикуется в npm под именем `graphql` и работает как на серверах Node.js, так и в браузере. В её состав входят сборки CommonJS и ES modules, поэтому сборщики вроде webpack и rollup могут включать только используемые вами части. Браузерная IDE GraphiQL построена на её основе.

Пакет распространяется по лицензии MIT и поддерживается организацией graphql; для опубликованных версий действует политика поддержки, охватывающая основные релизы.

Ключевые возможности

  • 01Создание типизированной схемы GraphQL на основе JavaScript-объектов и функций-резолверов.
  • 02Проверка синтаксиса и семантики запросов перед выполнением с возвратом понятных ошибок.
  • 03Выполнение запросов с помощью функции `graphql`; резолверы могут возвращать значения или промисы.
  • 04Работа в Node.js и браузерах; доступны сборки CommonJS и ES modules.

Сценарии использования

  • Создание сервера GraphQL API на Node.js.
  • Добавление слоя GraphQL поверх существующих источников данных на JavaScript.
  • Использование инструментов GraphQL в браузере, например создание IDE наподобие GraphiQL.
  • Сборка клиентских или серверных бандлов с tree shaking, включающих только нужные функции.

Быстрый старт

  1. 1

    Установите GraphQL.js из npm

    npm install --save graphql
  2. 2

    Создайте схему и выполните запрос с помощью graphql({ schema, source })

Темы

Частые вопросы

Что такое graphql-js?
Референсная реализация GraphQL на JavaScript для создания типизированных схем и выполнения запросов в Node.js и браузерах. GraphQL.js — написанная на JavaScript референсная реализация GraphQL — языка запросов для API, изначально созданного в Facebook. С её помощью можно описать типизированную схему, связанную с кодом, а затем выполнять запросы к этой схеме. Перед выполнением запросы проверяются на синтаксическую и семантическую корректность; некорректные запросы возвращают структурированные ошибки.
graphql-js можно использовать бесплатно? Какая у него лицензия?
graphql-js распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
graphql-js всё ещё поддерживается?
Активно поддерживается. Последний коммит в graphql-js — 20 окт. 2026 г..
Для чего можно использовать graphql-js?
Создание сервера GraphQL API на Node.js. Добавление слоя GraphQL поверх существующих источников данных на JavaScript. Использование инструментов GraphQL в браузере, например создание IDE наподобие GraphiQL. Сборка клиентских или серверных бандлов с tree shaking, включающих только нужные функции.
Как установить graphql-js?
Установите GraphQL.js из npm: npm install --save graphql Создайте схему и выполните запрос с помощью graphql({ schema, source })
Где скачать graphql-js?
Исходный код и инструкции по установке — на GitHub: https://github.com/graphql/graphql-js

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты