- All versions before these are no longer supported. Users should upgrade
- to receive updates.
+ All versions before these are no longer supported. Users should upgrade to receive updates.
If you're using Vitest
- , it is
- {{
- checkedResult.text
- }}.
+ , it
+ is {{ checkedResult.text }}.
diff --git a/.vitepress/theme/index.ts b/.vitepress/theme/index.ts
index 0db709fa..c2ddd5f1 100644
--- a/.vitepress/theme/index.ts
+++ b/.vitepress/theme/index.ts
@@ -35,7 +35,11 @@ function getRedirectPath(url: URL) {
// /config/#reporters -> /config/reporters
// /config/#coverage-provider -> /config/coverage#coverage-provider
// /config/#browser.enabled -> /config/browser/enabled
- if (url.pathname === '/config' || url.pathname === '/config/' || url.pathname === '/config.html') {
+ if (
+ url.pathname === '/config' ||
+ url.pathname === '/config/' ||
+ url.pathname === '/config.html'
+ ) {
if (url.hash.startsWith('#browser.')) {
const [page, ...hash] = url.hash.slice('#browser.'.length).toLowerCase().split('-')
return `/config/browser/${page}${hash.length ? `#${[page, ...hash].join('-')}` : ''}`
@@ -44,7 +48,11 @@ function getRedirectPath(url: URL) {
return `/config/${page}${hash.length ? `#${[page, ...hash].join('-')}` : ''}`
}
// /guide/browser/config#browser.locators-testidattribute -> /config/browser/locators#browser-locators-testidattribute
- if (url.pathname === '/guide/browser/config' || url.pathname === '/guide/browser/config/' || url.pathname === '/guide/browser/config.html') {
+ if (
+ url.pathname === '/guide/browser/config' ||
+ url.pathname === '/guide/browser/config/' ||
+ url.pathname === '/guide/browser/config.html'
+ ) {
const [page, ...hash] = url.hash.slice('#browser.'.length).toLowerCase().split('-')
return `/config/browser/${page}${hash.length ? `#${[page, ...hash].join('-')}` : ''}`
}
diff --git a/.vitepress/theme/styles.css b/.vitepress/theme/styles.css
index ac0512b6..776336c2 100644
--- a/.vitepress/theme/styles.css
+++ b/.vitepress/theme/styles.css
@@ -1,9 +1,9 @@
-@import "@voidzero-dev/vitepress-theme/src/styles/index.css";
+@import '@voidzero-dev/vitepress-theme/src/styles/index.css';
@source "./**/*.vue";
/* Vitest */
-:root[data-variant="vitest"] {
+:root[data-variant='vitest'] {
--color-brand: #008039;
/* TODO: home page wcag-aa color contrast (remove this once fixed at void0 theme):
* - why vitest section and texts
@@ -13,19 +13,18 @@
--color-grey: #867e8e;
}
-:root.dark:not([data-theme])[data-variant="vitest"],
-:root[data-theme="dark"][data-variant="vitest"] {
+:root.dark:not([data-theme])[data-variant='vitest'],
+:root[data-theme='dark'][data-variant='vitest'] {
--color-brand: var(--color-zest);
}
-:root[data-variant="vitest"]:not(.dark):not([data-theme="light"]),
-:root[data-theme="light"][data-variant="vitest"] {
+:root[data-variant='vitest']:not(.dark):not([data-theme='light']),
+:root[data-theme='light'][data-variant='vitest'] {
--color-brand: #008039;
/* TODO: code block (remove this once fixed at void0 theme) */
--vp-code-color: #007d38;
}
-
.highlighted-word {
background-color: var(--vp-code-line-highlight-color);
transition: background-color 0.5s;
@@ -39,6 +38,34 @@
margin: 1rem 0 0.5rem;
}
+.vp-doc a.button,
+.vp-doc a.button:hover {
+ color: revert-layer;
+ text-decoration: none;
+ transition: revert-layer;
+}
+
+.button.button--brand {
+ --button-brand-outline: color-mix(in srgb, var(--color-brand) 40%, transparent);
+ background-color: var(--vp-c-tip-soft);
+ outline-color: var(--button-brand-outline);
+}
+
+.button.button--brand:hover {
+ background-color: color-mix(in srgb, var(--color-brand) 24%, transparent);
+}
+
+.dark .button.button--brand:hover {
+ color: var(--color-white);
+}
+
+/* the base reset removes the outline on a clicked button, but .button draws its border with it */
+@layer base {
+ button.button--brand:focus:not(:focus-visible) {
+ outline: 1px solid var(--button-brand-outline) !important;
+ }
+}
+
/* credit goes to https://dylanatsmith.com/wrote/styling-the-kbd-element */
html:not(.dark) .VPContent kbd {
--kbd-color-background: #f7f7f7;
diff --git a/api/advanced/artifacts.md b/api/advanced/artifacts.md
index 0243944c..51a7dc3a 100644
--- a/api/advanced/artifacts.md
+++ b/api/advanced/artifacts.md
@@ -2,7 +2,9 @@
outline: deep
title: Test Artifacts
---
+
+
# Test Artifacts 4.0.11
::: warning
diff --git a/api/advanced/plugin.md b/api/advanced/plugin.md
index 1940d115..5ee10998 100644
--- a/api/advanced/plugin.md
+++ b/api/advanced/plugin.md
@@ -14,6 +14,7 @@ outline: deep
Vitest 自 3.1 版起支持 `configureVitest` [插件](https://cn.vite.dev/guide/api-plugin) hook。
::: code-group
+
```ts [only vitest]
import type { Vite, VitestPluginContext } from 'vitest/node'
@@ -26,6 +27,7 @@ export function plugin(): Vite.Plugin {
}
}
```
+
```ts [vite and vitest]
///
@@ -43,14 +45,16 @@ export function plugin(): Plugin {
}
}
```
+
:::
::: tip TypeScript
-Vitest 通过 `Vite` namespace 重新导出所有仅 Vite 类型的导入，我们可以使用它来保持版本同步。但是，如果我们正在为 Vite 和 Vitest 编写插件，则可以继续使用 `vite` 入口点的 `Plugin` 类型。只需确保我们在某处引用了 `vitest/config` ，以便正确增强 `configureVitest` 即可：
+Vitest 通过 `Vite` namespace 重新导出所有仅 Vite 类型的导入，我们可以使用它来保持版本同步。但是，如果我们正在为 Vite 和 Vitest 编写插件，则可以继续使用 `vite` 入口点的 `Plugin` 类型。只需确保我们在某处引用了 `vitest/config` ，以便正确增强 `configureVitest` 即可：
```ts
///
```
+
:::
与 [`reporter.onInit`](/api/advanced/reporters#oninit) 不同，此 hooks 在 Vitest 生命周期的早期运行，允许我们更改 `coverage` 和 `reporters` 等配置。更值得注意的变化是，如果我们的插件是在项目中定义而不是在全局配置中定义的，我们可以从 [工作区项目](/guide/projects) 操作全局配置。
@@ -124,7 +128,6 @@ vitest.config.project.push('my-project-name')
请注意，`name` 永远不会被继承，因为 Vitest 不允许多个项目使用相同的名称。请确保每个项目都有唯一的名称。可以通过 `project.name` 属性访问当前名称，所有已使用的名称都可以在 `vitest.projects` 数组中找到。
:::
-
### defineCacheKeyGenerator 5.0.0 {#definecachekeygenerator}
```ts
diff --git a/api/advanced/reporters.md b/api/advanced/reporters.md
index ea1cf7b7..7ac12871 100644
--- a/api/advanced/reporters.md
+++ b/api/advanced/reporters.md
@@ -61,6 +61,7 @@ class MyReporter implements Reporter {
export default new MyReporter()
```
+
:::
## onBrowserInit {#onbrowserinit}
@@ -95,6 +96,7 @@ class MyReporter implements Reporter {
export default new MyReporter()
```
+
:::
## onTestRunEnd
@@ -158,6 +160,7 @@ class MyReporter implements Reporter {
export default new MyReporter()
```
+
:::
## onCoverage
diff --git a/api/advanced/runner.md b/api/advanced/runner.md
index ab31176a..ee7f6944 100644
--- a/api/advanced/runner.md
+++ b/api/advanced/runner.md
@@ -138,6 +138,7 @@ export default class Runner {
}
}
```
+
:::
::: warning
@@ -263,16 +264,18 @@ export interface TaskResult {
*/
hooks?: Partial>
/**
- * 任务重试的次数。只有在任务失败且设置了 `retry` 选项时才会进行重试。
+ * The number of times the task has been retried across all repeats.
*/
retryCount?: number
/**
- * 任务重复的次数。只有在设置了 `repeats` 选项时才会重复任务。此数字也包括 `retryCount`。
+ * The zero-based index of the current repeat.
*/
repeatCount?: number
}
```
+
+
## 你的任务函数 {#your-task-function}
Vitest 提供了 `createTaskCollector` 工具来创建你自己的 `test` 方法。它的行为与测试相同，但在收集期间会调用自定义方法。
diff --git a/api/advanced/test-case.md b/api/advanced/test-case.md
index fd05f14d..740532be 100644
--- a/api/advanced/test-case.md
+++ b/api/advanced/test-case.md
@@ -143,6 +143,7 @@ test('the validation works correctly', ({ task }) => {
task.meta.decorated = false
})
```
+
如果测试尚未运行完毕，元数据将是一个空对象，除非它定义了静态元数据：
```ts
diff --git a/api/advanced/test-collection.md b/api/advanced/test-collection.md
index f19c83db..8b391f00 100644
--- a/api/advanced/test-collection.md
+++ b/api/advanced/test-collection.md
@@ -12,6 +12,7 @@ for (const child of module.children) {
console.log(child.type, child.name)
}
```
+
:::
## size
diff --git a/api/advanced/test-project.md b/api/advanced/test-project.md
index d5e6dfb5..3d963052 100644
--- a/api/advanced/test-project.md
+++ b/api/advanced/test-project.md
@@ -13,6 +13,7 @@ title: TestProject
名称是由用户分配或由 Vitest 解析的唯一字符串。如果用户没有提供名称，Vitest 会尝试加载项目根目录中的 `package.json` 并从中获取 `name` 属性。如果没有 `package.json`，Vitest 默认使用文件夹的名称。内联项目使用数字作为名称（转换为字符串）。
::: code-group
+
```ts [node.js]
import { createVitest } from 'vitest/node'
@@ -49,6 +50,7 @@ export default defineConfig({
},
})
```
+
:::
::: info
@@ -75,6 +77,7 @@ const config: SerializedConfig = vitest.projects[0].serializedConfig
```ts
project.serializedConfig === project.serializedConfig // ❌
```
+
:::
## globalConfig
@@ -129,6 +132,7 @@ function provide(
除了 [`config.provide`](/config/provide) 字段外，还提供了一种向测试提供自定义值的方法。所有值在存储之前都通过 [`structuredClone`](https://developer.mozilla.org/en-US/docs/Web/API/Window/structuredClone) 进行验证，但 `providedContext` 上的值本身不会被克隆。
::: code-group
+
```ts [node.js]
import { createVitest } from 'vitest/node'
@@ -142,6 +146,7 @@ await vitest.start()
import { inject } from 'vitest'
const value = inject('key')
```
+
:::
这些值可以动态提供。测试中提供的值将在下次运行时更新。
@@ -154,6 +159,7 @@ export default function setup({ provide }) {
provide('wsPort', 3000)
}
```
+
:::
## getProvidedContext
@@ -296,6 +302,7 @@ const dynamicExample = await project.import('./example.js')
dynamicExample !== staticExample // ✅
```
+
:::
::: info
diff --git a/api/advanced/test-specification.md b/api/advanced/test-specification.md
index d403ef4c..d69b80e2 100644
--- a/api/advanced/test-specification.md
+++ b/api/advanced/test-specification.md
@@ -55,12 +55,14 @@ Vite 模块图中的模块 ID。通常，它是一个使用 POSIX 分隔符的
请注意，如果这些行中的至少一行没有测试，整个测试套件将会失败。以下是一个正确的 `testLines` 配置示例：
::: code-group
+
```ts [script.js]
const specification = project.createSpecification(
resolve('./example.test.ts'),
[3, 8, 9],
)
```
+
```ts:line-numbers{3,8,9} [example.test.js]
import { test, describe } from 'vitest'
@@ -73,6 +75,7 @@ describe('a group of tests', () => { // [!code error]
test.skip('skipped test')
})
```
+
:::
## testNamePattern 4.1.0 {#testnamepattern}
diff --git a/api/advanced/vitest.md b/api/advanced/vitest.md
index dcee42e5..dc32cfa3 100644
--- a/api/advanced/vitest.md
+++ b/api/advanced/vitest.md
@@ -44,7 +44,42 @@ const testCase = vitest.state.getReportedEntity(task) // 新 API
## cache
-缓存管理器，存储有关最新测试结果和测试文件状态的信息。在 Vitest 中，这仅由默认的排序器用于排序测试。
+
+
+Cache manager that stores the results of the previous test runs. In Vitest itself this is only used by the default sequencer to sort tests.
+
+### cache.getTestSpecificationResult 5.0.4 {#cache-gettestspecificationresult}
+
+Returns the result of the test file from the previous test runs, or `undefined` if Vitest has no result for it.
+
+```ts
+function getTestSpecificationResult(
+ specification: TestSpecification
+): CachedTestFileResult | undefined
+
+interface CachedTestFileResult {
+ /**
+ * The file has a known failure.
+ * Only a complete run of the file clears it.
+ */
+ failed: boolean
+ /**
+ * Duration of the last complete run in milliseconds.
+ */
+ duration: number
+ /**
+ * Unix timestamp in milliseconds of the start of the last complete run.
+ * It is not set if the file never ran completely.
+ */
+ lastRun?: number
+}
+```
+
+A run is not complete if it was cancelled or if it executed only a part of the file, for example, because of a test name pattern, a line filter or `.only`.
+
+::: warning
+`vitest.cache.getFileTestResults` and `vitest.cache.getFileStats` are deprecated and will be removed in the next major version. Use `getTestSpecificationResult` instead of `getFileTestResults`. Vitest does not cache file sizes anymore; read the size from the file system if your sequencer needs it.
+:::
## watcher 4.0.0 {#watcher}
@@ -410,6 +445,7 @@ const dynamicExample = await vitest.import('./example.js')
dynamicExample !== staticExample // ✅
```
+
:::
::: info
@@ -587,6 +623,7 @@ import { escapeTestName } from 'vitest/node'
// 转换为 /hello, .+?/
const escapedPattern = new RegExp(escapeTestName('hello, %s', true))
```
+
:::
::: warning
@@ -667,6 +704,7 @@ export interface SourceModuleDiagnostic {
untrackedModules: UntrackedModuleDefinitionDiagnostic[]
}
```
+
:::
返回模块的诊断信息。如果未提供 [`testModule`](/api/advanced/test-module)，则 `selfTime` 和 `totalTime` 将聚合上次运行的所有测试。如果模块未被转换或执行，诊断信息将为空。
@@ -778,7 +816,6 @@ const filenames: string[] = await report.readdir()
### Report.delete
-
```ts
function delete(filename: string): Promise
```
diff --git a/api/assert.md b/api/assert.md
index c2c0410a..4bf82141 100644
--- a/api/assert.md
+++ b/api/assert.md
@@ -6,7 +6,8 @@ Vitest 从 [`chai`](https://www.chaijs.com/api/assert/) 重新导出了 `assert`
在 [源码内联测试](/guide/in-source) 中使用来自 `import.meta.vitest` 的 [断言函数](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-7.html#assertion-functions)（例如 `assert`）时，TypeScript 会报告 `TS2775` 错误，因为这类函数必须通过带有显式类型注解的名称来调用。请为该变量标注 Chai.Assert，或直接调用它：
::: code-group
-```ts [类型注释变量]
+
+```ts [带类型注解的变量]
if (import.meta.vitest) {
const { test, assert } = import.meta.vitest // [!code --]
const { test } = import.meta.vitest // [!code ++]
@@ -17,6 +18,7 @@ if (import.meta.vitest) {
})
}
```
+
```ts [直接调用]
if (import.meta.vitest) {
const { test, assert } = import.meta.vitest // [!code --]
@@ -28,6 +30,7 @@ if (import.meta.vitest) {
})
}
```
+
:::
## assert
@@ -763,7 +766,7 @@ test('assert.notInclude', () => {
- `(haystack: readonly T[] | ReadonlySet | ReadonlyMap, needle: T, message?: string) => void`
- `(haystack: T, needle: T extends WeakSet ? never : Partial, message?: string) => void`
-断言 `haystack` 包含 `needle` 。可以用来断言数组中是否包含一个值或对象中是否包含一组属性。使用深度相等。
+断言 `haystack` 包含 `needle` 。可以用来断言数组中是否包含一个值或对象中是否包含一组属性。使用深度相等。
```ts
import { assert, test } from 'vitest'
diff --git a/api/browser/assertions.md b/api/browser/assertions.md
index b6558b6d..c56f944a 100644
--- a/api/browser/assertions.md
+++ b/api/browser/assertions.md
@@ -12,6 +12,7 @@ Vitest 默认提供了一组丰富的 DOM 断言，这些断言源自 [`@testing
```ts
///
```
+
:::
浏览器中的测试由于其异步特性，可能会不一致地失败。因此，即使条件延迟（如超时、网络请求或动画），也必须有办法保证断言成功。为此，Vitest 通过 [`expect.poll`](/api/expect#poll) 和 `expect.element` API 提供了可重试的断言：
@@ -62,6 +63,7 @@ interface ExpectPollOptions {
// 如果 .textContent 不是 `'Error!'`，则会立即失败。
expect(banner).toMatchTextContent('Error!')
```
+
:::
## toBeDisabled
@@ -697,7 +699,7 @@ await expect.element(button).not.toHaveStyle({
```ts
function toHaveTextContent(
- text: string | number,
+ text?: string | number,
options?: { normalizeWhitespace: boolean }
): Promise
```
@@ -715,6 +717,10 @@ const element = getByTestId('text-content')
await expect.element(element).toHaveTextContent('Text Content')
await expect.element(element).not.toHaveTextContent('Content')
+// element has some text content
+await expect.element(element).toHaveTextContent()
+// element has no text content
+await expect.element(page.getByTestId('empty')).not.toHaveTextContent()
```
## toMatchTextContent
@@ -965,6 +971,7 @@ await expect.element(getByTestId('link-invalid')).toHaveRole('generic')
await expect.element(getByTestId('switch')).toHaveRole('switch') // ✅
await expect.element(getByTestId('switch')).toHaveRole('alert') // ❌
```
+
:::
## toHaveSelection
@@ -1137,6 +1144,7 @@ await expect.element(getByTestId('button')).toMatchScreenshot('fancy-button', {
},
})
```
+
:::
- `screenshotOptions: object`
diff --git a/api/browser/commands.md b/api/browser/commands.md
index 1a727878..9ae8c50d 100644
--- a/api/browser/commands.md
+++ b/api/browser/commands.md
@@ -193,8 +193,7 @@ export const uploadFixture: BrowserCommand<[name: string]> = async (
如果未启用浏览器追踪，或当前会话中没有正在运行的测试，`context.mark` 不会执行任何操作。与 `page.mark` 不同，它不支持传入回调函数。
-
-### 自定义 `playwright` 命令 {#custom-playwright-commands}
+### 自定义 `playwright` 命令 {#custom-playwright-commands}
Vitest 在命令上下文中公开了几个`playwright`特定属性。
diff --git a/api/browser/context.md b/api/browser/context.md
index 90b714b4..b828b9f7 100644
--- a/api/browser/context.md
+++ b/api/browser/context.md
@@ -191,7 +191,7 @@ await button.click() // 交互式方法可以正常工作 ✅
await expect.element(button).toBeVisible() // 查询元素失败 ❌
```
-如果你需要处理跨域 iframe，你需要在 [`launchOptions`](/config/browser/playwright.html#launchoptions) 中传递 `args: ["--disable-web-security"]`。或者创建一个自定义的 [浏览器命令](/api/browser/commands.html#custom-commands)，在服务器端访问可用的 iframe。
+如果你需要处理跨域 iframe，你需要在 [`launchOptions`](/config/browser/playwright#launchoptions) 中传递 `args: ["--disable-web-security"]`。或者创建一个自定义的 [浏览器命令](/api/browser/commands#custom-commands)，在服务器端访问可用的 iframe。
:::
::: danger 重要
diff --git a/api/browser/locators.md b/api/browser/locators.md
index fa7e2701..c5c46cf1 100644
--- a/api/browser/locators.md
+++ b/api/browser/locators.md
@@ -34,6 +34,7 @@ const deleteButton = page
await deleteButton.click()
await expect.element(deleteButton).toBeEnabled()
```
+
:::
## getByRole
@@ -88,11 +89,13 @@ await page.getByRole('button', { name: /submit/i }).click()
根据 ARIA 指南，**强烈不建议** 通过 `role` 或 `aria-*` 属性为已经具有隐式角色的内置元素提供角色。
:::
+
+
**Options**
- `exact: boolean`
- `name` 是否精确匹配：区分大小写且完全匹配字符串。默认情况下禁用此选项。如果 `name` 是正则表达式，则忽略此选项。请注意，精确匹配仍然会修剪空白字符。
+ Whether the `name` is matched exactly: case-sensitive and whole-string. Defaults to [`browser.locators.exact`](/config/browser/locators#browser-locators-exact), which is `true` by default. This option is ignored if `name` is a regular expression. Note that exact match still trims whitespace.
```tsx
@@ -236,11 +239,13 @@ page.getByAltText(/incredibles.*? poster/i) // ✅
page.getByAltText('non existing alt text') // ❌
```
+
+
**Options**
- `exact: boolean`
- `text` 是否精确匹配：区分大小写且完全匹配字符串。默认情况下禁用此选项。如果 `text` 是正则表达式，则忽略此选项。请注意，精确匹配仍然会修剪空白字符。
+ Whether the `text` is matched exactly: case-sensitive and whole-string. Defaults to [`browser.locators.exact`](/config/browser/locators#browser-locators-exact), which is `true` by default. This option is ignored if `text` is a regular expression. Note that exact match still trims whitespace.
**更多内容请参阅**
@@ -283,11 +288,13 @@ function getByLabelText(
```
+
+
**Options**
- `exact: boolean`
- `text` 是否精确匹配：区分大小写且完全匹配字符串。默认情况下禁用此选项。如果 `text` 是正则表达式，则忽略此选项。请注意，精确匹配仍然会修剪空白字符。
+ Whether the `text` is matched exactly: case-sensitive and whole-string. Defaults to [`browser.locators.exact`](/config/browser/locators#browser-locators-exact), which is `true` by default. This option is ignored if `text` is a regular expression. Note that exact match still trims whitespace.
**更多内容请参阅**
@@ -315,11 +322,13 @@ page.getByPlaceholder('not found') // ❌
通常情况下，使用 [`getByLabelText`](#getbylabeltext) 依赖标签比依赖占位符更好。
:::
+
+
**Options**
- `exact: boolean`
- `text` 是否精确匹配：区分大小写且完全匹配字符串。默认情况下禁用此选项。如果 `text` 是正则表达式，则忽略此选项。请注意，精确匹配仍然会修剪空白字符。
+ Whether the `text` is matched exactly: case-sensitive and whole-string. Defaults to [`browser.locators.exact`](/config/browser/locators#browser-locators-exact), which is `true` by default. This option is ignored if `text` is a regular expression. Note that exact match still trims whitespace.
**更多内容请参阅**
@@ -347,11 +356,13 @@ page.getByText('about', { exact: true }) // ❌
此定位器适用于定位非交互式元素。如果你需要定位交互式元素，比如按钮或输入框，建议使用 [`getByRole`](#getbyrole)。
:::
+
+
**Options**
- `exact: boolean`
- `text` 是否精确匹配：区分大小写且完全匹配字符串。默认情况下禁用此选项。如果 `text` 是正则表达式，则忽略此选项。请注意，精确匹配仍然会修剪空白字符。
+ Whether the `text` is matched exactly: case-sensitive and whole-string. Defaults to [`browser.locators.exact`](/config/browser/locators#browser-locators-exact), which is `true` by default. This option is ignored if `text` is a regular expression. Note that exact match still trims whitespace.
**更多内容请参阅**
@@ -375,11 +386,13 @@ page.getByTitle('Delete') // ✅
page.getByTitle('Create') // ❌
```
+
+
**Options**
- `exact: boolean`
- `text` 是否精确匹配：区分大小写且完全匹配字符串。默认情况下禁用此选项。如果 `text` 是正则表达式，则忽略此选项。请注意，精确匹配仍然会修剪空白字符。
+ Whether the `text` is matched exactly: case-sensitive and whole-string. Defaults to [`browser.locators.exact`](/config/browser/locators#browser-locators-exact), which is `true` by default. This option is ignored if `text` is a regular expression. Note that exact match still trims whitespace.
**更多内容请参阅**
@@ -404,12 +417,6 @@ page.getByTestId('non-existing-element') // ❌
建议仅在其他定位器不适用于你的使用场景时才使用此方法。使用 `data-testid` 属性并不符合用户实际使用软件的方式，因此如果可能应避免使用。
:::
-**Options**
-
-- `exact: boolean`
-
- `text` 是否精确匹配：区分大小写和整个字符串。默认情况下禁用此选项。如果 `text` 是正则表达式，则忽略此选项。请注意，精确匹配仍然会修剪空格。
-
**更多内容请参阅**
- [testing-library's `ByTestId`](https://testing-library.com/docs/queries/bytestid/)
@@ -510,6 +517,7 @@ page.getByRole('button')
.or(page.getByRole('link'))
.click() // ❌ 匹配到多个元素
```
+
:::
## filter
@@ -561,6 +569,7 @@ page.getByRole('article')
.filter({ has: page.getByRole('button', { name: 'delete row' }) })
.filter({ has: page.getByText('Vitest') })
```
+
:::
### hasNot
@@ -926,6 +935,7 @@ function element(): Element
```ts
await expect.element(page.getByRole('button')).toBeDisabled()
```
+
:::
考虑以下 DOM 结构：
@@ -1133,6 +1143,7 @@ test('works correctly', async () => {
await commands.test(page.getByText('Hello')) // ✅
})
```
+
:::
### length
diff --git a/api/browser/react.md b/api/browser/react.md
index 169e8008..6874f44b 100644
--- a/api/browser/react.md
+++ b/api/browser/react.md
@@ -49,6 +49,7 @@ import { render } from 'vitest-browser-react'
const screen = render() // [!code --]
const screen = await render() // [!code ++]
```
+
:::
### 选项 {#options}
@@ -258,6 +259,7 @@ await renderHook(() => {}, {
wrapper: createWrapper(Wrapper, { value: 'foo' }),
})
```
+
:::
`renderHook` 返回包含以下工具方法和属性的对象:
diff --git a/api/browser/svelte.md b/api/browser/svelte.md
index e6db3af6..542e5861 100644
--- a/api/browser/svelte.md
+++ b/api/browser/svelte.md
@@ -206,6 +206,7 @@ await expect.element(
对于简单的代码片段，你可以使用包装组件和 “占位” 子元素进行测试。通过设置 `data-testid` 属性帮助测试插槽内容。
::: code-group
+
```ts [basic.test.js]
import { render } from 'vitest-browser-svelte'
import { expect, test } from 'vitest'
@@ -221,6 +222,7 @@ test('basic snippet', async () => {
await expect.element(child).toBeInTheDocument()
})
```
+
```svelte [basic-snippet.svelte]
+
+ 
+ 
+ 
+ 
- 为什么是 Vitest？
+ 
+