# InfiniteQueryResult

Defined in: [react/src/createInfiniteQuery.ts:304](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/createInfiniteQuery.ts#L304)

Result from createInfiniteQuery

`cancel()`, `reset()` and `optimisticUpdate()` act on the whole page set:
`optimisticUpdate` gets and returns the raw `InfiniteData`, `{ pages,
pageParams }`.

## Extends

- [`QueryCacheControls`](https://ic-reactor.b3pay.net/v3/libs/interfaces/querycachecontrols/)\<`InfiniteData`\<`TPageData`, `TPageParam`\>\>

## Type Parameters

### TPageData

`TPageData`

The raw page data type

### TPageParam

`TPageParam`

The page parameter type

### Selected

`Selected` = `InfiniteData`\<`TPageData`, `TPageParam`\>

The type after select transformation

### TError

`TError` = `Error`

The error type

## Properties

### fetch

> **fetch**: () => `Promise`\<`Selected`\>

Defined in: [react/src/createInfiniteQuery.ts:311](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/createInfiniteQuery.ts#L311)

Fetch first page in loader (uses ensureQueryData for cache-first)

#### Returns

`Promise`\<`Selected`\>

***

### useInfiniteQuery

> **useInfiniteQuery**: [`UseInfiniteQueryWithSelect`](https://ic-reactor.b3pay.net/v3/libs/interfaces/useinfinitequerywithselect/)\<`TPageData`, `TPageParam`, `Selected`, `TError`\>

Defined in: [react/src/createInfiniteQuery.ts:314](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/createInfiniteQuery.ts#L314)

React hook for components - supports pagination

***

### invalidate

> **invalidate**: () => `Promise`\<`void`\>

Defined in: [react/src/createInfiniteQuery.ts:322](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/createInfiniteQuery.ts#L322)

Invalidate the cache (refetches if query is active)

#### Returns

`Promise`\<`void`\>

***

### getQueryKey

> **getQueryKey**: () => readonly `unknown`[]

Defined in: [react/src/createInfiniteQuery.ts:325](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/createInfiniteQuery.ts#L325)

Get query key (for advanced React Query usage)

#### Returns

readonly `unknown`[]

***

### getCacheData

> **getCacheData**: \{(): `Selected` \| `undefined`; \<`TFinal`\>(`select`): `TFinal` \| `undefined`; \}

Defined in: [react/src/createInfiniteQuery.ts:331](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/createInfiniteQuery.ts#L331)

Read data directly from cache without fetching.
Returns undefined if data is not in cache.

#### Call Signature

> (): `Selected` \| `undefined`

##### Returns

`Selected` \| `undefined`

#### Call Signature

> \<`TFinal`\>(`select`): `TFinal` \| `undefined`

##### Type Parameters

###### TFinal

`TFinal`

##### Parameters

###### select

(`data`) => `TFinal`

##### Returns

`TFinal` \| `undefined`

***

### cancel

> **cancel**: () => `Promise`\<`void`\>

Defined in: [react/src/types.ts:343](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/types.ts#L343)

Cancel this query's fetch in flight, if there is one. The entry keeps
the value it held before that fetch started, and a later refetch runs as
usual.

#### Returns

`Promise`\<`void`\>

#### Example

```typescript
// Before writing to the cache, so an older answer cannot land on top
await postQuery.cancel()
postQuery.setData(draft)
```

#### Inherited from

[`QueryCacheControls`](https://ic-reactor.b3pay.net/v3/libs/interfaces/querycachecontrols/).[`cancel`](https://ic-reactor.b3pay.net/v3/libs/interfaces/querycachecontrols/#cancel)

***

### reset

> **reset**: () => `Promise`\<`void`\>

Defined in: [react/src/types.ts:357](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/types.ts#L357)

Reset this query's entry to its initial state, as TanStack Query's
`resetQueries` does: its data is cleared, or goes back to `initialData`
when one was given. A mounted hook then fetches it again, and a suspense
hook suspends until it has. It resolves once that fetch settles.

#### Returns

`Promise`\<`void`\>

#### Example

```typescript
// A reload button that shows the Suspense fallback again
<button onClick={() => void statsQuery.reset()}>Reload</button>
```

#### Inherited from

[`QueryCacheControls`](https://ic-reactor.b3pay.net/v3/libs/interfaces/querycachecontrols/).[`reset`](https://ic-reactor.b3pay.net/v3/libs/interfaces/querycachecontrols/#reset)

***

### optimisticUpdate

> **optimisticUpdate**: (`updater`) => `Promise`\<[`OptimisticRollback`](https://ic-reactor.b3pay.net/v3/libs/interfaces/optimisticrollback/)\>

Defined in: [react/src/types.ts:398](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/types.ts#L398)

Replace this query's cached value for the duration of a mutation, and
get back a rollback for when it fails.

It cancels the query's fetch in flight, so an answer from before the
mutation cannot overwrite the new value, then writes what `updater`
returns for the cached value. `updater` gets and returns the raw,
pre-`select` data. When nothing is cached yet it is not called, nothing
is cancelled or written, and `rollback()` does nothing: there is no
value on screen to update, and the query's own fetch will bring one. The
same goes when another principal signs in or out while it cancels, since
the cached value is then the previous principal's.

The fetch it cancels may be a refetch an invalidation or a sign-in
started, so refetch the query once the mutation settles, with
`invalidate()` in `onSettled` or the query in `invalidateQueries`.

Return it from `onMutate`, so the rollback reaches `onError`.

#### Parameters

##### updater

(`old`) => `InfiniteData`

The new value, from the cached one. Do not mutate the
cached value in place; return a new one.

#### Returns

`Promise`\<[`OptimisticRollback`](https://ic-reactor.b3pay.net/v3/libs/interfaces/optimisticrollback/)\>

#### Example

```typescript
const getPost = createQueryFactory(backend, { functionName: "getPost" })
const likePost = createMutation(backend, { functionName: "likePost" })

const { mutate } = likePost.useMutation({
  onMutate: ([postId]) =>
    getPost([postId]).optimisticUpdate((post) => ({
      ...post,
      likes: post.likes + 1n,
    })),
  onError: (_error, _args, update) => update?.rollback(),
  // Refetch either way: a call that failed in transit may still have run
  onSettled: (_data, _error, [postId]) => getPost([postId]).invalidate(),
})
```

#### Inherited from

[`QueryCacheControls`](https://ic-reactor.b3pay.net/v3/libs/interfaces/querycachecontrols/).[`optimisticUpdate`](https://ic-reactor.b3pay.net/v3/libs/interfaces/querycachecontrols/#optimisticupdate)