apollographql/react-apolloArchived
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.
