jest-dom: Property 'toBeInTheDocument' does not exist on type 'JestMatchers'

  • @testing-library/jest-dom version: 6.1.4
  • node version: 18.17.1
  • jest version: 29.7.0
  • npm version: 10.2.0

Other dependencies:

dependencies

Relevant code or config:

import { render, screen } from "@testing-library/react";
import Home from "@/app/page";

it("should have Docs text", () => {
  render(<Home />);

  const myElement = screen.getByText("Docs");

  expect(myElement).toBeInTheDocument();
});

What you did:

I was following a Next.js Testing tutorial by Dave Gray to learn more about React Testing. I followed the tutorial until the 17-minute mark where the error occurred.

What happened:

This is the error: Error

Reproduction:

The steps from the beginning until the 17th-minute mark of the tutorial will give the error.

Problem description:

Property ‘toBeInTheDocument’ does not exist on type ‘JestMatchers<HTMLElement>’. It seems that it has something to do either with TypeScript, or the Nextjs 14, or with the latest release of testing-library/jest-dom

Suggested solution:

The only solution, which seems temporary, is to roll back to an older version like 5.16.5 or 5.17. This solves the problem.

About this issue

  • Original URL
  • State: open
  • Created 3 years ago
  • Reactions: 24
  • Comments: 47

Commits related to this issue

Most upvoted comments

I’ve come across the issue you’re experiencing and I believe I have a solution that might help you.

If you add the following line to your tsconfig.json under compilerOptions:

{
  "compilerOptions": {
    // ... other options
    "types": ["@testing-library/jest-dom"],
    // ... other options
  }
}

This will inform TypeScript to include the type definitions from @testing-library/jest-dom, which should resolve the type errors you’re seeing.

For me the following seems to be solving the issue: setupAfterEnv.ts

import '@testing-library/jest-dom/jest-globals';
import '@testing-library/jest-dom';

Update:

Eh maybe it is flaky because after a couple of TS server restarts now it does not work … Anyway maybe this is not the correct solution then.

import '@testing-library/jest-dom'; is the only thing working for me, but I have to do it in every test file 👎

Adding compilerOptions: { "types": ["@testing-library/jest-dom"] } in tsconfig.json didn’t work for me because it overrides my existing "typeRoots".

The only solution I’ve found is adding import "@testing-library/jest-dom"; to every test file, which is a bummer.


Update: I was able to resolve this!

If, like me, you are configuring typeRoots in tsconfig.json and the above solution using the types property doesn’t work for you, you can instead update typeRoots:

"typeRoots": ["node_modules/@types", "node_modules/@testing-library"]

in my case replacing import with require helped (all other fixes suggested above were already implemented and didn’t help) const { expect, describe, it } = require('@jest/globals');

The comment above by @Noyabronok has pointed me in the right direction. Thanks.

I had "src/**/*.test.tsx" in the "exclude" array in my tsconfig.json for some reason 🤦 .

Removing this seems to have resolved the issue in VS Code for me now.

Woohoo, I got the compilerOptions: { "types": ["@testing-library/jest-dom"] } in tsconfig.json change working!

tsconfig file needed the following change:

from:

  "include": [
    "./src/**.*",
  ],

to:

  "include": [
    "./src/**/**.*",
  ],

Appears that only files at the root or src directory were having tsconfig changes applied.

This took care of VSCode error. Unfortunately I still needed import '@testing-library/jest-dom' in my jest-setup.tsx file to remove the error from test runs

since this is one of the main google hits, I thought I’d share what the solution is. There are two problems: 1. jest-dom 5.x doesn’t have TS types and 2. expect needs to be extended.

First, we’ll uninstall jest-dom and install a 4.x version:

yarn remove @testing-library/jest-dom
yarn add -D @testing-library/jest-dom@^4.2.4

You can use the analogous npm commands instead of yarn.

Then, add this to src/setupTests.ts:

import '@testing-library/jest-dom/extend-expect';

Doing these two things alone worked for me.

BTW, I stumbled upon this while following a tutorial that was based off of create-react-app, using the command yarn create react-app myname --template typescript.

// @ts-ignore 就好了

