# jest/prefer-importing-jest-globals

> Require `describe`, `test`, `expect` and `jest` to be imported from `@jest/globals`

Jest puts `describe`, `test`, `expect`, `jest` and the hooks in the global scope of every test file, so nothing in the file says where they come from. An import from `@jest/globals` makes that explicit, and it brings the types with it.

Each file gets one report, which lists every name to import.

`--fix` adds the import, or adds the names to the `@jest/globals` import that's already there. In a `.cjs` or `.cts` file, and in a file that has no `import` or `export` yet, it writes `const { .. } = require("@jest/globals")` instead.

{/* 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-importing-jest-globals" = "error" # or "warn"
```

Every option, set to its default. The ones that are commented out are unset by default.

```toml bunfig.toml
[lint.rules]
"jest/prefer-importing-jest-globals" = ["error", {
  # types = <list of strings>,
}]
```

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

## Examples

Reported:

{/* bad {"count": 1} */}
```ts
describe("cart", () => {
  test("starts empty", () => {
    expect(cart.items).toHaveLength(0);
  });
});
```

Not reported:

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

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

## Options

| Option | Default | What it does |
| --- | --- | --- |
| `types` | all of them | The kinds of globals to report: `"hook"` (`beforeEach` and the like), `"describe"`, `"test"` (`test` and `it`), `"expect"`, `"jest"`, `"unknown"` (`pending`). |

With `{ "types": ["jest"] }`, you only need to import the `jest` object:

{/* bad {"options": [{"types": ["jest"]}]} */}
```ts
jest.useFakeTimers();

test("expires", () => {
  expect(session.expired).toBe(false);
});
```

{/* good {"options": [{"types": ["jest"]}]} */}
```ts
import { jest } from "@jest/globals";

jest.useFakeTimers();

test("expires", () => {
  expect(session.expired).toBe(false);
});
```

With `{ "types": ["unknown"] }`, only `pending` is reported:

{/* bad {"options": [{"types": ["unknown"]}], "count": 1} */}
```ts
test("expires", () => {
  pending();
});
```