Ir para o conteúdo principal

Biblioteca de Testes do Puppeteer

[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 →

pptr-testing-library é um adaptador leve que permite usar a DOM Testing Library com puppeteer.

npm install --save-dev puppeteer pptr-testing-library

Como usar​

const puppeteer = require('puppeteer')
const {getDocument, queries, waitFor} = require('pptr-testing-library')

const {getByTestId, getByLabelText} = queries

const browser = await puppeteer.launch()
const page = await browser.newPage()

// Grab ElementHandle for document
const $document = await getDocument(page)
// Your favorite query methods are available
const $form = await getByTestId($document, 'my-form')
// returned elements are Puppeteer ElementHandles too!
const $email = await getByLabelText($form, 'Email')
// interact with puppeteer like usual
await $email.type('pptr@example.com')
// waiting works too!
await waitFor(() => getByText('Loading...'))

Achou muito distante do Puppeteer? Você pode anexar todos os métodos da DOM Testing Library diretamente no ElementHandle do Puppeteer!

const puppeteer = require('puppeteer')
require('pptr-testing-library/extend')

const browser = await puppeteer.launch()
const page = await browser.newPage()

// getDocument is added to prototype of Page
const $document = await page.getDocument()
// query methods are added directly to prototype of ElementHandle
const $form = await $document.getByTestId('my-form')
// destructuring works if you explicitly call getQueriesForElement
const {getByLabelText} = $form.getQueriesForElement()
// ...
const $email = await getByLabelText('Email')

API​

Métodos exclusivos que não fazem parte da DOM Testing Library.

  • getDocument(page: puppeteer.Page): ElementHandle - obtém um ElementHandle para o documento

Métodos encaminhados​

A DOM Testing Library é injetada na página controlada pelo Puppeteer em cada consulta, então todos os resultados serão assíncronos. Ainda é recomendado usar os métodos internos do Puppeteer para interação em vez de fireEvent.

Limitações conhecidas​

  • O método waitForElement não está exposto. O Puppeteer tem seu próprio conjunto de utilitários de espera que conflitam um pouco com o estilo usado na DOM Testing Library. Veja o problema no GitHub.

  • O método fireEvent não está exposto; use os métodos internos do Puppeteer.

  • As extensões de asserção expect não estão disponíveis.