That works for me

  1. Create/update jest.setup.ts:

    import '@testing-library/jest-dom';
    
  2. Update jest.config.ts:

    // ...other configs
    setupFilesAfterEnv: ['<rootDir>/jest.setup.ts'],
    
  3. Add type definitions in tsconfig.json:

    "compilerOptions": {
       ...
       "types": ["@testing-library/jest-dom"],
       ...
    }
    

in my case replacing import with require helped (all other fixes suggested above were already implemented and didn’t help) const { expect, describe, it } = require('@jest/globals');

Thanks bro it worked, none of the solutions were working

Better is just point ts compiler to setupTests.ts file with import to @testing-library/jest-dom by adding it to tsconfig.json include option.

checkout this comment https://github.com/nrwl/nx/issues/9140#issuecomment-1200073153 btw there is no need to install @types/testing-library__jest-dom in first step

As this is still alive at this date i have to say what just worked for me right now. I updated @testing-library/jest-dom to the latest and in the jest setup file instead of importing it as import '@testing-library/jest-dom/extend-expect';, I imported it now as this import '@testing-library/jest-dom/jest-globals';

The way i use the jest functions in typescript is doing explicit imports like import { describe, expect, test } from '@jest/globals'; from the also required package @jest/globals

https://jestjs.io/docs/getting-started#type-definitions https://github.com/testing-library/jest-dom/releases/tag/v6.0.0

i couldn’t get it working with @types/jest but i dont care about it, i rather use @jest/globals.

Looks like cypress is also adding some expect() interfaces causing problems with the jest related types.

Adding direct expect import to the test files fixed it for me:

import { expect } from '@jest/globals';

  1. check your @testing-library/js-dom version, somer version don’t contain ts file, eg. 5.16.4. If not, please update @testing-library/js-dom version to 6.x.
  2. add blow code to your tsconfig "types": [ "jest", "@testing-library/jest-dom"]

The only solution that as work with me (I’m using Nextjs 14.0.3) is to modify the tsconfig.json and add: "types": ["@testing-library/jest- to compilerOptions

I have tried adding the import '@testing-library/jest-dom/jest-globals'; to the jest.setup.ts file and adding the types to the tsconfig.json file as detailed above, but I still get the type errors showing in VS Code.

Strangely, when I open the jest.setup.ts file in VS Code, the type errors suddenly disappear and everything works as expected? Am I missing a step from my configuration?

In my case the error was “Property ‘toBeInTheDocument’ does not exist on type ‘Assertion’”. The reason for the error was I was using also cypress and what fixed the error was to put this in tsconfig file:

"exclude": ["node_modules", "./cypress", "./cypress.config.ts"]

I’ve come across the issue you’re experiencing and I believe I have a solution that might help you.

If you add the following line to your tsconfig.json under compilerOptions:

{
  "compilerOptions": {
    // ... other options
    "types": ["@testing-library/jest-dom"],
    // ... other options
  }
}

This will inform TypeScript to include the type definitions from @testing-library/jest-dom, which should resolve the type errors you’re seeing.

this worked!

instead of importing it as import ‘@testing-library/jest-dom/extend-expect’;, I imported it now as this import ‘@testing-library/jest-dom/jest-globals’;

After hours of debugging, this is what finally made the trick for me. Thanks!

pnpm install --save-dev "@types/jest" i just do install types library it work for me not any config file edit

In my case the error was “Property ‘toBeInTheDocument’ does not exist on type ‘Assertion’”. The reason for the error was I was using also cypress and what fixed the error was to put this in tsconfig file: "exclude": ["node_modules", "./cypress", "./cypress.config.ts"]

Thanks a lot

I also had this issue with cypress and jest, I also paste this in my jest.setup.ts:

import “@testing-library/jest-dom”; import “@testing-library/jest-dom/jest-globals”;

and it solve it!

In my project I use vitest and cypress, so cypress started overwriting the vitest types. To solve this problem, I added it to my tsconfig.json: ... "exclude": ["node_modules", "./cypress.config.ts", "cypress"] ...

See more: https://stackoverflow.com/questions/58999086/cypress-causing-type-errors-in-jest-assertions

This seems to have resolved the issue:

  1. Adding import '@testing-library/jest-dom/jest-globals' to jest.setup.ts.
  2. Adding setupFilesAfterEnv: ['<rootDir>/tests/jest.setup.ts'], to jest.config.ts.
  3. Adding "types": ["@testing-library/jest-dom/jest-globals"] to tsconfig.ts.

or adding import "@testing-library/jest-dom" to every test file.

For me, the changes to tsconfig.json didn’t fix the issue, but adding import '@testing-library/jest-dom/jest-globals' worked right away.

Here is my tsconfig.json:

{
  "compilerOptions": {
    "target": "es5",
    "lib": ["dom", "dom.iterable", "esnext"],
    "allowJs": true,
    "skipLibCheck": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    "noEmit": true,
    "esModuleInterop": true,
    "module": "esnext",
    "moduleResolution": "node",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "jsx": "preserve",
    "incremental": true,
    "baseUrl": "src",
    "downlevelIteration": true,
    "allowSyntheticDefaultImports": true,
    "noImplicitAny": true,
    "noImplicitThis": true,
    "strictNullChecks": true,
    "typeRoots": ["./node_modules/@types"],
    "paths": {
      "ui-component": ["components/ui-component"],
      "ui-component/*": ["components/ui-component/*"],
      "components": ["components"]
    },
    "plugins": [
      {
        "name": "next"
      }
    ]
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", "jest.setup.ts"],
  "exclude": ["node_modules"]
}

Here is my jest.setup.ts:

import '@testing-library/jest-dom/jest-globals';
import '@testing-library/jest-dom';

I just realized looking at my expect type signature that my global Cypress types overrode my Jest types. Removing "cypress" from the "types" fixed it.

I just downgraded from jest-dom 6.x to 5.x and everything is green again.

Better is just point ts compiler to setupTests.ts file with import to @testing-library/jest-dom by adding it to tsconfig.json include option.

Underrated solution hidden away by collapsed thread view

I’ve come across the issue you’re experiencing and I believe I have a solution that might help you.

If you add the following line to your tsconfig.json under compilerOptions:

{
  "compilerOptions": {
    // ... other options
    "types": ["@testing-library/jest-dom"],
    // ... other options
  }
}

This will inform TypeScript to include the type definitions from @testing-library/jest-dom, which should resolve the type errors you’re seeing. I added the line to the tsconfig.app.json under compilerOptions, and the errors are gone.

In my case the error was “Property ‘toBeInTheDocument’ does not exist on type ‘Assertion’”. The reason for the error was I was using also cypress and what fixed the error was to put this in tsconfig file:

"exclude": ["node_modules", "./cypress", "./cypress.config.ts"]

Thanks a lot

I’ve always found using the types config option in tsconfig.json problematic. Adding this to my setupTests.js (or whatever equivalent you have) also works, without introducing the additional issues with setting the types option:

/// <reference types="@testing-library/jest-dom" />

This seems to have resolved the issue:

  1. Adding import '@testing-library/jest-dom/jest-globals' to jest.setup.ts.
  2. Adding setupFilesAfterEnv: ['<rootDir>/tests/jest.setup.ts'], to jest.config.ts.
  3. Adding "types": ["@testing-library/jest-dom/jest-globals"] to tsconfig.ts.

or adding import "@testing-library/jest-dom" to every test file.

@khairalanam I was taking the same course with Dave Gray and encountered the same issue. Initially, I had errors with it and expect which were also shown in the video. I resolved these errors by running npm i -D @types/jest After addressing this, I faced the exact same error as you did, and resolved it by removing extend-expect from the import statement @testing-library/jest-dom/extend-expect in jest.setup.ts file.

The reason is that @testing-library/jest-dom no longer requires a separate import of @testing-library/jest-dom/extend-expect as it might have in earlier versions. Therefore, if you are using version 6.0 or higher, you should import @testing-library/jest-dom directly, without including the extend-expect path.

So I have this import inside of my setupTests.ts:

import "@testing-library/jest-dom";

And when I have the setupTests.ts files actually open in my IDE, it’s all good. No complaints. Now when I close the setupTests.ts file, my IDE starts complaining that inTheDocument() doesn’t exist on JestMatchers… And then when I open setupTests.ts again, it’s all good and dandy. Anybody else had this problem?

That’s pretty good. It has to be added to the config file after installing the library.