graphql/express-graphqlArchived
Express Graphql
express-graphql is a GraphQL API server implementation and HTTP middleware that connects a GraphQL schema to an HTTP server. It provides a request parser to extract queries and variables from various content types and a context provider to inject HTTP request data and session state into resolver functions.
The library includes a browser-based interactive IDE that detects GET requests to serve an HTML interface for testing queries and inspecting responses. It also supports a custom execution pipeline, allowing for the override of default parsing, validation, execution, and error formatting functions.
The project covers API integration through middleware and request parameter parsing, alongside architecture for AST-based query validation and schema-based execution. It further provides mechanisms for response metadata extension and the application of validation rules to restrict specific fields or operations.
Features
- GraphQL API Implementations - Implements server-side GraphQL interfaces to allow clients to request specific data based on a schema.
- Resolver Context Injection - Injects HTTP request data and session state into GraphQL resolver functions for authentication and context management.
- GraphQL Resolver Contexts - Injects HTTP request data and session state into GraphQL resolver functions via a context provider.
- Middleware-Based Request Pipelines - Processes GraphQL queries within a modular middleware-based request-response pipeline.
- AST Validation - Applies structural validation by traversing the abstract syntax tree of a query to restrict specific fields or operations.
- Schema-Based Execution - Maps incoming network requests to a predefined GraphQL schema to resolve data through field-level functions.
- GraphQL Integration Middleware - Bridges GraphQL execution logic into web server frameworks as middleware for request processing.
- Express Integrations - Integrates GraphQL schema handling into Express applications via middleware.
- GraphQL HTTP Endpoints - Provides the primary mechanism to connect a GraphQL schema to an HTTP server for network-based data queries.
- GraphQL Request Processing - Provides a request processing system that parses GraphQL documents and maps them to underlying data sources for execution.
- GraphQL Schema Hosting - Deploys a defined GraphQL data schema to a web endpoint for network-based querying and mutation.
- GraphQL Servers - Provides a server implementation that processes network requests and resolves data using a GraphQL schema.
- GraphQL Request Parsing - Extracts queries, variables, and operation names from URL query strings and various POST body content types.
- Request Context Management - Manages the passing of user session data and authentication tokens from HTTP requests into resolvers.
- Interactive GraphQL IDEs - Detects browser-based GET requests to serve an interactive HTML interface for testing queries and headers.
- Execution Pipeline Overrides - Allows overriding default parsing, validation, execution, and error formatting functions with custom logic.
- GraphQL IDEs - Ships a built-in interactive IDE for exploring and testing GraphQL APIs directly in the browser.
- GraphQL Testing - Provides an interactive interface for running queries and inspecting responses during development.
- Embedded GraphQL IDEs - Ships an embedded GraphQL IDE within the server middleware for in-browser API exploration and testing.
