Last updated: 2023-07-18
For up to date release notes, refer to the project's Changelog.
Please note: This is an approximation of larger effort work planned for the next 6 - 12 months. It does not cover all new functionality that will be added, and nothing here is set in stone. Also note that each of these releases, and several patch releases in-between, will include bug fixes (based on issue triaging) and community submitted PRs.
- Please report feature requests or bugs as a new issue.
- If you already see an issue that interests you please add a 👍 or a comment so we can measure community interest.
Approximate Date: August 7th, 2023
Currently in active development and in the beta stage. React 18 users will get a lot out of this release since it introduces support for Suspense. There are also new features added to the core as well. Here's a brief overview:
- Add a new hook
useSuspenseQuery
which will provide the core functionality for React 18Suspense
capabilities - Ability to use
Suspense
with@defer
- Introduce new hooks
useBackgroundQuery
anduseReadQuery
withSuspense
support - Support custom GraphQL document transforms
- Improved error messaging and bundling
- Stable
useFragment
implementation - New client-side
@nonreactive
directive - A new optional
removeTypenameFromVariables
Apollo Link that will automatically strip__typename
from your variables for each request
Try it today: npm i @apollo/client@rc
and let us know what you think!
Currently in planning phase
Features we plan to tackle:
- Introduce a suspenseful
useFragment
that will suspend when the data is not yet loaded - Ability to preload a query outside of a React component that can be used with
useReadQuery
to suspend while loading - Introduce a new
useInteractiveQuery
/useLazyBackgroundQuery
hook (name TBD) - Add metrics integration throughout the library for powerful insights
- Improved testing utilities
NOTE: These are subject to change and are not guaranteed to be part of 3.9 at the time of this writing.
Approximate Date: TBD
The 3.8 release is a major milestone for the project's React support. Feedback from the community will have a big impact on where we go next, particularly as use cases for React Server Components and other React 18 features emerge. In addition to new functionality, there is a significant backlog of questions and fixes that we want to categorize and thoughtfully address in upcoming releases.
Release 4.0
will be our next major release of the Client and is still in early planning. See Github 4.0 Milestone for more details.