Repolode
graphql

graphql/graphql-js

Implementación de referencia de GraphQL en JavaScript para crear esquemas tipados y ejecutar consultas en Node.js y navegadores.

Estrellas
20,340
Forks
2,089
Issues abiertos
102
Último commit
hace 9 horas

¿Qué es?

GraphQL.js es la implementación de referencia de GraphQL, el lenguaje de consultas para APIs creado originalmente en Facebook, y está escrito en JavaScript. Permite definir un esquema de tipos que se corresponde con tu código y luego atender consultas usando ese esquema. Antes de ejecutarse, las consultas se comprueban para verificar su validez sintáctica y semántica; las consultas no válidas devuelven errores estructurados.

La biblioteca se publica en npm como `graphql` y funciona tanto en servidores Node.js como en el navegador. Incluye compilaciones CommonJS y ES module, para que herramientas de empaquetado como webpack y rollup puedan incluir solo las partes que uses. El IDE GraphiQL para el navegador está construido sobre esta biblioteca.

El paquete cuenta con licencia MIT y lo mantiene la organización graphql, que publica una política de soporte de versiones para las versiones principales.

Funciones clave

  • 01Crear un esquema GraphQL tipado a partir de objetos JavaScript y funciones resolver.
  • 02Validar la sintaxis y la semántica de las consultas antes de ejecutarlas y devolver errores claros.
  • 03Ejecutar consultas con la función `graphql`, usando resolvers que pueden devolver valores o promesas.
  • 04Funciona en Node.js y navegadores, con compilaciones CommonJS y ES module.

Casos de uso

  • Crear un servidor de API GraphQL en Node.js.
  • Añadir una capa GraphQL sobre fuentes de datos JavaScript existentes.
  • Usar herramientas de GraphQL en el navegador, por ejemplo, para crear un IDE como GraphiQL.
  • Crear bundles de cliente o servidor con tree-shaking que incluyan solo las funciones que uses.

Inicio rápido

  1. 1

    Instala GraphQL.js desde npm

    npm install --save graphql
  2. 2

    Crea un esquema y ejecuta una consulta con graphql({ schema, source })

Temas

Preguntas frecuentes

¿Qué es graphql-js?
Implementación de referencia de GraphQL en JavaScript para crear esquemas tipados y ejecutar consultas en Node.js y navegadores. GraphQL.js es la implementación de referencia de GraphQL, el lenguaje de consultas para APIs creado originalmente en Facebook, y está escrito en JavaScript. Permite definir un esquema de tipos que se corresponde con tu código y luego atender consultas usando ese esquema. Antes de ejecutarse, las consultas se comprueban para verificar su validez sintáctica y semántica; las consultas no válidas devuelven errores estructurados.
¿graphql-js es gratuito? ¿Qué licencia tiene?
graphql-js es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿graphql-js sigue mantenido?
Mantenimiento activo. El último commit de graphql-js fue el 20 oct 2026.
¿Para qué puedo usar graphql-js?
Crear un servidor de API GraphQL en Node.js. Añadir una capa GraphQL sobre fuentes de datos JavaScript existentes. Usar herramientas de GraphQL en el navegador, por ejemplo, para crear un IDE como GraphiQL. Crear bundles de cliente o servidor con tree-shaking que incluyan solo las funciones que uses.
¿Cómo se instala graphql-js?
Instala GraphQL.js desde npm: npm install --save graphql Crea un esquema y ejecuta una consulta con graphql({ schema, source })
¿Dónde consigo graphql-js?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/graphql/graphql-js

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados