retryWhenOnline property
Whether to pause retrying when offline and resume automatically on reconnect
When true, if all retry attempts are exhausted while the device is offline
(or the network drops mid-retry), the query enters paused (not error) state.
It will automatically restart a fresh retry cycle the next time the network
comes back online — without requiring a manual invalidate() or refetch().
When false (default), network failures are treated like any other error:
the query enters error state after retries are exhausted and waits for
an explicit refetchOnReconnect trigger.
Recommended for: Apps that rely on network data and should silently recover from connectivity loss without showing permanent error states.
Default: false
Implementation
final bool retryWhenOnline;