Instalar

Este módulo é distribuído através da npm o qual é empacoto com a Node e deve ser instalado como uma das tuas devDependencies do projeto:

npm

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

Yarn

yarn add --dev @testing-library/dom

Embrulhadores

Se estiveres a usar uma abstração ou biblioteca tal como a React, provavelmente quererás instalar o embrulhador:

• 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

Ecossistema

A DOM Testing Library funciona com estas bibliotecas acompanhantes:

• user-event - para simulação de evento de navegador.
• jest-dom - correspondentes de Jest personalizado.
• bs-jest-dom - biblioteca acompanhante para bs-react-testing-library.
• jest-native - biblioteca acompanhante para React Native Testing Library.
• react-select-event - biblioteca acompanhante para React Testing Library.
• eslint-plugin-testing-library - extensão de ESLint para Testing Library.
• eslint-plugin-jest-dom - extensão de ESLint para Jest DOM.
• riot-testing-library - para adicionar APIs para trabalhar com os componentes de Riot.js.

Exportações Principais

Tu podes revisar o package.json da DOM Testing Library nesta ligação.

Em especial, os campos main, module, e umd:main são úteis. Cada um destes aponta para um ficheiro que é útil em certas situações. Normalmente, a tua abstração de testagem resolverá para aquela que for correta para a tua situação, mas se o fizer, então podes ou configurar a tua biblioteca de testagem para resolver o ficheiro correto quando precisares ou importares a @testing-library/dom ou podes importar o ficheiro que precisas mas explicitamente. Por exemplo:

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

Tu podes revisar os ficheiros de dist publicado nesta ligação.

O ficheiro main está configurado para compilar para suportar a versão de Node que está referenciada no campo engines.node do package.json. Mas os ficheiros module e umd:main são configurados para compilar para suportar os navegadores tão antigos quanto o Internet Explorer 10.