Nostalgic Primordial Monster

    playwright
    TypeScript icon, indicating that this package has built-in type declarations

    1.18.0 • Public • Published

    🎭 Playwright

    npm version Chromium version Firefox version WebKit version

    Documentation | API reference

    Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API. Playwright is built to enable cross-browser web automation that is ever-green, capable, reliable and fast.

    Linux macOS Windows
    Chromium 99.0.4812.0
    WebKit 15.4
    Firefox 95.0

    Headless execution is supported for all the browsers on all platforms. Check out system requirements for details.

    Usage

    npm i -D playwright
    

    This installs Playwright and browser binaries for Chromium, Firefox and WebKit. Once installed, you can require Playwright in a Node.js script and automate web browser interactions.

    Capabilities

    Playwright is built to automate the broad and growing set of web browser capabilities used by Single Page Apps and Progressive Web Apps.

    • Scenarios that span multiple page, domains and iframes
    • Auto-wait for elements to be ready before executing actions (like click, fill)
    • Intercept network activity for stubbing and mocking network requests
    • Emulate mobile devices, geolocation, permissions
    • Support for web components via shadow-piercing selectors
    • Native input events for mouse and keyboard
    • Upload and download files

    Examples

    Page screenshot

    This code snippet navigates to whatsmyuseragent.org and saves a screenshot.

    import { test } from '@playwright/test';
    
    test('Page Screenshot', async ({ page }) => {
        await page.goto('http://whatsmyuseragent.org/');
        await page.screenshot({ path: `example.png` });
    });

    Mobile and geolocation

    This snippet emulates Mobile Safari on a device at a given geolocation, navigates to maps.google.com, performs action and takes a screenshot.

    import { test, devices } from '@playwright/test';
    
    test.use({
      ...devices['iPhone 13 Pro'],
      locale: 'en-US',
      geolocation: { longitude: 12.492507, latitude: 41.889938 },
      permissions: ['geolocation'],
    })
    
    test('Mobile and geolocation', async ({ page }) => {
      await page.goto('https://maps.google.com');
      await page.locator('text="Your location"').click();
      await page.waitForRequest(/.*preview\/pwa/);
      await page.screenshot({ path: 'colosseum-iphone.png' });
    });

    Evaluate in browser context

    This code snippet navigates to example.com, and executes a script in the page context.

    import { test } from '@playwright/test';
    
    test('Evaluate in browser context', async ({ page }) => {
      await page.goto('https://www.example.com/');
      const dimensions = await page.evaluate(() => {
        return {
          width: document.documentElement.clientWidth,
          height: document.documentElement.clientHeight,
          deviceScaleFactor: window.devicePixelRatio
        }
      });
      console.log(dimensions);
    });

    Intercept network requests

    This code snippet sets up request routing for a page to log all network requests.

    import { test } from '@playwright/test';
    
    test('Intercept network requests', async ({ page }) => {
      // Log and continue all network requests
      await page.route('**', route => {
        console.log(route.request().url());
        route.continue();
      });
      await page.goto('http://todomvc.com');
    });

    Resources

    Keywords

    none

    Install

    npm i playwright

    DownloadsWeekly Downloads

    391,046

    Version

    1.18.0

    License

    Apache-2.0

    Unpacked Size

    20.9 kB

    Total Files

    9

    Last publish

    Collaborators

    • aslushnikov
    • joeleinbinder
    • pavelfeldman
    • dgozman
    • yurys