mirror of
https://github.com/nuxt/nuxt.git
synced 2024-11-22 21:55:11 +00:00
137 lines
3.8 KiB
Markdown
137 lines
3.8 KiB
Markdown
---
|
|
title: Testing
|
|
description: How to test your Nuxt application.
|
|
navigation.icon: i-ph-check-circle-duotone
|
|
---
|
|
|
|
::callout
|
|
Test utils are still in development and the API and behavior may change. Currently, it is in preview stage but not yet ready for testing production apps.
|
|
If you are a module author, you can find more specific information in the [Module Author's guide](/docs/guide/going-further/modules#testing)
|
|
::
|
|
|
|
In Nuxt 3, we have a rewritten version of `@nuxt/test-utils`. We support [Vitest](https://github.com/vitest-dev/vitest) and [Jest](https://jestjs.io) as test runners.
|
|
|
|
## Installation
|
|
|
|
::code-group
|
|
```bash [yarn]
|
|
yarn add --dev @nuxt/test-utils vitest
|
|
```
|
|
```bash [npm]
|
|
npm i --save-dev @nuxt/test-utils vitest
|
|
```
|
|
```bash [pnpm]
|
|
pnpm add -D @nuxt/test-utils vitest
|
|
```
|
|
```bash [bun]
|
|
bun add --dev @nuxt/test-utils vitest
|
|
```
|
|
::
|
|
|
|
## Setup
|
|
|
|
In each `describe` block where you are taking advantage of the `@nuxt/test-utils` helper methods, you will need to set up the test context before beginning.
|
|
|
|
```ts [test/my-test.spec.ts]
|
|
import { describe, test } from 'vitest'
|
|
import { setup, $fetch } from '@nuxt/test-utils'
|
|
|
|
describe('My test', async () => {
|
|
await setup({
|
|
// test context options
|
|
})
|
|
|
|
test('my test', () => {
|
|
// ...
|
|
})
|
|
})
|
|
```
|
|
|
|
Behind the scenes, `setup` performs a number of tasks in `beforeAll`, `beforeEach`, `afterEach` and `afterAll` to set up the Nuxt test environment correctly.
|
|
|
|
Please use the options below for the `setup` method.
|
|
|
|
### Nuxt Config
|
|
|
|
- `rootDir`: Path to a directory with a Nuxt app to be put under test.
|
|
- Type: `string`
|
|
- Default: `'.'`
|
|
- `configFile`: Name of the configuration file.
|
|
- Type: `string`
|
|
- Default: `'nuxt.config'`
|
|
|
|
<!--
|
|
- `config`: Object with configuration overrides.
|
|
- Type: `NuxtConfig`
|
|
- Default: `{}` -->
|
|
|
|
### Timings
|
|
|
|
- `setupTimeout`: The amount of time (in milliseconds) to allow for `setupTest` to complete its work (which could include building or generating files for a Nuxt application, depending on the options that are passed).
|
|
- Type: `number`
|
|
- Default: `60000`
|
|
|
|
### Features
|
|
|
|
- `server`: Whether to launch a server to respond to requests in the test suite.
|
|
- Type: `boolean`
|
|
- Default: `true`
|
|
|
|
- `port`: If provided, set the launched test server port to the value.
|
|
- Type: `number | undefined`
|
|
- Default: `undefined`
|
|
|
|
- `build`: Whether to run a separate build step.
|
|
- Type: `boolean`
|
|
- Default: `true` (`false` if `browser` or `server` is disabled)
|
|
- `browser`: Under the hood, Nuxt test utils uses [`playwright`](https://playwright.dev) to carry out browser testing. If this option is set, a browser will be launched and can be controlled in the subsequent test suite.
|
|
- Type: `boolean`
|
|
- Default: `false`
|
|
- `browserOptions`
|
|
- Type: `object` with the following properties
|
|
- `type`: The type of browser to launch - either `chromium`, `firefox` or `webkit`
|
|
- `launch`: `object` of options that will be passed to playwright when launching the browser. See [full API reference](https://playwright.dev/docs/api/class-browsertype#browser-type-launch).
|
|
- `runner`: Specify the runner for the test suite. Currently, [Vitest](https://vitest.dev) is recommended.
|
|
- Type: `'vitest' | 'jest'`
|
|
- Default: `'vitest'`
|
|
|
|
## APIs
|
|
|
|
### `$fetch(url)`
|
|
|
|
Get the HTML of a server-rendered page.
|
|
|
|
```ts
|
|
import { $fetch } from '@nuxt/test-utils'
|
|
|
|
const html = await $fetch('/')
|
|
```
|
|
|
|
### `fetch(url)`
|
|
|
|
Get the response of a server-rendered page.
|
|
|
|
```ts
|
|
import { fetch } from '@nuxt/test-utils'
|
|
|
|
const res = await fetch('/')
|
|
const { body, headers } = res
|
|
```
|
|
|
|
### `url(path)`
|
|
|
|
Get the full URL for a given page (including the port the test server is running on.)
|
|
|
|
```ts
|
|
import { url } from '@nuxt/test-utils'
|
|
|
|
const pageUrl = url('/page')
|
|
// 'http://localhost:6840/page'
|
|
```
|
|
|
|
## Testing in a Browser
|
|
|
|
::callout
|
|
We are working on it, stay tuned!
|
|
::
|