> For AI agents: the complete documentation index is available at https://rslint.rs/llms.txt, the full documentation bundle is available at https://rslint.rs/llms-full.txt.

# require-awaited-expect-poll

[Added in v0.9.1](https://github.com/web-infra-dev/rslint/releases/tag/v0.9.1)
## Configuration

| Preset                     | Configured Value |
| -------------------------- | ---------------- |
| ✅ rstestPlugin.configs.all | `"warn"`         |


```ts title=rslint.config.ts
import { defineConfig, rstestPlugin } from '@rslint/core';

export default defineConfig([
  rstestPlugin.configs.recommended,
  {
    rules: {
      'rstest/require-awaited-expect-poll': 'error',
    },
  },
]);
```

## Rule Details

Requires the promise returned by `expect.poll(...)` or `expect.element(...)` to be handled. `expect.poll(fn)` re-evaluates `fn` until its matcher passes or the timeout expires, and every matcher `expect.element(locator)` exposes is `async`, so dropping the promise lets the test finish before the assertion does — a failing assertion then either surfaces against an unrelated test or does not surface at all.

An assertion counts as handled when it is awaited or returned, or when its value is passed on somewhere that can settle it later: a concise arrow body, a variable initializer, a destructuring or parameter default, the right side of an assignment that stores the value itself (`=`, `||=`, `&&=`, `??=`), a call or constructor argument — which covers `Promise.all([...])` and `Promise.allSettled([...])` — an array element, a JSX prop or child, a non-delegating `yield` operand, or an object or class property value. Assertions in value-producing branches of conditional and short-circuit expressions are followed to the enclosing handled position; using one as a condition or discarding the enclosing expression is still reported. A chain whose matcher never runs, such as `expect.poll(fn).toBeVisible` or `expect.poll(fn)`, is not reported.

Every `expect` source is recognized: globals, named and renamed imports, `require` destructuring, namespace imports, whole-module `require`, `import.meta.rstest`, Playwright integrations, and the `expect` a test callback receives through its [TestContext](https://rstest.rs/api/runtime-api/test-api/test#testcontext). An `expect` from another assertion library, or a local variable that shadows `expect`, is not reported.

## Incorrect

```ts
test('element exists', () => {
  asyncInjectElement();

  expect.poll(() => document.querySelector('.element')).toBeInTheDocument();
});
```

## Correct

```ts
test('element exists', async () => {
  asyncInjectElement();

  await expect
    .poll(() => document.querySelector('.element'))
    .toBeInTheDocument();
});
```

```ts
test('element exists', () => {
  asyncInjectElement();

  return expect
    .poll(() => document.querySelector('.element'))
    .toBeInTheDocument();
});
```