Releases · nuxt/test-utils

15 May 16:03

danielroe

v3.13.0

ff98d93

v3.13.0 Latest

Latest

compare changes

🚀 Enhancements

e2e: Improve types for $fetch (b21d9a54)
deps: Upgrade execa to v9 (#843)

🔥 Performance

e2e: Don't iterate when cleaning up if nothing registered (#753)

🩹 Fixes

e2e: Improve types for fetch and mockLogger (eb40a6a6)
e2e: Force string response within startServer (1b182505)
e2e: Improve return types for mockLogger (21aa7a2f)
runtime: Improve types for renderSuspended and mountSuspended (1636cede)
e2e: Revert changes for $fetch inference to unbreak build (dd295d39)
vitest: Strongly type vitest environment options (37582c71)
module: Correctly filter vite plugins (021824d0)
runtime: Preserve setupState return (ab7fd457)
playwright: Bump dependency and remove polyfill (#819)
runtime: Use effectScope in renderSuspended (#820)
e2e: Type $fetch using globalThis instead (b1269edb)
Set buildId to nuxt-app for compatibility with nuxt v3.12+ (a00b2c1f)
runtime-utils: Use tryUseNuxtApp rather than buildId override (726e0a2d)

🏡 Chore

Migrate to eslint v9 (#814)
Reduce internal typing of any (3e3bc306)
Reenable no-explicit-any rule (28385546)
Normalise internal package names (3f58b110)
Update example command (e271b63e)
Add name for app-vitest-full (882c144e)
Ignore @nuxt/devtools upgrades for now (54f654d6)
Lint (08ee3515)

❤️ Contributors

Daniel Roe (@danielroe)
Michael Brevard [email protected]

Assets 2

15 Apr 14:51

danielroe

v3.12.1

bf553e6

v3.12.1

compare changes

🩹 Fixes

Publish playwright.d.ts (#797)

❤️ Contributors

Ryota Watanabe (@wattanx)

Contributors

wattanx

Assets 2

16 Mar 21:46

danielroe

v3.12.0

9e33a15

v3.12.0

compare changes

🚀 Enhancements

e2e: Add 'route'/'hydration' options for page.goto() (#739)
e2e: Add playwright runner (#776)

🩹 Fixes

config: Remove nuxt's custom vite logger (eca52f5c)

🏡 Chore

Force correct typing for e2e subpath (9fd93a8c)
Don't run publish step separately (0078d0bc)

🤖 CI

Remove caching of Playwright browsers (#785)
Add release workflow (76604ce0)
Update changelogen command (e3368daf)
Add git user (5aa95b02)
Add contents permission (cf6cd3a8)
Rename some workflows (7ea235e9)
Do less in workflow (1f664fc5)

❤️ Contributors

Daniel Roe (@danielroe)
Max Schmitt (@mxschmitt)

Contributors

mxschmitt and danielroe

Assets 2

28 Jan 12:32

danielroe

v3.11.0

5fe47be

v3.11.0

compare changes

🚀 Enhancements

vitest-environment: Add support for in-source testing (#651)

🩹 Fixes

runtime: Reset modules after nuxt setup runs (#726)

✅ Tests

Add example of mocking vue-router (e293cea1)
Add example of mocking nuxt useRoute (fe465193)

❤️ Contributors

Daniel Roe (@danielroe)

Contributors

danielroe

Assets 2

17 Jan 15:52

danielroe

v3.10.0

bc86d23

v3.10.0

compare changes

🚀 Enhancements

e2e: Add cucumber test runner (#711)
e2e: Support env option for startServer (#640)

🩹 Fixes

runtime-utils: Resolve to in RouterLink stub (#687)
Mark afterAll and setup hooks as async (#702)
module: Always append import when mocking (#701)

🏡 Chore

Add required dev deps to app-vitest example (#712)
Pin vue/nuxt versions (00674cd0)

✅ Tests

Update config key (25060645)
Add example test for nuxt-injected value (#663)
Update to actually use $t (#675)

🤖 CI

Fetch-depth: 0 (269df289)

❤️ Contributors

Bobbie Goede (@BobbieGoede)
Daniel Roe (@danielroe)
Julien Huang (@huang-julien)
Albert Brand (@AlbertBrand)
Steve Pewsey (@StevenPewsey)

Contributors

AlbertBrand, BobbieGoede, and 3 other contributors

Assets 2

19 Dec 13:42

danielroe

v3.9.0

681d8d3

v3.9.0

👀 Highlights

v3.9.0 is a significant release of @nuxt/test-utils. Most notably:

We've split it out from the core nuxt/nuxt repository for a decoupled release cycle.
We've merged in nuxt-vitest and vitest-environment-nuxt into a single repository for both runtime unit testing and e2e/browser testing with Nuxt.
We've added documentation on https://nuxt.com/docs/getting-started/testing to get you started.

✅ Upgrading

... from `@nuxt/test-utils`

If you were upgrading from @nuxt/test-utils, the only significant change is to update your imports to @nuxt/test-utils/e2e (for clarity).

If you were using the jest runner, this should now be auto-detected and you can remove runner: 'jest' from your test configuration.

... from `nuxt-vitest`

If you previously used nuxt-vitest, we have now merged it into @nuxt/test-utils, as well as implementing a range of fixes.

👉 Here are the required steps.

Uninstall nuxt-vitest
```
npm remove nuxt-vitest
```

Update your vitest versions to v1, and update @nuxt/test-utils and vitest-environment-nuxt to the latest versions:

  "devDependencies": {
-   "@nuxt/test-utils": "^3.8.1",
+   "@nuxt/test-utils": "^3.9.0",
-   "@vitest/coverage-v8": "0.33.0",
+   "@vitest/coverage-v8": "^1.0.4",
    "@vue/test-utils": "^2.4.3",
-   "nuxt-vitest": "^0.11.5",
-   "vitest": "^0.33.0",
+   "vitest": "^1.0.4",
+   "vitest-environment-nuxt": "^1.0.0"
  },

Update your nuxt.config if you have added the nuxt-vitest module to it, and update the configuration from vitest to testUtils:

  export default defineNuxtConfig({
   modules: [
-    'nuxt-vitest'
+    '@nuxt/test-utils/module'
   ],
-  vitest: {}
+  testUtils: {}
  })

Update any imports from nuxt-vitest and vitest-environment-nuxt and @nuxt/test-utils:

-  import { mountSuspended } from 'nuxt-vitest/utils' // or 'vitest-environment-nuxt/utils'
+  import { mountSuspended } from '@nuxt/test-utils/runtime'

-  import { defineVitestConfig } from 'vitest-environment-nuxt/config' // or 'nuxt-vitest/config'
+  import { defineVitestConfig } from '@nuxt/test-utils/config'

-  import { setup, $fetch } from '@nuxt/test-utils'
+  import { setup, $fetch } from '@nuxt/test-utils/e2e'

Ensure vitest is running in a module context (either by checking you have type: 'module' set in your package.json, or by renaming your vitest.config file to vitest.config.mts or vitest.config.mjs.