Skip to content

Commit

Permalink
chore(docs): fix prettier
Browse files Browse the repository at this point in the history
  • Loading branch information
TkDodo committed Apr 23, 2024
1 parent b92fb04 commit f025a7c
Show file tree
Hide file tree
Showing 2 changed files with 62 additions and 71 deletions.
20 changes: 14 additions & 6 deletions docs/framework/react/guides/migrating-to-react-query-4.md
Expand Up @@ -65,8 +65,8 @@ However, we have not followed this concept through to all apis. For example, whe
To streamline all apis, we've decided to make all keys Arrays only:

```tsx
- useQuery('todos', fetchTodos) // [!code --]
+ useQuery(['todos'], fetchTodos) // [!code ++]
;-useQuery('todos', fetchTodos) + // [!code --]
useQuery(['todos'], fetchTodos) // [!code ++]
```

#### Codemod
Expand Down Expand Up @@ -117,8 +117,8 @@ Also, have a look at [the guide on dependent queries](../dependent-queries)
Due to this change, disabled queries (even temporarily disabled ones) will start in `loading` state. To make migration easier, especially for having a good flag to know when to display a loading spinner, you can check for `isInitialLoading` instead of `isLoading`:

```tsx
- isLoading // [!code --]
+ isInitialLoading // [!code ++]
;-isLoading + // [!code --]
isInitialLoading // [!code ++]
```

