# jest/prefer-hooks-on-top

> Require hooks to come before the tests in their block

A hook applies to every test in its block, no matter where you write it. A `beforeEach` below a test still runs before that test, but someone reading from the top hasn't seen it yet.

Each `describe` block is checked separately.

{/* Generated by src/codegen/lint-rule-docs.ts. Do not edit this section. */}

## Configure

Off by default. To turn it on:

```toml bunfig.toml
[lint.rules]
"jest/prefer-hooks-on-top" = "error" # or "warn"
```

{/* End of the generated section. */}

## Examples

Reported:

{/* bad */}
```ts
import { beforeEach, expect, test } from "@jest/globals";

test("starts empty", () => {
  expect(cart.items).toHaveLength(0);
});

beforeEach(() => {
  cart.clear();
});
```

Not reported:

{/* good */}
```ts
import { beforeEach, expect, test } from "@jest/globals";

beforeEach(() => {
  cart.clear();
});

test("starts empty", () => {
  expect(cart.items).toHaveLength(0);
});
```

A hook at the top of a `describe` block is fine, even if there's a test before the block:

{/* good */}
```ts
import { beforeEach, describe, expect, test } from "@jest/globals";

test("loads the shop", () => {
  expect(shop.ready).toBe(true);
});

describe("cart", () => {
  beforeEach(() => {
    cart.clear();
  });

  test("starts empty", () => {
    expect(cart.items).toHaveLength(0);
  });
});
```