Open History to see the last commit
1import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
2import { fireEvent } from '@solidjs/testing-library'
3import { createEffect, createRenderEffect } from 'solid-js'
4import { queryKey, sleep } from '@tanstack/query-test-utils'
5import { QueryClient, useIsMutating, useMutation, useMutationState } from '..'
6import { mutationOptions } from '../mutationOptions'
7import { renderWithClient } from './utils'
8import type { MutationState } from '@tanstack/query-core'
9β
10describe('mutationOptions', () => {
11 let queryClient: QueryClient
12β
13 beforeEach(() => {
14 vi.useFakeTimers()
15 queryClient = new QueryClient()
16 })
17β
18 afterEach(() => {
19 queryClient.clear()
20 vi.useRealTimers()
21 })
22β
23 it('should return the object received as a parameter without any modification (with mutationKey in mutationOptions)', () => {
24 const object = {
25 mutationKey: ['key'],
26 mutationFn: () => sleep(10).then(() => 5),
27 } as const
28β
29 expect(mutationOptions(object)).toBe(object)
30 })
31β
32 it('should return the object received as a parameter without any modification (without mutationKey in mutationOptions)', () => {
33 const object = {
34 mutationFn: () => sleep(10).then(() => 5),
35 } as const
36β
37 expect(mutationOptions(object)).toBe(object)
38 })
39β
40 it('should return the number of fetching mutations when used with useIsMutating (with mutationKey in mutationOptions)', async () => {
41 const isMutatingArray: Array<number> = []
42 const key = queryKey()
43 const mutationOpts = mutationOptions({
44 mutationKey: key,
45 mutationFn: () => sleep(50).then(() => 'data'),
46 })
47β
48 function Mutation() {
49 const isMutating = useIsMutating()
50 const { mutate } = useMutation(() => mutationOpts)
51β
52 createRenderEffect(() => {
53 isMutatingArray.push(isMutating())
54 })
55β
56 return (
57 <div>
58 <button onClick={() => mutate()}>mutate</button>
59 </div>
60 )
61 }
62β
63 const rendered = renderWithClient(queryClient, () => <Mutation />)
64β
65 fireEvent.click(rendered.getByRole('button', { name: /mutate/i }))
66 expect(isMutatingArray[0]).toEqual(0)
67 await vi.advanceTimersByTimeAsync(0)
68 expect(isMutatingArray[1]).toEqual(1)
69 await vi.advanceTimersByTimeAsync(50)
70 expect(isMutatingArray[2]).toEqual(0)
71 expect(isMutatingArray[isMutatingArray.length - 1]).toEqual(0)
72 })
73β
74 it('should return the number of fetching mutations when used with useIsMutating (without mutationKey in mutationOptions)', async () => {
75 const isMutatingArray: Array<number> = []
76 const mutationOpts = mutationOptions({
77 mutationFn: () => sleep(50).then(() => 'data'),
78 })
79β
80 function Mutation() {
81 const isMutating = useIsMutating()
82 const { mutate } = useMutation(() => mutationOpts)
83β
84 createRenderEffect(() => {
85 isMutatingArray.push(isMutating())
86 })
87β
88 return (
89 <div>
90 <button onClick={() => mutate()}>mutate</button>
91 </div>
92 )
93 }
94β
95 const rendered = renderWithClient(queryClient, () => <Mutation />)
96β
97 fireEvent.click(rendered.getByRole('button', { name: /mutate/i }))
98 expect(isMutatingArray[0]).toEqual(0)
99 await vi.advanceTimersByTimeAsync(0)
100 expect(isMutatingArray[1]).toEqual(1)
101 await vi.advanceTimersByTimeAsync(50)
102 expect(isMutatingArray[2]).toEqual(0)
103 expect(isMutatingArray[isMutatingArray.length - 1]).toEqual(0)
104 })
105β
106 it('should return the number of fetching mutations when used with useIsMutating', async () => {
107 const isMutatingArray: Array<number> = []
108 const key = queryKey()
109 const mutationOpts1 = mutationOptions({
110 mutationKey: key,
111 mutationFn: () => sleep(50).then(() => 'data1'),
112 })
113 const mutationOpts2 = mutationOptions({
114 mutationFn: () => sleep(50).then(() => 'data2'),
115 })
116β
117 function Mutation() {
118 const isMutating = useIsMutating()
119 const { mutate: mutate1 } = useMutation(() => mutationOpts1)
120 const { mutate: mutate2 } = useMutation(() => mutationOpts2)
121β
122 createRenderEffect(() => {
123 isMutatingArray.push(isMutating())
124 })
125β
126 return (
127 <div>
128 <button onClick={() => mutate1()}>mutate1</button>
129 <button onClick={() => mutate2()}>mutate2</button>
130 </div>
131 )
132 }
133β
134 const rendered = renderWithClient(queryClient, () => <Mutation />)
135β
136 fireEvent.click(rendered.getByRole('button', { name: /mutate1/i }))
137 fireEvent.click(rendered.getByRole('button', { name: /mutate2/i }))
138 expect(isMutatingArray[0]).toEqual(0)
139 await vi.advanceTimersByTimeAsync(0)
140 expect(isMutatingArray[2]).toEqual(2)
141 await vi.advanceTimersByTimeAsync(50)
142 expect(isMutatingArray[isMutatingArray.length - 1]).toEqual(0)
143 })
144β
145 it('should return the number of fetching mutations when used with useIsMutating (filter mutationOpts1.mutationKey)', async () => {
146 const isMutatingArray: Array<number> = []
147 const key = queryKey()
148 const mutationOpts1 = mutationOptions({
149 mutationKey: key,
150 mutationFn: () => sleep(50).then(() => 'data1'),
151 })
152 const mutationOpts2 = mutationOptions({
153 mutationFn: () => sleep(50).then(() => 'data2'),
154 })
155β
156 function Mutation() {
157 const isMutating = useIsMutating(() => ({
158 mutationKey: mutationOpts1.mutationKey,
159 }))
160 const { mutate: mutate1 } = useMutation(() => mutationOpts1)
161 const { mutate: mutate2 } = useMutation(() => mutationOpts2)
162β
163 createRenderEffect(() => {
164 isMutatingArray.push(isMutating())
165 })
166β
167 return (
168 <div>
169 <button onClick={() => mutate1()}>mutate1</button>
170 <button onClick={() => mutate2()}>mutate2</button>
171 </div>
172 )
173 }
174β
175 const rendered = renderWithClient(queryClient, () => <Mutation />)
176β
177 fireEvent.click(rendered.getByRole('button', { name: /mutate1/i }))
178 fireEvent.click(rendered.getByRole('button', { name: /mutate2/i }))
179 expect(isMutatingArray[0]).toEqual(0)
180 await vi.advanceTimersByTimeAsync(0)
181 expect(isMutatingArray[1]).toEqual(1)
182 await vi.advanceTimersByTimeAsync(50)
183 expect(isMutatingArray[2]).toEqual(0)
184 expect(isMutatingArray[isMutatingArray.length - 1]).toEqual(0)
185 })
186β
187 it('should return the number of fetching mutations when used with queryClient.isMutating (with mutationKey in mutationOptions)', async () => {
188 const isMutatingArray: Array<number> = []
189 const key = queryKey()
190 const mutationOpts = mutationOptions({
191 mutationKey: key,
192 mutationFn: () => sleep(500).then(() => 'data'),
193 })
194β
195 function Mutation() {
196 const { mutate } = useMutation(() => mutationOpts)
197β
198 return (
199 <div>
200 <button onClick={() => mutate()}>mutate</button>
201 </div>
202 )
203 }
204β
205 const rendered = renderWithClient(queryClient, () => <Mutation />)
206β
207 const mutationCache = queryClient.getMutationCache()
208 const unsubscribe = mutationCache.subscribe(() => {
209 isMutatingArray.push(queryClient.isMutating(mutationOpts))
210 })
211β
212 isMutatingArray.push(queryClient.isMutating(mutationOpts))
213β
214 fireEvent.click(rendered.getByRole('button', { name: /mutate/i }))
215 expect(isMutatingArray[0]).toEqual(0)
216 await vi.advanceTimersByTimeAsync(0)
217 // Use Math.max because subscribe callback count is implementation-dependent
218 expect(Math.max(...isMutatingArray)).toEqual(1)
219 await vi.advanceTimersByTimeAsync(500)
220 expect(isMutatingArray[isMutatingArray.length - 1]).toEqual(0)
221β
222 unsubscribe()
223 })
224β
225 it('should return the number of fetching mutations when used with queryClient.isMutating (without mutationKey in mutationOptions)', async () => {
226 const isMutatingArray: Array<number> = []
227 const mutationOpts = mutationOptions({
228 mutationFn: () => sleep(500).then(() => 'data'),
229 })
230β
231 function Mutation() {
232 const { mutate } = useMutation(() => mutationOpts)
233β
234 return (
235 <div>
236 <button onClick={() => mutate()}>mutate</button>
237 </div>
238 )
239 }
240β
241 const rendered = renderWithClient(queryClient, () => <Mutation />)
242β
243 const mutationCache = queryClient.getMutationCache()
244 const unsubscribe = mutationCache.subscribe(() => {
245 isMutatingArray.push(queryClient.isMutating())
246 })
247β
248 isMutatingArray.push(queryClient.isMutating())
249β
250 fireEvent.click(rendered.getByRole('button', { name: /mutate/i }))
251 expect(isMutatingArray[0]).toEqual(0)
252 await vi.advanceTimersByTimeAsync(0)
253 // Use Math.max because subscribe callback count is implementation-dependent
254 expect(Math.max(...isMutatingArray)).toEqual(1)
255 await vi.advanceTimersByTimeAsync(500)
256 expect(isMutatingArray[isMutatingArray.length - 1]).toEqual(0)
257β
258 unsubscribe()
259 })
260β
261 it('should return the number of fetching mutations when used with queryClient.isMutating', async () => {
262 const isMutatingArray: Array<number> = []
263 const key = queryKey()
264 const mutationOpts1 = mutationOptions({
265 mutationKey: key,
266 mutationFn: () => sleep(500).then(() => 'data1'),
267 })
268 const mutationOpts2 = mutationOptions({
269 mutationFn: () => sleep(500).then(() => 'data2'),
270 })
271β
272 function Mutation() {
273 const { mutate: mutate1 } = useMutation(() => mutationOpts1)
274 const { mutate: mutate2 } = useMutation(() => mutationOpts2)
275β
276 return (
277 <div>
278 <button onClick={() => mutate1()}>mutate1</button>
279 <button onClick={() => mutate2()}>mutate2</button>
280 </div>
281 )
282 }
283β
284 const rendered = renderWithClient(queryClient, () => <Mutation />)
285β
286 const mutationCache = queryClient.getMutationCache()
287 const unsubscribe = mutationCache.subscribe(() => {
288 isMutatingArray.push(queryClient.isMutating())
289 })
290β
291 isMutatingArray.push(queryClient.isMutating())
292β
293 fireEvent.click(rendered.getByRole('button', { name: /mutate1/i }))
294 fireEvent.click(rendered.getByRole('button', { name: /mutate2/i }))
295 expect(isMutatingArray[0]).toEqual(0)
296 await vi.advanceTimersByTimeAsync(0)
297 // Use Math.max because subscribe callback count is implementation-dependent
298 expect(Math.max(...isMutatingArray)).toEqual(2)
299 await vi.advanceTimersByTimeAsync(500)
300 expect(isMutatingArray[isMutatingArray.length - 1]).toEqual(0)
301β
302 unsubscribe()
303 })
304β
305 it('should return the number of fetching mutations when used with queryClient.isMutating (filter mutationOpts1.mutationKey)', async () => {
306 const isMutatingArray: Array<number> = []
307 const key = queryKey()
308 const mutationOpts1 = mutationOptions({
309 mutationKey: key,
310 mutationFn: () => sleep(500).then(() => 'data1'),
311 })
312 const mutationOpts2 = mutationOptions({
313 mutationFn: () => sleep(500).then(() => 'data2'),
314 })
315β
316 function Mutation() {
317 const { mutate: mutate1 } = useMutation(() => mutationOpts1)
318 const { mutate: mutate2 } = useMutation(() => mutationOpts2)
319β
320 return (
321 <div>
322 <button onClick={() => mutate1()}>mutate1</button>
323 <button onClick={() => mutate2()}>mutate2</button>
324 </div>
325 )
326 }
327β
328 const rendered = renderWithClient(queryClient, () => <Mutation />)
329β
330 const mutationCache = queryClient.getMutationCache()
331 const unsubscribe = mutationCache.subscribe(() => {
332 isMutatingArray.push(
333 queryClient.isMutating({
334 mutationKey: mutationOpts1.mutationKey,
335 }),
336 )
337 })
338β
339 isMutatingArray.push(
340 queryClient.isMutating({
341 mutationKey: mutationOpts1.mutationKey,
342 }),
343 )
344β
345 fireEvent.click(rendered.getByRole('button', { name: /mutate1/i }))
346 fireEvent.click(rendered.getByRole('button', { name: /mutate2/i }))
347 expect(isMutatingArray[0]).toEqual(0)
348 await vi.advanceTimersByTimeAsync(0)
349 // Use Math.max because subscribe callback count is implementation-dependent
350 expect(Math.max(...isMutatingArray)).toEqual(1)
351 await vi.advanceTimersByTimeAsync(500)
352 expect(isMutatingArray[isMutatingArray.length - 1]).toEqual(0)
353β
354 unsubscribe()
355 })
356β
357 it('should return the number of fetching mutations when used with useMutationState (with mutationKey in mutationOptions)', async () => {
358 const mutationStateArray: Array<Array<MutationState>> = []
359 const key = queryKey()
360 const mutationOpts = mutationOptions({
361 mutationKey: key,
362 mutationFn: () => sleep(10).then(() => 'data'),
363 })
364β
365 function Mutation() {
366 const { mutate } = useMutation(() => mutationOpts)
367 const states = useMutationState(() => ({
368 filters: { mutationKey: mutationOpts.mutationKey, status: 'success' },
369 }))
370β
371 createEffect(() => {
372 mutationStateArray.push(states())
373 })
374β
375 return (
376 <div>
377 <button onClick={() => mutate()}>mutate</button>
378 </div>
379 )
380 }
381β
382 const rendered = renderWithClient(queryClient, () => <Mutation />)
383β
384 expect(mutationStateArray[0]).toEqual([])
385β
386 fireEvent.click(rendered.getByRole('button', { name: /mutate/i }))
387 await vi.advanceTimersByTimeAsync(10)
388 const lastSnapshot = mutationStateArray[mutationStateArray.length - 1]!
389 expect(lastSnapshot.length).toEqual(1)
390 expect(lastSnapshot[0]?.data).toEqual('data')
391 })
392β
393 it('should return the number of fetching mutations when used with useMutationState (without mutationKey in mutationOptions)', async () => {
394 const mutationStateArray: Array<Array<MutationState>> = []
395 const mutationOpts = mutationOptions({
396 mutationFn: () => sleep(10).then(() => 'data'),
397 })
398β
399 function Mutation() {
400 const { mutate } = useMutation(() => mutationOpts)
401 const states = useMutationState(() => ({
402 filters: { status: 'success' },
403 }))
404β
405 createEffect(() => {
406 mutationStateArray.push(states())
407 })
408β
409 return (
410 <div>
411 <button onClick={() => mutate()}>mutate</button>
412 </div>
413 )
414 }
415β
416 const rendered = renderWithClient(queryClient, () => <Mutation />)
417β
418 expect(mutationStateArray[0]).toEqual([])
419β
420 fireEvent.click(rendered.getByRole('button', { name: /mutate/i }))
421 await vi.advanceTimersByTimeAsync(10)
422 const lastSnapshot = mutationStateArray[mutationStateArray.length - 1]!
423 expect(lastSnapshot.length).toEqual(1)
424 expect(lastSnapshot[0]?.data).toEqual('data')
425 })
426β
427 it('should return the number of fetching mutations when used with useMutationState', async () => {
428 const mutationStateArray: Array<Array<MutationState>> = []
429 const key = queryKey()
430 const mutationOpts1 = mutationOptions({
431 mutationKey: key,
432 mutationFn: () => sleep(10).then(() => 'data1'),
433 })
434 const mutationOpts2 = mutationOptions({
435 mutationFn: () => sleep(10).then(() => 'data2'),
436 })
437β
438 function Mutation() {
439 const { mutate: mutate1 } = useMutation(() => mutationOpts1)
440 const { mutate: mutate2 } = useMutation(() => mutationOpts2)
441 const states = useMutationState(() => ({
442 filters: { status: 'success' },
443 }))
444β
445 createEffect(() => {
446 mutationStateArray.push(states())
447 })
448β
449 return (
450 <div>
451 <button onClick={() => mutate1()}>mutate1</button>
452 <button onClick={() => mutate2()}>mutate2</button>
453 </div>
454 )
455 }
456β
457 const rendered = renderWithClient(queryClient, () => <Mutation />)
458β
459 expect(mutationStateArray[0]).toEqual([])
460β
461 fireEvent.click(rendered.getByRole('button', { name: /mutate1/i }))
462 fireEvent.click(rendered.getByRole('button', { name: /mutate2/i }))
463 await vi.advanceTimersByTimeAsync(10)
464 const lastSnapshot = mutationStateArray[mutationStateArray.length - 1]!
465 expect(lastSnapshot.length).toEqual(2)
466 expect(lastSnapshot[0]?.data).toEqual('data1')
467 expect(lastSnapshot[1]?.data).toEqual('data2')
468 })
469β
470 it('should return the number of fetching mutations when used with useMutationState (filter mutationOpts1.mutationKey)', async () => {
471 const mutationStateArray: Array<Array<MutationState>> = []
472 const key = queryKey()
473 const mutationOpts1 = mutationOptions({
474 mutationKey: key,
475 mutationFn: () => sleep(10).then(() => 'data1'),
476 })
477 const mutationOpts2 = mutationOptions({
478 mutationFn: () => sleep(10).then(() => 'data2'),
479 })
480β
481 function Mutation() {
482 const { mutate: mutate1 } = useMutation(() => mutationOpts1)
483 const { mutate: mutate2 } = useMutation(() => mutationOpts2)
484 const states = useMutationState(() => ({
485 filters: { mutationKey: mutationOpts1.mutationKey, status: 'success' },
486 }))
487β
488 createEffect(() => {
489 mutationStateArray.push(states())
490 })
491β
492 return (
493 <div>
494 <button onClick={() => mutate1()}>mutate1</button>
495 <button onClick={() => mutate2()}>mutate2</button>
496 </div>
497 )
498 }
499β
500 const rendered = renderWithClient(queryClient, () => <Mutation />)
501β
502 expect(mutationStateArray[0]).toEqual([])
503β
504 fireEvent.click(rendered.getByRole('button', { name: /mutate1/i }))
505 fireEvent.click(rendered.getByRole('button', { name: /mutate2/i }))
506 await vi.advanceTimersByTimeAsync(10)
507 const lastSnapshot = mutationStateArray[mutationStateArray.length - 1]!
508 expect(lastSnapshot.length).toEqual(1)
509 expect(lastSnapshot[0]?.data).toEqual('data1')
510 })
511})