useExpect

Este conteúdo não está disponível em sua língua ainda.

JavaScript (and super languages)

Summary

Rule available since: v2.4.2
Diagnostic Category: lint/nursery/useExpect
This rule doesn’t have a fix.
The default severity of this rule is information.
This rule belongs to the following domains:
- test
Sources:
- Same as playwright/expect-expect
- Same as jest/expect-expect
- Same as vitest/expect-expect

How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "nursery": {
5
        "useExpect": "error"
6
      }
7
    }
8
  }
9
}

Description

Ensure that test functions contain at least one expect() assertion.

Tests without assertions may pass even when behavior is broken, leading to false confidence in the test suite. This rule ensures that every test validates some expected behavior using expect().

Examples

Invalid

1
test("no assertion", async ({ page }) => {
2
    await page.goto("/");
3
    await page.click("button");
4
});

code-block.js:1:1 lint/nursery/useExpect ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Test callback is missing an expect() assertion.
  
  > 1 │ test(“no assertion”, async ({ page }) => {
      │ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  > 2 │     await page.goto(”/”);
  > 3 │     await page.click(“button”);
  > 4 │ });
      │ ^^
    5 │ 
  
  ℹ Tests without assertions may pass even when the behavior is broken.
  
  ℹ Add an assertion using expect() to verify the expected behavior.
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

Valid

1
test("has assertion", async ({ page }) => {
2
    await page.goto("/");
3
    await expect(page).toHaveTitle("Title");
4
});

1
test("soft assertion", async ({ page }) => {
2
    await page.goto("/");
3
    await expect.soft(page.locator("h1")).toBeVisible();
4
});