See also the guide on [disabling queries](../disabling-queries#isInitialLoading)
Expand All @@ -128,8 +128,16 @@ See also the guide on [disabling queries](../disabling-queries#isInitialLoading)
The `useQueries` hook now accepts an object with a `queries` prop as its input. The value of the `queries` prop is an array of queries (this array is identical to what was passed into `useQueries` in v3).

```tsx
- useQueries([{ queryKey1, queryFn1, options1 }, { queryKey2, queryFn2, options2 }]) // [!code --]
+ useQueries({ queries: [{ queryKey1, queryFn1, options1 }, { queryKey2, queryFn2, options2 }] }) // [!code ++]
;-useQueries([
{ queryKey1, queryFn1, options1 },
{ queryKey2, queryFn2, options2 },
]) + // [!code --]
useQueries({
queries: [
{ queryKey1, queryFn1, options1 },
{ queryKey2, queryFn2, options2 },
],
}) // [!code ++]
```

### Undefined is an illegal cache value for successful queries
Expand Down
113 changes: 48 additions & 65 deletions docs/framework/react/guides/migrating-to-v5.md
Expand Up @@ -14,87 +14,70 @@ useQuery and friends used to have many overloads in TypeScript - different ways
now we only support the object format.

```tsx
- useQuery(key, fn, options) // [!code --]
+ useQuery({ queryKey, queryFn, ...options }) // [!code ++]

- useInfiniteQuery(key, fn, options) // [!code --]
+ useInfiniteQuery({ queryKey, queryFn, ...options }) // [!code ++]

- useMutation(fn, options) // [!code --]
+ useMutation({ mutationFn, ...options }) // [!code ++]

- useIsFetching(key, filters) // [!code --]
+ useIsFetching({ queryKey, ...filters }) // [!code ++]

- useIsMutating(key, filters) // [!code --]
+ useIsMutating({ mutationKey, ...filters }) // [!code ++]
;-useQuery(key, fn, options) + // [!code --]
useQuery({ queryKey, queryFn, ...options }) - // [!code ++]
useInfiniteQuery(key, fn, options) + // [!code --]
useInfiniteQuery({ queryKey, queryFn, ...options }) - // [!code ++]
useMutation(fn, options) + // [!code --]
useMutation({ mutationFn, ...options }) - // [!code ++]
useIsFetching(key, filters) + // [!code --]
useIsFetching({ queryKey, ...filters }) - // [!code ++]
useIsMutating(key, filters) + // [!code --]
useIsMutating({ mutationKey, ...filters }) // [!code ++]
```

```tsx
- queryClient.isFetching(key, filters) // [!code --]
+ queryClient.isFetching({ queryKey, ...filters }) // [!code ++]

- queryClient.ensureQueryData(key, filters) // [!code --]
+ queryClient.ensureQueryData({ queryKey, ...filters }) // [!code ++]

- queryClient.getQueriesData(key, filters) // [!code --]
+ queryClient.getQueriesData({ queryKey, ...filters }) // [!code ++]

- queryClient.setQueriesData(key, updater, filters, options) // [!code --]
+ queryClient.setQueriesData({ queryKey, ...filters }, updater, options) // [!code ++]

- queryClient.removeQueries(key, filters) // [!code --]
+ queryClient.removeQueries({ queryKey, ...filters }) // [!code ++]

- queryClient.resetQueries(key, filters, options) // [!code --]
+ queryClient.resetQueries({ queryKey, ...filters }, options) // [!code ++]

- queryClient.cancelQueries(key, filters, options) // [!code --]
+ queryClient.cancelQueries({ queryKey, ...filters }, options) // [!code ++]

- queryClient.invalidateQueries(key, filters, options) // [!code --]
+ queryClient.invalidateQueries({ queryKey, ...filters }, options) // [!code ++]

- queryClient.refetchQueries(key, filters, options) // [!code --]
+ queryClient.refetchQueries({ queryKey, ...filters }, options) // [!code ++]

- queryClient.fetchQuery(key, fn, options) // [!code --]
+ queryClient.fetchQuery({ queryKey, queryFn, ...options }) // [!code ++]

- queryClient.prefetchQuery(key, fn, options) // [!code --]
+ queryClient.prefetchQuery({ queryKey, queryFn, ...options }) // [!code ++]

- queryClient.fetchInfiniteQuery(key, fn, options) // [!code --]
+ queryClient.fetchInfiniteQuery({ queryKey, queryFn, ...options }) // [!code ++]

- queryClient.prefetchInfiniteQuery(key, fn, options) // [!code --]
+ queryClient.prefetchInfiniteQuery({ queryKey, queryFn, ...options }) // [!code ++]
;-queryClient.isFetching(key, filters) + // [!code --]
queryClient.isFetching({ queryKey, ...filters }) - // [!code ++]
queryClient.ensureQueryData(key, filters) + // [!code --]
queryClient.ensureQueryData({ queryKey, ...filters }) - // [!code ++]
queryClient.getQueriesData(key, filters) + // [!code --]
queryClient.getQueriesData({ queryKey, ...filters }) - // [!code ++]
queryClient.setQueriesData(key, updater, filters, options) + // [!code --]
queryClient.setQueriesData({ queryKey, ...filters }, updater, options) - // [!code ++]
queryClient.removeQueries(key, filters) + // [!code --]
queryClient.removeQueries({ queryKey, ...filters }) - // [!code ++]
queryClient.resetQueries(key, filters, options) + // [!code --]
queryClient.resetQueries({ queryKey, ...filters }, options) - // [!code ++]
queryClient.cancelQueries(key, filters, options) + // [!code --]
queryClient.cancelQueries({ queryKey, ...filters }, options) - // [!code ++]
queryClient.invalidateQueries(key, filters, options) + // [!code --]
queryClient.invalidateQueries({ queryKey, ...filters }, options) - // [!code ++]
queryClient.refetchQueries(key, filters, options) + // [!code --]
queryClient.refetchQueries({ queryKey, ...filters }, options) - // [!code ++]
queryClient.fetchQuery(key, fn, options) + // [!code --]
queryClient.fetchQuery({ queryKey, queryFn, ...options }) - // [!code ++]
queryClient.prefetchQuery(key, fn, options) + // [!code --]
queryClient.prefetchQuery({ queryKey, queryFn, ...options }) - // [!code ++]
queryClient.fetchInfiniteQuery(key, fn, options) + // [!code --]
queryClient.fetchInfiniteQuery({ queryKey, queryFn, ...options }) - // [!code ++]
queryClient.prefetchInfiniteQuery(key, fn, options) + // [!code --]
queryClient.prefetchInfiniteQuery({ queryKey, queryFn, ...options }) // [!code ++]
```

```tsx
- queryCache.find(key, filters) // [!code --]
+ queryCache.find({ queryKey, ...filters }) // [!code ++]

- queryCache.findAll(key, filters) // [!code --]
+ queryCache.findAll({ queryKey, ...filters }) // [!code ++]
;-queryCache.find(key, filters) + // [!code --]
queryCache.find({ queryKey, ...filters }) - // [!code ++]
queryCache.findAll(key, filters) + // [!code --]
queryCache.findAll({ queryKey, ...filters }) // [!code ++]
```

### `queryClient.getQueryData` now accepts queryKey only as an Argument

`queryClient.getQueryData` argument is changed to accept only a `queryKey`

```tsx
- queryClient.getQueryData(queryKey, filters) // [!code --]
+ queryClient.getQueryData(queryKey) // [!code ++]
;-queryClient.getQueryData(queryKey, filters) + // [!code --]
queryClient.getQueryData(queryKey) // [!code ++]
```

### `queryClient.getQueryState` now accepts queryKey only as an Argument

`queryClient.getQueryState` argument is changed to accept only a `queryKey`

```tsx
- queryClient.getQueryState(queryKey, filters) // [!code --]
+ queryClient.getQueryState(queryKey) // [!code ++]
;-queryClient.getQueryState(queryKey, filters) + // [!code --]
queryClient.getQueryState(queryKey) // [!code ++]
```

#### Codemod
Expand Down Expand Up @@ -156,11 +139,11 @@ But It doesn't make much sense to do this while a query is still active, because
if you still need to remove a query, you can use `queryClient.removeQueries({queryKey: key})`

```tsx
const queryClient = useQueryClient();
const query = useQuery({ queryKey, queryFn });
const queryClient = useQueryClient()
const query = useQuery({ queryKey, queryFn })

- query.remove() // [!code --]
+ queryClient.removeQueries({ queryKey }) // [!code ++]
;-query.remove() + // [!code --]
queryClient.removeQueries({ queryKey }) // [!code ++]
```

### The minimum required TypeScript version is now 4.7
Expand Down

0 comments on commit f025a7c

Please sign in to comment.