Docs
CodeRabbit
Cloudflare
AG Grid
SerpAPI
Netlify
OpenRouter
Neon
WorkOS
Clerk
Electric
PowerSync
Sentry
Railway
Prisma
Strapi
Unkey
CodeRabbit
Cloudflare
AG Grid
SerpAPI
Netlify
OpenRouter
Neon
WorkOS
Clerk
Electric
PowerSync
Sentry
Railway
Prisma
Strapi
Unkey
API Reference
API Reference

dehydrateQuery

ts
function dehydrateQuery(
   query: Query, 
   serializeData?: TransformerFn, 
   shouldRedactErrors?: (error: unknown) => boolean
): DehydratedQuery;
function dehydrateQuery(
   query: Query, 
   serializeData?: TransformerFn, 
   shouldRedactErrors?: (error: unknown) => boolean
): DehydratedQuery;

Defined in: packages/query-core/src/hydration.ts:178

Dehydrates a single Query into a serializable DehydratedQuery snapshot. Note that most query config (e.g. queryFn, staleTime) is not dehydrated but instead meant to be configured again when consuming the de/rehydrated data, typically with useQuery on the client. If the query is still pending, its in-flight promise is dehydrated too so it can be resumed on the other side instead of re-fetched.

Parameters

query

Query

The query to dehydrate.

serializeData?

TransformerFn

Optional transform applied to query.state.data before it is included in the snapshot.

shouldRedactErrors?

(error: unknown) => boolean

Optional predicate; if it returns false for the promise's rejection error, that error is kept as-is instead of being redacted.

Returns

DehydratedQuery

The dehydrated query.