prefetchQuery<TData, TError> method

Future<void> prefetchQuery<TData, TError>(
  1. List<Object?> queryKey,
  2. QueryFn<TData> queryFn, {
  3. StaleDuration? staleDuration,
  4. RetryResolver<TError>? retry,
  5. GcDuration? gcDuration,
  6. TData? seed,
  7. DateTime? seedUpdatedAt,
  8. Map<String, dynamic>? meta,
})

Prefetches a query and populates the cache without returning data.

Unlike fetchQuery, this method returns Future<void> and silently ignores any errors, making it suitable for preloading data before navigation or warming up the cache.

See fetchQuery for parameter descriptions.

Implementation

Future<void> prefetchQuery<TData, TError>(
  List<Object?> queryKey,
  QueryFn<TData> queryFn, {
  StaleDuration? staleDuration,
  RetryResolver<TError>? retry,
  GcDuration? gcDuration,
  TData? seed,
  DateTime? seedUpdatedAt,
  Map<String, dynamic>? meta,
}) async {
  try {
    await fetchQuery<TData, TError>(
      queryKey,
      queryFn,
      staleDuration: staleDuration,
      retry: retry,
      gcDuration: gcDuration,
      seed: seed,
      seedUpdatedAt: seedUpdatedAt,
      meta: meta,
    );
  } catch (_) {
    // Silently ignore errors - prefetch is fire-and-forget
  }
}