React Apollo

React Apollo is a React-specific GraphQL data fetching library that binds Apollo Client to components through declarative hooks for queries, mutations, and subscriptions. It provides a declarative approach to GraphQL query execution where components declare their data requirements and automatically receive loading, error, and data states without managing request lifecycle code.

The library distinguishes itself through a normalized cache layer that deduplicates entities and serves repeated requests without network calls, combined with incremental result streaming via the @defer directive for partial query field delivery. It supports persisted operations safelisting for security, where approved queries are registered with the server so only pre-authorized operations are accepted. A fine-grained network status enumeration exposes distinct states for loading, refetching, polling, and pagination, enabling precise UI feedback.

The library offers provider-based client injection through a context provider at the component tree root, making the GraphQL client accessible to all descendant hooks. It includes configurable caching strategies with cache-first and network-only fetch policies, conditional query skipping using a type-safe token, and support for real-time subscriptions that push live data from the server without polling. Polling and refetch mechanisms allow queries to be re-executed at intervals or on demand, with partial error handling that can either discard all data on error or keep partial results when some fields fail.

Features

React GraphQL Hooks - Binds Apollo Client to React components with hooks for declarative GraphQL queries, mutations, and subscriptions.

Query Result Caching - Caches fetched query data locally so identical queries return instantly without making a network request.

Client Query Execution - Provides a declarative hook-based API for executing GraphQL queries and managing their lifecycle.

GraphQL Normalized Caches - Ships a normalized client-side cache that deduplicates GraphQL entities and serves repeated requests without network calls.

Provider-Based Clients - Wraps the component tree root with a provider that makes the GraphQL client accessible to all child components.

Context Provider Injection - Uses a React context provider at the component tree root to inject the GraphQL client into all descendant hooks.

Query Hooks - Ships React hooks that execute GraphQL queries and expose loading, error, and data states to components.

GraphQL Data Fetching - Fetches data from a GraphQL endpoint and automatically re-renders React components when that data changes.

Declarative GraphQL Lifecycles - Manages loading, error, and data states of GraphQL queries in React components without manual request lifecycle code.

Declarative Data Hooks - Provides declarative React hooks that automatically manage GraphQL query loading, error, and data states.

GraphQL Query Hooks - Executes GraphQL queries via React hooks and returns loading, error, and data states for UI rendering.

Manual Query Triggers - Defers GraphQL query execution until a manual trigger like a button click by returning an execution function from a hook.

GraphQL Subscriptions - Implements real-time GraphQL subscriptions that push live data from the server to React components without polling.

GraphQL Deferred Streams - Implements incremental query result streaming via the @defer directive for partial field delivery.

GraphQL Fetch Policies - Offers configurable fetch policies like cache-first and network-only to control how queries retrieve data.

Persisted Operation Enforcement - Supports persisted operations safelisting where approved queries are registered with the server for security.

Query Refetching - Triggers fresh GraphQL query execution in response to user actions, optionally with new variables.

GraphQL Deferred Fields - Implements the @defer directive for incremental delivery of GraphQL query fields as partial results.

GraphQL Query Polling - Re-executes GraphQL queries at intervals or on demand with distinct network statuses for each trigger type.

Polling and Refetching - Supports configurable polling intervals and on-demand refetching with distinct network statuses for each trigger type.

Data Polling - Re-executes GraphQL queries periodically at set intervals to keep displayed data near-real-time with the server.

apollographqlreact-apolloArchived

Features

Star history