prisma-labs/graphql-request
Graphql Request
graphql-request is a lightweight, type-safe GraphQL client library for JavaScript that runs across browsers, Node.js, and other JavaScript environments. It provides a minimal HTTP client for sending queries and mutations, with a promise-based execution model that uses the native fetch API for cross-runtime compatibility without additional dependencies.
The client supports reusable selection set composition at runtime, allowing fragments to be shared across multiple requests to reduce duplication. It includes a plugin-based extension system for adding custom middleware, tracing, or file upload support, and offers configurable error policies that can return partial data alongside errors instead of throwing. TypeScript code generation creates fully typed client methods from GraphQL schemas, providing compile-time validation and autocompletion for inputs and outputs.
The library handles automatic custom scalar encoding and decoding during request and response processing, and supports partial error resolution through configurable policies. It is designed as a persistent client instance with a base URL and shared configuration to simplify repeated API calls.
Features
- GraphQL API Clients - Provides a lightweight, type-safe GraphQL client for making API calls from JavaScript applications.
- GraphQL Type Generators - Generates fully typed TypeScript client methods from GraphQL schemas for compile-time validation.
- GraphQL Clients - Provides a lightweight, type-safe HTTP client for sending GraphQL queries and mutations across any JavaScript runtime.
- GraphQL Selection Set Composition - Builds and composes GraphQL selection sets at runtime for reuse across multiple requests.
- Type-Safe Client Generators - Generates fully typed client methods from GraphQL schemas, providing compile-time validation and autocompletion for inputs and outputs.
- GraphQL Clients - Sends GraphQL documents to remote endpoints and returns results as promises with variables and headers.
- Composable Selection Sets - Provides runtime selection set composition for sharing fragments across multiple GraphQL requests.
- Runtime Selection Set Composition - Builds and merges GraphQL selection sets dynamically at runtime for reusable fragments across queries.
- Type-Safe API Integrations - Generates TypeScript client code with schema-reflective method names and fully typed inputs and outputs.
- Custom Scalar Marshaling - Automatically encodes and decodes custom GraphQL scalar types during request and response processing.
- GraphQL Partial Error Policies - Configures error handling to return partial data alongside errors instead of throwing on failure.
- Plugin-Based Client Extensions - Provides a modular plugin system for adding custom middleware, tracing, and file upload support.
- Client Plugin Pipelines - Extends client behavior through a modular plugin pipeline that intercepts requests and responses.
- Plugin-Based Client Middleware - Provides a modular plugin architecture for adding custom middleware, tracing, and file upload support.
- Selection Set Composers - Ships a runtime utility for composing and reusing GraphQL selection sets across multiple queries to reduce duplication.
- GraphQL Clients - A minimal GraphQL client for Node and browsers.
