QueryState

QueryState describes the current status of your data. It is passed to the builder function in QueryBuilder.

Properties

Property	Type	Description
`status`	`QueryStatus`	High-level status: `idle`, `loading`, `success`, `error`.
`data`	`T?`	The successfully fetched data.
`error`	`Object?`	Variable containing the error if the request failed.
`dataUpdatedAt`	`DateTime?`	Timestamp of the last successful fetch.
`errorUpdatedAt`	`DateTime?`	Timestamp of the last error.

Derived Helpers

Fasq provides convenient getters to make checks easier:

isLoading: True if the initial fetch is in progress (no data yet).
isFetching: True if any network request is outgoing (including background refreshes).
isSuccess: True if the status is success.
isError: True if the status is error.

Example: Loading vs Fetching

Understanding the difference is key for good UX.

isLoading: Show a full-screen spinner (loading for the first time).
isFetching: Show a small linear indicator at the top (refreshing stale data).


if (state.isLoading) {
  return FullScreenSpinner();
}
 
return Stack(
  children: [
    if (state.isFetching) TopProgressBar(),
    MyDataList(data: state.data),
  ],
);