list correct extension of Matchers type in vitest (#10)

kettanaito · web-flow · commit d93741514c09 · 2025-08-28T21:40:29.000+02:00
diff --git a/exercises/01.setup/01.problem.vscode-extension/package.json b/exercises/01.setup/01.problem.vscode-extension/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/01.setup/01.solution.vscode-extension/package.json b/exercises/01.setup/01.solution.vscode-extension/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/01.setup/02.problem.multiple-workspaces/package.json b/exercises/01.setup/02.problem.multiple-workspaces/package.json
@@ -6,6 +6,6 @@
   },
   "devDependencies": {
     "@edge-runtime/types": "^4.0.0",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/01.setup/02.solution.multiple-workspaces/package.json b/exercises/01.setup/02.solution.multiple-workspaces/package.json
@@ -10,6 +10,6 @@
     "@edge-runtime/types": "^4.0.0",
     "@edge-runtime/vm": "^5.0.0",
     "edge-runtime": "^4.0.1",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/01.setup/03.problem.code-coverage/package.json b/exercises/01.setup/03.problem.code-coverage/package.json
@@ -6,6 +6,6 @@
   },
   "devDependencies": {
     "@vitest/ui": "^3.1.1",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/01.setup/03.solution.code-coverage/package.json b/exercises/01.setup/03.solution.code-coverage/package.json
@@ -7,6 +7,6 @@
   "devDependencies": {
     "@vitest/coverage-v8": "^3.1.1",
     "@vitest/ui": "^3.1.1",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/02.context/01.problem.custom-fixtures/package.json b/exercises/02.context/01.problem.custom-fixtures/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/02.context/01.solution.custom-fixtures/package.json b/exercises/02.context/01.solution.custom-fixtures/package.json
@@ -6,6 +6,6 @@
   },
   "devDependencies": {
     "@faker-js/faker": "^9.7.0",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/02.context/02.problem.automatic-fixtures/package.json b/exercises/02.context/02.problem.automatic-fixtures/package.json
@@ -5,7 +5,7 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "sqlite3": "^5.1.7"
diff --git a/exercises/02.context/02.solution.automatic-fixtures/package.json b/exercises/02.context/02.solution.automatic-fixtures/package.json
@@ -5,7 +5,7 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "sqlite3": "^5.1.7"
diff --git a/exercises/03.assertions/01.problem.custom-matchers/vitest.setup.ts b/exercises/03.assertions/01.problem.custom-matchers/vitest.setup.ts
@@ -17,17 +17,11 @@
 // 🐨 Augment the type definition for the `vitest` module.
 // 💰 declare module 'name' {}
 //
-// 🐨 Inside the module declaration, declare an interface called `Assertion<T = any>`.
+// 🐨 Inside the module declaration, declare an interface called `Matchers<T>`.
 // Make it extend the `CustomMatchers` interface you created earlier.
 // This will extend the type definitions of the `expect()` function to recognize
 // your custom matchers.
-// 💰 interface Assertion<T = any> extends CustomMatchers<T> {}
-//
-// 🐨 In a similar way, declare another interface called `MatchersDeclaration`
-// and make it extend your `CustomMatchers` interface.
-// This will extend the type definitions of the `expect.extend()` function
-// to make the implementation of your custom matchers type-safe.
-// 💰 interface MatchersDeclaration extends CustomMatchers {}
+// 💰 interface Matchers<T> extends CustomMatchers<T> {}
 //
 // This covers your custom matcher on the type-level.
 // Now, let's continue with its implementation!
diff --git a/exercises/03.assertions/01.solution.custom-matchers/README.mdx b/exercises/03.assertions/01.solution.custom-matchers/README.mdx
@@ -50,7 +50,7 @@ But this is only half of the story. Running this `expect()` statement will throw
 
 To provide a matcher implementation, call `expect.extend()` and provide it with an object that contains the definitions for your custom matchers:
 
-```ts filename=vitest.setup.ts add=1,13-15
+```ts filename=vitest.setup.ts add=1,12-14
 import { expect } from 'vitest'
 import type { Schema } from 'zod'
 
@@ -59,8 +59,7 @@ interface CustomMatchers<MatcherResult = any> {
 }
 
 declare module 'vitest' {
-	interface Assertion<T = any> extends CustomMatchers<T> {}
-	interface MatchersDeclaration extends CustomMatchers {}
+	interface Matchers<T> extends CustomMatchers<T> {}
 }
 
 expect.extend({
diff --git a/exercises/03.assertions/02.problem.asymmetric-matchers/package.json b/exercises/03.assertions/02.problem.asymmetric-matchers/package.json
@@ -6,7 +6,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "zod": "^3.24.2"
diff --git a/exercises/03.assertions/02.solution.asymmetric-matchers/README.mdx b/exercises/03.assertions/02.solution.asymmetric-matchers/README.mdx
@@ -2,19 +2,9 @@
 
 <EpicVideo url="https://www.epicweb.dev/workshops/advanced-vitest-patterns/assertions/03-02-problem/solution" />
 
-To expose my `.toMatchSchema()` matcher as an asymmetric matcher, I will extend the `AsymmetricMatchersContaining` interface of the `vitest` module:
-
-```ts nonumber add=4
-declare module 'vitest' {
-	interface Assertion<T = any> extends CustomMatchers<T> {}
-	interface MatchersDeclaration extends CustomMatchers {}
-	interface AsymmetricMatchersContaining extends CustomMatchers {}
-}
-```
-
-> The `AsymmetricMatchersContaining` controls the matcher types available as asymmetric matchers on the `expect` object (e.g. `expect.objectContaining()`).
+To expose my `.toMatchSchema()` matcher as an asymmetric matcher, I need to... do nothing! Vitest automatically provides both symmetric and asymmetric versions for your custom matchers, including type definitions.
 
-With this change, the type error in the `src/fetch-user.test.ts` is finally gone! 🎉
+All that's left for me to do is to use the asymmetric version of the `toMatchSchema()` matcher in tests:
 
 ```ts filename=src/fetch-user.test.ts highlight=6
 import { fetchUser } from './fetch-user'
@@ -26,9 +16,7 @@ test('returns the user by id', async () => {
 })
 ```
 
-This means that I can use the `.toMatchSchema()` matcher as asymmetric, which is exactly what I need to complete the test case for user transactions.
-
-In `src/fetch-transaction.test.ts`, I will write the remaining test:
+And in `src/fetch-transaction.test.ts`, I will write the remaining test:
 
 ```ts filename=src/fetch-transaction.test.ts add=5-11
 import { fetchTransaction, type Transaction } from './fetch-transaction'
@@ -45,7 +33,7 @@ test('fetches a transaction between two users', async () => {
 })
 ```
 
-> 🦉 Notice how I'm using schema validation to make sure that transaction's `issuer` and `recipient` properties both match the `userSchema`.
+> 🦉 Notice the usage of the `Transaction` type as the type argument to the default `.toEqual` matcher. It ensures that the expected value I pass to that matcher is type-safe.
 
 ## Related materials
 
diff --git a/exercises/03.assertions/02.solution.asymmetric-matchers/package.json b/exercises/03.assertions/02.solution.asymmetric-matchers/package.json
@@ -6,7 +6,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "zod": "^3.24.2"
diff --git a/exercises/03.assertions/03.problem.custom-quality-testers/package.json b/exercises/03.assertions/03.problem.custom-quality-testers/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/03.assertions/03.solution.custom-equality-testers/package.json b/exercises/03.assertions/03.solution.custom-equality-testers/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/03.assertions/04.problem.retryable-assertions/package.json b/exercises/03.assertions/04.problem.retryable-assertions/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/03.assertions/04.solution.retryable-assertions/package.json b/exercises/03.assertions/04.solution.retryable-assertions/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/03.assertions/05.problem.soft-assertions/package.json b/exercises/03.assertions/05.problem.soft-assertions/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/03.assertions/05.solution.soft-assertions/package.json b/exercises/03.assertions/05.solution.soft-assertions/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/04.performance/01.problem.profiling-slow-tests/package.json b/exercises/04.performance/01.problem.profiling-slow-tests/package.json
@@ -5,7 +5,7 @@
     "test": "vitest --no-cache"
   },
   "devDependencies": {
-    "vitest": "^3.1.1",
+    "vitest": "^3.2.4",
     "vitest-profiler": "^0.1.8"
   }
 }
diff --git a/exercises/04.performance/01.solution.profiling-slow-tests/package.json b/exercises/04.performance/01.solution.profiling-slow-tests/package.json
@@ -6,7 +6,7 @@
     "test:profile": "vitest-profiler npm test"
   },
   "devDependencies": {
-    "vitest": "^3.1.1",
+    "vitest": "^3.2.4",
     "vitest-profiler": "^0.1.8"
   }
 }
