Introduction to expect-puppeteer

expect-puppeteer is a powerful library that extends the capabilities of Puppeteer, offering a more expressive way to assert and manipulate browser interactions. It is an indispensable tool for anyone looking to automate web tasks efficiently.

Key API Features of expect-puppeteer

1. Basic Page Interaction

 const puppeteer = require('puppeteer'); const expect = require('expect-puppeteer');
(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');

  // Check if a specific element appears on the page
  await expect(page).toMatch('Example Domain');
  await browser.close();
})(); 

2. Form Interaction

 const puppeteer = require('puppeteer'); const expect = require('expect-puppeteer');
(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com/form');

  // Fill and submit a form
  await expect(page).toFillForm('form[name="myform"]', {
    firstname: 'John',
    lastname: 'Doe'
  });

  await browser.close();
})(); 

3. Button Click

 const puppeteer = require('puppeteer'); const expect = require('expect-puppeteer');
(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');

  // Click a button and wait for navigation
  await expect(page).toClick('button#submit');

  await browser.close();
})(); 

4. Waiting for Elements

 const puppeteer = require('puppeteer'); const expect = require('expect-puppeteer');
(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');

  // Wait for an element to appear
  await expect(page).toMatchElement('h1');

  await browser.close();
})(); 

Complete Example App

 const puppeteer = require('puppeteer'); const expect = require('expect-puppeteer');
(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com/login');

  // Log in
  await expect(page).toFillForm('form[name="login"]', {
    username: 'user1',
    password: 'Password123'
  });
  await expect(page).toClick('button', { text: 'Login' });

  // Wait for redirect and validate
  await page.waitForNavigation();
  await expect(page).toMatch('Welcome, user1');

  await browser.close();
})(); 

With these examples, you can grasp the full potential of expect-puppeteer, enabling you to perform sophisticated browser automation tasks with ease.

Hash: acf3f0052f13f01133e8efcfb11e29d8812e93c396cb2e0879a287be2294f77e