Never miss a release that matters
AI-powered summaries of every GitHub release.
AI Summaries
Changelogs condensed into clear, actionable insights.
Always Free
Track up to 5 packages at no cost, forever.
Weekly Digest
A curated summary of every release, delivered weekly.
TL;DR
TanStack Query and its framework integrations have been updated with significant improvements to SolidJS support, transitioning to SolidJS v2. This includes reactivity compliance and fixes for SSR and mutation handling.
Breaking
- SolidJS v2 Upgrade:
@tanstack/solid-query,@tanstack/solid-query-devtools, and@tanstack/solid-query-persist-clientnow require SolidJS v2. (Ensure your project is updated to SolidJS v2 to avoid compatibility issues.)
New
- SolidJS v2 Support: Full compatibility with SolidJS v2 has been implemented, offering improved reactivity and performance.
- Hydration Fix: Resolved an issue where
dataUpdatedAtwasn't correctly set during hydration, improving data consistency. (Hydration is the process of rendering server-side data on the client.)
Fixes Worth Knowing
- Solid Query SSR: Fixed a rendering issue for deferred queries during Server-Side Rendering (SSR) in SolidJS.
- Devtools Improvements: Several fixes to the query devtools, addressing issues with Safari rendering and style scoping.
- Typo Correction: Fixed a typo in
@tanstack/svelte-query("Tanstack" corrected to "TanStack").
TL;DR
The latest updates improve the accuracy of dataUpdatedAt for streamed queries and fix a potential CSP (Content Security Policy) violation in the Devtools when using a styleNonce.
Fixes Worth Knowing
- Streamed queries now correctly report
dataUpdatedAt, ensuring accurate timing information. - The Devtools now correctly handles
styleNoncewhen injecting styles, preventing CSP errors. - The Query Devtools have several minor fixes including improved sorting and window management.
Before You Upgrade
If you are using the Devtools with a styleNonce for CSP, no action is needed – this release resolves a potential issue.
TL;DR
TanStack Query and its related packages (Svelte Query, Vue Query, and Devtools) have been updated with dependency upgrades to Query Core version 5.101.2. These updates primarily include internal improvements and bug fixes.
Fixes Worth Knowing
The core query library received fixes that improve overall stability and address minor bugs, resulting in a more reliable data fetching experience. (Data fetching: retrieving information from a server)
TL;DR
TanStack Query received dependency updates, improving stability and potentially performance through updates to its core library.
Fixes Worth Knowing
Updates to the underlying @tanstack/query-core library may resolve subtle bugs related to caching and data fetching, though no specific user-facing fixes are detailed in these releases.
TL;DR
TanStack Query and its SolidJS integrations now support SolidJS v2 beta 15, ensuring compatibility with the latest updates in the SolidJS framework (JavaScript UI library).
Before You Upgrade
Update your SolidJS version to v2 beta 15 to maintain compatibility with these TanStack Query packages.
TL;DR
TanStack Query now supports passing mutationOptions for more control over mutation behavior (server state management).
New
- Mutation options are now supported, enabling finer-grained control over how mutations are handled within TanStack Query.
Fixes Worth Knowing
- No specific fixes impacting typical usage in this release.
TL;DR
TanStack Query v5 introduces editable query data in the Devtools (developer tools) for easier debugging and data manipulation.
Breaking
None.
New
- Editable Devtools Data: Directly modify query data within the Devtools for improved debugging.
- Typed Query Keys: Query keys are now strongly typed, enhancing type safety.
- Vue Query Enhancements:
useQuerynow supports getter functions for theenabledoption, offering more dynamic control.
Fixes Worth Knowing
- Improved type inference for
useQueriesanduseSuspenseQuery. - Fixed issues with Vue Query suspense and Solid Query reconciliation.
- Resolved type errors in
useQueryfor Vue.
Before You Upgrade
No specific upgrade steps are required.
TL;DR
TanStack Query’s DevTools now include improved accessibility with screenreader text for offline mock buttons and the DevTools open icon.
Breaking
None.
New
None.
Fixes Worth Knowing
- DevTools now provides screenreader support for key interactive elements, improving accessibility.
- Production builds now include the DevTools, resolving a previous issue.
- Improved build sizes for UMD (Universal Module Definition - a JavaScript module format) builds.
Before You Upgrade
None.
TL;DR
TanStack Query now correctly clears timers and intervals, preventing potential memory leaks when queries unmount or refetch.
Fixes Worth Knowing
Fixed a bug where timers and intervals weren’t always cleared when queries unmounted or refetched, which could lead to memory leaks.
Before You Upgrade
No action is needed to upgrade. This release includes a bug fix and should be transparent.
TL;DR
TanStack Query now offers experimental local storage persistence, allowing the query cache to survive page reloads and potentially improve app performance.
Breaking
- Types: Type definitions have been adjusted to improve type inference when using the object syntax for query options. (TypeScript users - check your configurations.)
New
- Local Storage Persistence: An experimental
persist-localstoragefeature allows caching query data in the browser’s local storage. (Browser storage - for offline-like behavior.) - Integrated Devtools: The developer tools are now included directly within the core TanStack Query package. (Debugging tools - easier installation.)
Fixes Worth Knowing
isFetchednow correctly reports status for failed fetches.- Queries are refetched when
resetQueriesis called. - Improved serialization for server-side rendering (SSR).
Before You Upgrade
- If using TypeScript, review your query option types after upgrading to ensure correct inference with the object syntax.
TL;DR
TanStack Query now correctly infers types when using object syntax for query options, improving developer experience.
Fixes Worth Knowing
Type inference for query options (data fetching configurations) using object syntax has been corrected. This resolves issues where TypeScript (a JavaScript language extension) wasn’t accurately recognizing the types you provided.
Before You Upgrade
No action is needed; this is a bug fix and should work seamlessly.
TL;DR
TanStack Query now supports bi-directional infinite scrolling and provides more granular control over mutations with separate mutate and mutateAsync functions, improving data management in complex applications.
Breaking
mutatefunction split intomutateandmutateAsync(requires code updates to mutation calls).
New
- Infinite Queries: Added support for bi-directional infinite scrolling (allows loading data in both directions).
- Mutation Control: Separated
mutateintomutate(synchronous) andmutateAsync(asynchronous) for finer-grained control. - Fetching Status: New
useIsFetchinghook andisFetchingfilter for more precise component rendering based on query state.
Fixes Worth Knowing
- Improved handling of query cancellation, ensuring data reverts to the previous state.
- Fixed issues with refetching on infinite queries after page deletion.
- Resolved problems with overriding default options and optimistic updates.
Before You Upgrade
- Update all calls to
mutateto eithermutateormutateAsyncdepending on your needs.
TL;DR
TanStack Query now correctly handles updating query data for queries that haven't fully initialized, preventing unexpected behavior with asynchronous data.
Fixes Worth Knowing
setQueryData now resolves promises correctly when used with uninitialized queries, fixing a bug that could cause infinite loading states.
Before You Upgrade
No action is needed; this is a bug fix release.