diff --git a/exercises/04.performance/02.problem.concurrency/package.json b/exercises/04.performance/02.problem.concurrency/package.json
@@ -6,6 +6,6 @@
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/04.performance/02.solution.concurrency/package.json b/exercises/04.performance/02.solution.concurrency/package.json
@@ -6,6 +6,6 @@
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/04.performance/03.problem.test-isolation/package.json b/exercises/04.performance/03.problem.test-isolation/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/exercises/04.performance/03.solution.test-isolation/package.json b/exercises/04.performance/03.solution.test-isolation/package.json
@@ -5,6 +5,6 @@
     "test": "vitest"
   },
   "devDependencies": {
-    "vitest": "^3.1.1"
+    "vitest": "^3.2.4"
   }
 }
diff --git a/package-lock.json b/package-lock.json

Original file line number	Diff line number	Diff line change
`@@ -5,6 +5,6 @@`
`5`	`5`	`"test": "vitest"`
`6`	`6`	`},`
`7`	`7`	`"devDependencies": {`
`8`		`- "vitest": "^3.1.1"`
	`8`	`+ "vitest": "^3.2.4"`
`9`	`9`	`}`
`10`	`10`	`}`
Original file line number	Diff line number	Diff line change
`@@ -6,6 +6,6 @@`
`6`	`6`	`},`
`7`	`7`	`"devDependencies": {`
`8`	`8`	`"@edge-runtime/types": "^4.0.0",`
`9`		`- "vitest": "^3.1.1"`
	`9`	`+ "vitest": "^3.2.4"`
`10`	`10`	`}`
`11`	`11`	`}`
Original file line number	Diff line number	Diff line change
`@@ -10,6 +10,6 @@`
`10`	`10`	`"@edge-runtime/types": "^4.0.0",`
`11`	`11`	`"@edge-runtime/vm": "^5.0.0",`
`12`	`12`	`"edge-runtime": "^4.0.1",`
`13`		`- "vitest": "^3.1.1"`
	`13`	`+ "vitest": "^3.2.4"`
`14`	`14`	`}`
`15`	`15`	`}`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,6 @@`
`7`	`7`	`"devDependencies": {`
`8`	`8`	`"@vitest/coverage-v8": "^3.1.1",`
`9`	`9`	`"@vitest/ui": "^3.1.1",`
`10`		`- "vitest": "^3.1.1"`
	`10`	`+ "vitest": "^3.2.4"`
`11`	`11`	`}`
`12`	`12`	`}`