Repolode
graphql

graphql/graphql-js

A implementação de referência do GraphQL em JavaScript, para criar schemas tipados e executar queries no Node.js e em navegadores.

Estrelas
20,340
Forks
2,089
Issues abertas
102
Último commit
há 9 horas

O que é?

GraphQL.js é a implementação de referência do GraphQL, a linguagem de consulta para APIs criada originalmente no Facebook e escrita em JavaScript. Com ela, você define um schema de tipos que mapeia para o seu código e, em seguida, atende queries com base nesse schema. Antes da execução, as queries são verificadas quanto à validade sintática e semântica; queries inválidas retornam erros estruturados.

A biblioteca é publicada no npm como `graphql` e funciona em servidores Node.js e no navegador. Ela inclui builds CommonJS e ES modules, permitindo que bundlers como webpack e rollup incluam apenas as partes usadas. O IDE no navegador GraphiQL é construído sobre ela.

O pacote é licenciado sob MIT e mantido pela organização graphql, que publica uma política de suporte a versões que abrange os principais lançamentos.

Recursos principais

  • 01Crie um schema GraphQL tipado a partir de objetos JavaScript e funções resolver.
  • 02Valide a sintaxe e a semântica das queries antes da execução, retornando erros claros.
  • 03Execute queries com a função `graphql`, usando resolvers que podem retornar valores ou promises.
  • 04Funciona no Node.js e em navegadores, com builds CommonJS e ES modules.

Casos de uso

  • Criar um servidor de API GraphQL em Node.js.
  • Adicionar uma camada GraphQL sobre fontes de dados JavaScript existentes.
  • Usar ferramentas GraphQL no navegador, como criar um IDE semelhante ao GraphiQL.
  • Criar bundles de cliente ou servidor com tree-shaking, incluindo apenas os recursos usados.

Início rápido

  1. 1

    Instale o GraphQL.js pelo npm

    npm install --save graphql
  2. 2

    Crie um esquema e execute uma consulta com graphql({ schema, source })

Tópicos

Perguntas frequentes

O que é graphql-js?
A implementação de referência do GraphQL em JavaScript, para criar schemas tipados e executar queries no Node.js e em navegadores. GraphQL.js é a implementação de referência do GraphQL, a linguagem de consulta para APIs criada originalmente no Facebook e escrita em JavaScript. Com ela, você define um schema de tipos que mapeia para o seu código e, em seguida, atende queries com base nesse schema. Antes da execução, as queries são verificadas quanto à validade sintática e semântica; queries inválidas retornam erros estruturados.
graphql-js é gratuito? Qual é a licença?
graphql-js é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
graphql-js ainda é mantido?
Manutenção ativa. O último commit de graphql-js foi em 20 de out. de 2026.
Para que posso usar graphql-js?
Criar um servidor de API GraphQL em Node.js. Adicionar uma camada GraphQL sobre fontes de dados JavaScript existentes. Usar ferramentas GraphQL no navegador, como criar um IDE semelhante ao GraphiQL. Criar bundles de cliente ou servidor com tree-shaking, incluindo apenas os recursos usados.
Como instalar graphql-js?
Instale o GraphQL.js pelo npm: npm install --save graphql Crie um esquema e execute uma consulta com graphql({ schema, source })
Onde consigo graphql-js?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/graphql/graphql-js

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados