Instalação

[Tradução Beta Não Oficial]

Esta página foi traduzida por PageTurner AI (beta). Não é oficialmente endossada pelo projeto. Encontrou um erro? Reportar problema →

Este módulo é distribuído via npm, que vem integrado com node, e deve ser instalado como uma das suas devDependencies no projeto:

npm

npm install --save-dev @testing-library/dom

Yarn

yarn add --dev @testing-library/dom

Wrappers

Se você estiver usando um framework ou biblioteca como React, provavelmente vai querer instalar o wrapper específico:

• React Testing Library

• Reason Testing Library

• React Native Testing Library

• Vue Testing Library

• Marko Testing Library

• Angular Testing Library

• Preact Testing Library

• Svelte Testing Library

• Cypress Testing Library

• Puppeteer Testing Library

• Testcafe Testing Library

• Nightwatch Testing Library

• Solid Testing Library

Ecossistema

A DOM Testing Library funciona bem com estas bibliotecas complementares:

• user-event simulação de eventos do navegador

• jest-dom matchers personalizados para Jest

• bs-jest-dom biblioteca complementar para bs-react-testing-library

• jest-native biblioteca complementar para React Native Testing Library

• react-select-event biblioteca complementar para React Testing Library

• eslint-plugin-testing-library plugin ESLint para Testing Library

• eslint-plugin-jest-dom plugin ESLint para Jest DOM

• riot-testing-library adiciona APIs para trabalhar com componentes Riot.js

Exportações Principais

Você pode analisar o package.json da DOM Testing Library aqui.

Os campos main, module e umd:main são especialmente úteis. Cada um aponta para um arquivo utilizado em cenários específicos. Normalmente, seu framework de testes selecionará automaticamente a opção adequada, mas caso isso não ocorra, você pode:

1. Configurar seu framework para resolver o arquivo correto ao importar @testing-library/dom
2. Importar explicitamente o arquivo necessário. Por exemplo:

import {within} from '@testing-library/dom/dist/@testing-library/dom.umd.js'

Você pode analisar os arquivos publicados em dist aqui.

O arquivo main é compilado para suportar a versão do Node.js especificada no campo engines.node do package.json. Já os arquivos module e umd:main são compilados para suportar navegadores antigos como o IE 10.