mirror of
				https://github.com/microsoft/playwright.git
				synced 2025-06-26 21:40:17 +00:00 
			
		
		
		
	- Separate worker for some Android tests. - Use png comparator for some screenshots tests instead of buffer equality. - Skip drag&drop tests on Android. - Various timeout fixes.
		
			
				
	
	
		
			833 lines
		
	
	
		
			32 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
			
		
		
	
	
			833 lines
		
	
	
		
			32 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
/**
 | 
						|
 * Copyright 2018 Google Inc. All rights reserved.
 | 
						|
 * Modifications copyright (c) Microsoft Corporation.
 | 
						|
 *
 | 
						|
 * Licensed under the Apache License, Version 2.0 (the "License");
 | 
						|
 * you may not use this file except in compliance with the License.
 | 
						|
 * You may obtain a copy of the License at
 | 
						|
 *
 | 
						|
 *     http://www.apache.org/licenses/LICENSE-2.0
 | 
						|
 *
 | 
						|
 * Unless required by applicable law or agreed to in writing, software
 | 
						|
 * distributed under the License is distributed on an "AS IS" BASIS,
 | 
						|
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
						|
 * See the License for the specific language governing permissions and
 | 
						|
 * limitations under the License.
 | 
						|
 */
 | 
						|
 | 
						|
import { test as it, expect } from './pageTest';
 | 
						|
import { verifyViewport, attachFrame } from '../config/utils';
 | 
						|
import type { Route } from 'playwright-core';
 | 
						|
import path from 'path';
 | 
						|
import fs from 'fs';
 | 
						|
import { comparePNGs } from '../config/comparator';
 | 
						|
 | 
						|
it.describe('page screenshot', () => {
 | 
						|
  it.skip(({ browserName, headless }) => browserName === 'firefox' && !headless, 'Firefox headed produces a different image.');
 | 
						|
  it.skip(({ isAndroid }) => isAndroid, 'Different viewport');
 | 
						|
 | 
						|
  it('should work @smoke', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const screenshot = await page.screenshot();
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-sanity.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should not capture blinking caret by default', async ({ page, server, browserName }) => {
 | 
						|
    await page.setContent(`
 | 
						|
      <!-- Refer to stylesheet from other origin. Accessing this
 | 
						|
           stylesheet rules will throw.
 | 
						|
      -->
 | 
						|
      <link rel=stylesheet href="${server.CROSS_PROCESS_PREFIX + '/injectedstyle.css'}">
 | 
						|
      <!-- make life harder: define caret color in stylesheet -->
 | 
						|
      <style>
 | 
						|
        div {
 | 
						|
          caret-color: #000 !important;
 | 
						|
        }
 | 
						|
      </style>
 | 
						|
      <div contenteditable="true"></div>
 | 
						|
    `);
 | 
						|
    const div = page.locator('div');
 | 
						|
    await div.type('foo bar');
 | 
						|
    const screenshot = await div.screenshot();
 | 
						|
    for (let i = 0; i < 10; ++i) {
 | 
						|
      // Caret blinking time is set to 500ms.
 | 
						|
      // Try to capture variety of screenshots to make
 | 
						|
      // sure we don't capture blinking caret.
 | 
						|
      await new Promise(x => setTimeout(x, 150));
 | 
						|
      const newScreenshot = await div.screenshot();
 | 
						|
      expect(newScreenshot.equals(screenshot)).toBe(true);
 | 
						|
    }
 | 
						|
  });
 | 
						|
 | 
						|
  it('should capture blinking caret if explicitly asked for', async ({ page, server, browserName }) => {
 | 
						|
    it.fixme(browserName === 'firefox', 'browser-level screenshot API in firefox does not capture caret');
 | 
						|
    await page.setContent(`
 | 
						|
      <!-- Refer to stylesheet from other origin. Accessing this
 | 
						|
           stylesheet rules will throw.
 | 
						|
      -->
 | 
						|
      <link rel=stylesheet href="${server.CROSS_PROCESS_PREFIX + '/injectedstyle.css'}">
 | 
						|
      <!-- make life harder: define caret color in stylesheet -->
 | 
						|
      <style>
 | 
						|
        div {
 | 
						|
          caret-color: #000 !important;
 | 
						|
        }
 | 
						|
      </style>
 | 
						|
      <div contenteditable="true"></div>
 | 
						|
    `);
 | 
						|
    const div = page.locator('div');
 | 
						|
    await div.type('foo bar');
 | 
						|
    const screenshot = await div.screenshot();
 | 
						|
    let hasDifferentScreenshots = false;
 | 
						|
    for (let i = 0; !hasDifferentScreenshots && i < 10; ++i) {
 | 
						|
      // Caret blinking time is set to 500ms.
 | 
						|
      // Try to capture variety of screenshots to make
 | 
						|
      // sure we capture blinking caret.
 | 
						|
      await new Promise(x => setTimeout(x, 150));
 | 
						|
      const newScreenshot = await div.screenshot({ caret: 'initial' });
 | 
						|
      hasDifferentScreenshots = !newScreenshot.equals(screenshot);
 | 
						|
    }
 | 
						|
    expect(hasDifferentScreenshots).toBe(true);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should capture blinking caret in shadow dom', async ({ page, browserName }) => {
 | 
						|
    it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/16732' });
 | 
						|
    await page.addScriptTag({
 | 
						|
      content: `
 | 
						|
      class CustomElementContainer extends HTMLElement {
 | 
						|
        #shadowRoot;
 | 
						|
        constructor() {
 | 
						|
          super();
 | 
						|
          this.#shadowRoot = this.attachShadow({ mode: 'open' });
 | 
						|
          this.#shadowRoot.innerHTML = '<custom-element-input-wrapper><input type="text"/></custom-element-input-wrapper>';
 | 
						|
        }
 | 
						|
      }
 | 
						|
      class CustomElementInputWrapper extends HTMLElement {
 | 
						|
        #shadowRoot;
 | 
						|
        constructor() {
 | 
						|
          super();
 | 
						|
          this.#shadowRoot = this.attachShadow({ mode: 'open' });
 | 
						|
          this.#shadowRoot.innerHTML = '<style>:host { all: initial; }</style><slot/>';
 | 
						|
        }
 | 
						|
      }
 | 
						|
      customElements.define('custom-element-input-wrapper', CustomElementInputWrapper);
 | 
						|
      customElements.define('custom-element-container', CustomElementContainer);
 | 
						|
 | 
						|
      const container = document.createElement('custom-element-container');
 | 
						|
      document.body.appendChild(container);`,
 | 
						|
    });
 | 
						|
 | 
						|
    const input = await page.locator('input');
 | 
						|
    // TODO: click fails in webkit
 | 
						|
    await input.focus();
 | 
						|
 | 
						|
    const screenshot = await input.screenshot();
 | 
						|
    let hasDifferentScreenshots = false;
 | 
						|
    for (let i = 0; !hasDifferentScreenshots && i < 10; ++i) {
 | 
						|
      // Caret blinking time is set to 500ms.
 | 
						|
      // Try to capture variety of screenshots to make
 | 
						|
      // sure we capture blinking caret.
 | 
						|
      await new Promise(x => setTimeout(x, 150));
 | 
						|
      const newScreenshot = await input.screenshot({ caret: 'hide' });
 | 
						|
      hasDifferentScreenshots = !newScreenshot.equals(screenshot);
 | 
						|
    }
 | 
						|
    expect(hasDifferentScreenshots).toBe(false);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should clip rect', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const screenshot = await page.screenshot({
 | 
						|
      clip: {
 | 
						|
        x: 50,
 | 
						|
        y: 100,
 | 
						|
        width: 150,
 | 
						|
        height: 100
 | 
						|
      }
 | 
						|
    });
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-clip-rect.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should clip rect with fullPage', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    await page.evaluate(() => window.scrollBy(150, 200));
 | 
						|
    const screenshot = await page.screenshot({
 | 
						|
      fullPage: true,
 | 
						|
      clip: {
 | 
						|
        x: 50,
 | 
						|
        y: 100,
 | 
						|
        width: 150,
 | 
						|
        height: 100,
 | 
						|
      },
 | 
						|
    });
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-clip-rect.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should clip elements to the viewport', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const screenshot = await page.screenshot({
 | 
						|
      clip: {
 | 
						|
        x: 50,
 | 
						|
        y: 450,
 | 
						|
        width: 1000,
 | 
						|
        height: 100
 | 
						|
      }
 | 
						|
    });
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-offscreen-clip.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should throw on clip outside the viewport', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const screenshotError = await page.screenshot({
 | 
						|
      clip: {
 | 
						|
        x: 50,
 | 
						|
        y: 650,
 | 
						|
        width: 100,
 | 
						|
        height: 100
 | 
						|
      }
 | 
						|
    }).catch(error => error);
 | 
						|
    expect(screenshotError.message).toContain('Clipped area is either empty or outside the resulting image');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should run in parallel', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const promises = [];
 | 
						|
    for (let i = 0; i < 3; ++i) {
 | 
						|
      promises.push(page.screenshot({
 | 
						|
        clip: {
 | 
						|
          x: 50 * i,
 | 
						|
          y: 0,
 | 
						|
          width: 50,
 | 
						|
          height: 50
 | 
						|
        }
 | 
						|
      }));
 | 
						|
    }
 | 
						|
    const screenshots = await Promise.all(promises);
 | 
						|
    expect(screenshots[1]).toMatchSnapshot('grid-cell-1.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should take fullPage screenshots', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const screenshot = await page.screenshot({
 | 
						|
      fullPage: true
 | 
						|
    });
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-grid-fullpage.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should restore viewport after fullPage screenshot', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const screenshot = await page.screenshot({ fullPage: true });
 | 
						|
    expect(screenshot).toBeInstanceOf(Buffer);
 | 
						|
    await verifyViewport(page, 500, 500);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should allow transparency', async ({ page, browserName, platform }) => {
 | 
						|
    it.fail(browserName === 'firefox');
 | 
						|
    it.fixme(browserName === 'webkit' && platform === 'win32', 'https://github.com/microsoft/playwright/issues/18452');
 | 
						|
 | 
						|
    await page.setViewportSize({ width: 50, height: 150 });
 | 
						|
    await page.setContent(`
 | 
						|
      <style>
 | 
						|
        body { margin: 0 }
 | 
						|
        div { width: 50px; height: 50px; }
 | 
						|
      </style>
 | 
						|
      <div style="background:black"></div>
 | 
						|
      <div style="background:white"></div>
 | 
						|
      <div style="background:transparent"></div>
 | 
						|
    `);
 | 
						|
    const screenshot = await page.screenshot({ omitBackground: true });
 | 
						|
    expect(screenshot).toMatchSnapshot('transparent.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should render white background on jpeg file', async ({ page, server, isElectron }) => {
 | 
						|
    it.fixme(isElectron, 'omitBackground with jpeg does not work');
 | 
						|
 | 
						|
    await page.setViewportSize({ width: 300, height: 300 });
 | 
						|
    await page.goto(server.EMPTY_PAGE);
 | 
						|
    const screenshot = await page.screenshot({ omitBackground: true, type: 'jpeg' });
 | 
						|
    expect(screenshot).toMatchSnapshot('white.jpg');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should work with odd clip size on Retina displays', async ({ page, isElectron }) => {
 | 
						|
    it.fixme(isElectron, 'Scale is wrong');
 | 
						|
 | 
						|
    const screenshot = await page.screenshot({
 | 
						|
      clip: {
 | 
						|
        x: 0,
 | 
						|
        y: 0,
 | 
						|
        width: 11,
 | 
						|
        height: 11,
 | 
						|
      }
 | 
						|
    });
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-clip-odd-size.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should work for canvas', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/screenshots/canvas.html');
 | 
						|
    const screenshot = await page.screenshot();
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-canvas.png', { threshold: 0.4 });
 | 
						|
  });
 | 
						|
 | 
						|
  it('should capture canvas changes', async ({ page, isElectron, browserName, isMac, isWebView2 }) => {
 | 
						|
    it.fixme(browserName === 'webkit' && isMac, 'https://github.com/microsoft/playwright/issues/8796,https://github.com/microsoft/playwright/issues/16180');
 | 
						|
    it.skip(isElectron);
 | 
						|
    it.skip(isWebView2);
 | 
						|
    await page.goto('data:text/html,<canvas></canvas>');
 | 
						|
    await page.evaluate(() => {
 | 
						|
      const canvas = document.querySelector('canvas');
 | 
						|
      canvas.width = 600;
 | 
						|
      canvas.height = 600;
 | 
						|
    });
 | 
						|
 | 
						|
    async function addLine(step: number) {
 | 
						|
      await page.evaluate(n => {
 | 
						|
        const canvas = document.querySelector('canvas');
 | 
						|
        const ctx = canvas.getContext('2d');
 | 
						|
        ctx.lineWidth = 1;
 | 
						|
        ctx.beginPath();
 | 
						|
        ctx.moveTo(0, n * 100);
 | 
						|
        ctx.lineTo(300, n * 100);
 | 
						|
        ctx.stroke();
 | 
						|
      }, step);
 | 
						|
    }
 | 
						|
 | 
						|
    for (let i = 0; i < 3; i++) {
 | 
						|
      await addLine(i);
 | 
						|
      // With the slight delay WebKit stops reflecting changes in the screenshots on macOS.
 | 
						|
      await new Promise(f => setTimeout(f, 100));
 | 
						|
      const screenshot = await page.screenshot();
 | 
						|
      expect(screenshot).toMatchSnapshot(`canvas-changes-${i}.png`);
 | 
						|
    }
 | 
						|
  });
 | 
						|
 | 
						|
  it('should work for webgl', async ({ page, server, browserName }) => {
 | 
						|
    it.fixme(browserName === 'firefox' || browserName === 'webkit');
 | 
						|
 | 
						|
    await page.setViewportSize({ width: 640, height: 480 });
 | 
						|
    await page.goto(server.PREFIX + '/screenshots/webgl.html');
 | 
						|
    const screenshot = await page.screenshot();
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-webgl.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should work for translateZ', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/screenshots/translateZ.html');
 | 
						|
    const screenshot = await page.screenshot();
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-translateZ.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should work while navigating', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/redirectloop1.html');
 | 
						|
    for (let i = 0; i < 10; i++) {
 | 
						|
      const screenshot = await page.screenshot({ fullPage: true }).catch(e => {
 | 
						|
        if (e.message.includes('Cannot take a screenshot while page is navigating'))
 | 
						|
          return Buffer.from('');
 | 
						|
        throw e;
 | 
						|
      });
 | 
						|
      expect(screenshot).toBeInstanceOf(Buffer);
 | 
						|
    }
 | 
						|
  });
 | 
						|
 | 
						|
  it('should work with iframe in shadow', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid-iframe-in-shadow.html');
 | 
						|
    expect(await page.screenshot()).toMatchSnapshot('screenshot-iframe.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('path option should work', async ({ page, server }, testInfo) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const outputPath = testInfo.outputPath('screenshot.png');
 | 
						|
    await page.screenshot({ path: outputPath });
 | 
						|
    expect(await fs.promises.readFile(outputPath)).toMatchSnapshot('screenshot-sanity.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('path option should create subdirectories', async ({ page, server }, testInfo) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const outputPath = testInfo.outputPath(path.join('these', 'are', 'directories', 'screenshot.png'));
 | 
						|
    await page.screenshot({ path: outputPath });
 | 
						|
    expect(await fs.promises.readFile(outputPath)).toMatchSnapshot('screenshot-sanity.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('path option should detect jpeg', async ({ page, server, isElectron }, testInfo) => {
 | 
						|
    it.fixme(isElectron, 'omitBackground with jpeg does not work');
 | 
						|
 | 
						|
    await page.setViewportSize({ width: 300, height: 300 });
 | 
						|
    await page.goto(server.EMPTY_PAGE);
 | 
						|
    const outputPath = testInfo.outputPath('screenshot.jpg');
 | 
						|
    const screenshot = await page.screenshot({ omitBackground: true, path: outputPath });
 | 
						|
    expect(await fs.promises.readFile(outputPath)).toMatchSnapshot('white.jpg');
 | 
						|
    expect(screenshot).toMatchSnapshot('white.jpg');
 | 
						|
  });
 | 
						|
 | 
						|
  it('path option should throw for unsupported mime type', async ({ page }) => {
 | 
						|
    const error = await page.screenshot({ path: 'file.txt' }).catch(e => e);
 | 
						|
    expect(error.message).toContain('path: unsupported mime type "text/plain"');
 | 
						|
  });
 | 
						|
 | 
						|
  it('quality option should throw for png', async ({ page }) => {
 | 
						|
    const error = await page.screenshot({ quality: 10 }).catch(e => e);
 | 
						|
    expect(error.message).toContain('options.quality is unsupported for the png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('zero quality option should throw for png', async ({ page }) => {
 | 
						|
    const error = await page.screenshot({ quality: 0, type: 'png' }).catch(e => e);
 | 
						|
    expect(error.message).toContain('options.quality is unsupported for the png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should prefer type over extension', async ({ page }, testInfo) => {
 | 
						|
    const outputPath = testInfo.outputPath('file.png');
 | 
						|
    const buffer = await page.screenshot({ path: outputPath, type: 'jpeg' });
 | 
						|
    expect([buffer[0], buffer[1], buffer[2]]).toEqual([0xFF, 0xD8, 0xFF]);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should not issue resize event', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    let resizeTriggered = false;
 | 
						|
    await page.exposeFunction('resize', () => {
 | 
						|
      resizeTriggered = true;
 | 
						|
    });
 | 
						|
    await page.evaluate(() => {
 | 
						|
      window.addEventListener('resize', () => (window as any).resize());
 | 
						|
    });
 | 
						|
    await page.screenshot();
 | 
						|
    expect(resizeTriggered).toBeFalsy();
 | 
						|
  });
 | 
						|
 | 
						|
  it('should work with Array deleted', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    await page.evaluate(() => delete window.Array);
 | 
						|
    const screenshot = await page.screenshot({ fullPage: true });
 | 
						|
    expect(screenshot).toMatchSnapshot('screenshot-grid-fullpage.png');
 | 
						|
  });
 | 
						|
 | 
						|
  it('should take fullPage screenshots during navigation', async ({ page, server }) => {
 | 
						|
    await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
    await page.goto(server.PREFIX + '/grid.html');
 | 
						|
    const reloadSeveralTimes = async () => {
 | 
						|
      for (let i = 0; i < 5; ++i)
 | 
						|
        await page.reload();
 | 
						|
    };
 | 
						|
    const screenshotSeveralTimes = async () => {
 | 
						|
      for (let i = 0; i < 5; ++i)
 | 
						|
        await page.screenshot({ fullPage: true });
 | 
						|
    };
 | 
						|
    await Promise.all([
 | 
						|
      reloadSeveralTimes(),
 | 
						|
      screenshotSeveralTimes()
 | 
						|
    ]);
 | 
						|
  });
 | 
						|
 | 
						|
  it.describe('mask option', () => {
 | 
						|
    it('should work', async ({ page, server }) => {
 | 
						|
      await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
      await page.goto(server.PREFIX + '/grid.html');
 | 
						|
      expect(await page.screenshot({
 | 
						|
        mask: [page.locator('div').nth(5)],
 | 
						|
      })).toMatchSnapshot('mask-should-work.png');
 | 
						|
    });
 | 
						|
 | 
						|
    it('should work with locator', async ({ page, server }) => {
 | 
						|
      await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
      await page.goto(server.PREFIX + '/grid.html');
 | 
						|
      const bodyLocator = page.locator('body');
 | 
						|
      expect(await bodyLocator.screenshot({
 | 
						|
        mask: [page.locator('div').nth(5)],
 | 
						|
      })).toMatchSnapshot('mask-should-work-with-locator.png');
 | 
						|
    });
 | 
						|
 | 
						|
    it('should work with elementhandle', async ({ page, server }) => {
 | 
						|
      await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
      await page.goto(server.PREFIX + '/grid.html');
 | 
						|
      const bodyHandle = await page.$('body');
 | 
						|
      expect(await bodyHandle.screenshot({
 | 
						|
        mask: [page.locator('div').nth(5)],
 | 
						|
      })).toMatchSnapshot('mask-should-work-with-elementhandle.png');
 | 
						|
    });
 | 
						|
 | 
						|
    it('should mask multiple elements', async ({ page, server }) => {
 | 
						|
      await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
      await page.goto(server.PREFIX + '/grid.html');
 | 
						|
      expect(await page.screenshot({
 | 
						|
        mask: [
 | 
						|
          page.locator('div').nth(5),
 | 
						|
          page.locator('div').nth(12),
 | 
						|
        ],
 | 
						|
      })).toMatchSnapshot('should-mask-multiple-elements.png');
 | 
						|
    });
 | 
						|
 | 
						|
    it('should mask inside iframe', async ({ page, server }) => {
 | 
						|
      await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
      await page.goto(server.PREFIX + '/grid.html');
 | 
						|
      await attachFrame(page, 'frame1', server.PREFIX + '/grid.html');
 | 
						|
      await page.addStyleTag({ content: 'iframe { border: none; }' });
 | 
						|
      expect(await page.screenshot({
 | 
						|
        mask: [
 | 
						|
          page.locator('div').nth(5),
 | 
						|
          page.frameLocator('#frame1').locator('div').nth(12),
 | 
						|
        ],
 | 
						|
      })).toMatchSnapshot('should-mask-inside-iframe.png');
 | 
						|
    });
 | 
						|
 | 
						|
    it('should mask in parallel', async ({ page, server }) => {
 | 
						|
      await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
      await attachFrame(page, 'frame1', server.PREFIX + '/grid.html');
 | 
						|
      await attachFrame(page, 'frame2', server.PREFIX + '/grid.html');
 | 
						|
      await page.addStyleTag({ content: 'iframe { border: none; }' });
 | 
						|
      const screenshots = await Promise.all([
 | 
						|
        page.screenshot({
 | 
						|
          mask: [page.frameLocator('#frame1').locator('div').nth(1)],
 | 
						|
        }),
 | 
						|
        page.screenshot({
 | 
						|
          mask: [page.frameLocator('#frame2').locator('div').nth(3)],
 | 
						|
        }),
 | 
						|
      ]);
 | 
						|
      expect(screenshots[0]).toMatchSnapshot('should-mask-in-parallel-1.png');
 | 
						|
      expect(screenshots[1]).toMatchSnapshot('should-mask-in-parallel-2.png');
 | 
						|
    });
 | 
						|
 | 
						|
    it('should remove mask after screenshot', async ({ page, server }) => {
 | 
						|
      await page.setViewportSize({ width: 500, height: 500 });
 | 
						|
      await page.goto(server.PREFIX + '/grid.html');
 | 
						|
      const screenshot1 = await page.screenshot();
 | 
						|
      await page.screenshot({
 | 
						|
        mask: [page.locator('div').nth(1)],
 | 
						|
      });
 | 
						|
      const screenshot2 = await page.screenshot();
 | 
						|
      expect(screenshot1.equals(screenshot2)).toBe(true);
 | 
						|
    });
 | 
						|
 | 
						|
    it('should work when subframe has stalled navigation', async ({ page, server }) => {
 | 
						|
      let cb;
 | 
						|
      const routeReady = new Promise<Route>(f => cb = f);
 | 
						|
      await page.route('**/subframe.html', cb); // Stalling subframe.
 | 
						|
 | 
						|
      await page.goto(server.EMPTY_PAGE);
 | 
						|
      const done = page.setContent(`<iframe src='/subframe.html'></iframe>`);
 | 
						|
      const route = await routeReady;
 | 
						|
 | 
						|
      await page.screenshot({ mask: [page.locator('non-existent')] });
 | 
						|
      await route.fulfill({ body: '' });
 | 
						|
      await done;
 | 
						|
    });
 | 
						|
 | 
						|
    it('should work when subframe used document.open after a weird url', async ({ page, server }) => {
 | 
						|
      await page.goto(server.EMPTY_PAGE);
 | 
						|
      await page.evaluate(() => {
 | 
						|
        const iframe = document.createElement('iframe');
 | 
						|
        iframe.src = 'javascript:hi';
 | 
						|
        document.body.appendChild(iframe);
 | 
						|
        iframe.contentDocument.open();
 | 
						|
        iframe.contentDocument.write('Hello');
 | 
						|
        iframe.contentDocument.close();
 | 
						|
      });
 | 
						|
      await page.screenshot({ mask: [page.locator('non-existent')] });
 | 
						|
    });
 | 
						|
  });
 | 
						|
});
 | 
						|
 | 
						|
async function rafraf(page) {
 | 
						|
  // Do a double raf since single raf does not
 | 
						|
  // actually guarantee a new animation frame.
 | 
						|
  await page.evaluate(() => new Promise(x => {
 | 
						|
    requestAnimationFrame(() => requestAnimationFrame(x));
 | 
						|
  }));
 | 
						|
}
 | 
						|
 | 
						|
declare global {
 | 
						|
  interface Window {
 | 
						|
    animation?: Animation;
 | 
						|
    _EVENTS?: string[];
 | 
						|
  }
 | 
						|
}
 | 
						|
 | 
						|
it.describe('page screenshot animations', () => {
 | 
						|
  it('should not capture infinite css animation', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/rotate-z.html');
 | 
						|
    const div = page.locator('div');
 | 
						|
    const screenshot = await div.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    for (let i = 0; i < 10; ++i) {
 | 
						|
      await rafraf(page);
 | 
						|
      const newScreenshot = await div.screenshot({
 | 
						|
        animations: 'disabled',
 | 
						|
      });
 | 
						|
      expect(newScreenshot.equals(screenshot)).toBe(true);
 | 
						|
    }
 | 
						|
  });
 | 
						|
 | 
						|
  it('should not capture pseudo element css animation', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/rotate-pseudo.html');
 | 
						|
    const div = page.locator('div');
 | 
						|
    const screenshot = await div.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    for (let i = 0; i < 10; ++i) {
 | 
						|
      await rafraf(page);
 | 
						|
      const newScreenshot = await div.screenshot({
 | 
						|
        animations: 'disabled',
 | 
						|
      });
 | 
						|
      expect(newScreenshot.equals(screenshot)).toBe(true);
 | 
						|
    }
 | 
						|
  });
 | 
						|
 | 
						|
  it('should not capture css animations in shadow DOM', async ({ page, server, isAndroid }) => {
 | 
						|
    it.skip(isAndroid, 'Different viewport');
 | 
						|
    await page.goto(server.PREFIX + '/rotate-z-shadow-dom.html');
 | 
						|
    const screenshot = await page.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    for (let i = 0; i < 4; ++i) {
 | 
						|
      await rafraf(page);
 | 
						|
      const newScreenshot = await page.screenshot({
 | 
						|
        animations: 'disabled',
 | 
						|
      });
 | 
						|
      expect(newScreenshot.equals(screenshot)).toBe(true);
 | 
						|
    }
 | 
						|
  });
 | 
						|
 | 
						|
  it('should stop animations that happen right before screenshot', async ({ page, server, mode, isAndroid }) => {
 | 
						|
    it.skip(mode !== 'default');
 | 
						|
    it.skip(isAndroid, 'Different viewport');
 | 
						|
    await page.goto(server.PREFIX + '/rotate-z.html');
 | 
						|
    // Stop rotating bar.
 | 
						|
    await page.$eval('div', el => el.style.setProperty('animation', 'none'));
 | 
						|
    const buffer1 = await page.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
      // Start rotating bar right before screenshot.
 | 
						|
      __testHookBeforeScreenshot: async () => {
 | 
						|
        await page.$eval('div', el => el.style.removeProperty('animation'));
 | 
						|
      },
 | 
						|
    } as any);
 | 
						|
    await rafraf(page);
 | 
						|
    const buffer2 = await page.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    expect(comparePNGs(buffer1, buffer2)).toBe(null);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should resume infinite animations', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/rotate-z.html');
 | 
						|
    await page.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    const buffer1 = await page.screenshot();
 | 
						|
    await rafraf(page);
 | 
						|
    const buffer2 = await page.screenshot();
 | 
						|
    expect(comparePNGs(buffer1, buffer2, { threshold: 0.2, maxDiffPixels: 50 })).not.toBe(null);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should not capture infinite web animations', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/web-animation.html');
 | 
						|
    const div = page.locator('div');
 | 
						|
    const screenshot = await div.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    for (let i = 0; i < 10; ++i) {
 | 
						|
      await rafraf(page);
 | 
						|
      const newScreenshot = await div.screenshot({
 | 
						|
        animations: 'disabled',
 | 
						|
      });
 | 
						|
      expect(newScreenshot.equals(screenshot)).toBe(true);
 | 
						|
    }
 | 
						|
    // Should resume infinite web animation.
 | 
						|
    const buffer1 = await page.screenshot();
 | 
						|
    await rafraf(page);
 | 
						|
    const buffer2 = await page.screenshot();
 | 
						|
    expect(comparePNGs(buffer1, buffer2, { threshold: 0.2, maxDiffPixels: 50 })).not.toBe(null);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should fire transitionend for finite transitions', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/css-transition.html');
 | 
						|
    const div = page.locator('div');
 | 
						|
    await div.evaluate(el => {
 | 
						|
      el.addEventListener('transitionend', () => window['__TRANSITION_END'] = true, false);
 | 
						|
    });
 | 
						|
 | 
						|
    await it.step('make sure transition is actually running', async () => {
 | 
						|
      const screenshot1 = await page.screenshot();
 | 
						|
      await rafraf(page);
 | 
						|
      const screenshot2 = await page.screenshot();
 | 
						|
      expect(screenshot1.equals(screenshot2)).toBe(false);
 | 
						|
    });
 | 
						|
 | 
						|
    // Make a screenshot that finishes all finite animations.
 | 
						|
    const screenshot1 = await div.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    await rafraf(page);
 | 
						|
    // Make sure finite transition is not restarted.
 | 
						|
    const screenshot2 = await div.screenshot({ animations: 'allow' });
 | 
						|
    expect(screenshot1.equals(screenshot2)).toBe(true);
 | 
						|
 | 
						|
    expect(await page.evaluate(() => window['__TRANSITION_END'])).toBe(true);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should capture screenshots after layoutchanges in transitionend event', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/css-transition.html');
 | 
						|
    const div = page.locator('div');
 | 
						|
    await div.evaluate(el => {
 | 
						|
      el.addEventListener('transitionend', () => {
 | 
						|
        const time = Date.now();
 | 
						|
        // Block main thread for 200ms, emulating heavy layout.
 | 
						|
        while (Date.now() - time < 200) ;
 | 
						|
        const h1 = document.createElement('h1');
 | 
						|
        h1.textContent = 'woof-woof';
 | 
						|
        document.body.append(h1);
 | 
						|
      }, false);
 | 
						|
    });
 | 
						|
 | 
						|
    await it.step('make sure transition is actually running', async () => {
 | 
						|
      const screenshot1 = await page.screenshot();
 | 
						|
      await rafraf(page);
 | 
						|
      const screenshot2 = await page.screenshot();
 | 
						|
      expect(screenshot1.equals(screenshot2)).toBe(false);
 | 
						|
    });
 | 
						|
 | 
						|
    // 1. Make a screenshot that finishes all finite animations
 | 
						|
    //    and triggers layout.
 | 
						|
    const screenshot1 = await page.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
 | 
						|
    // 2. Make a second screenshot after h1 is on screen.
 | 
						|
    await expect(page.locator('h1')).toBeVisible();
 | 
						|
    await expect(page.locator('h1')).toHaveText('woof-woof');
 | 
						|
    const screenshot2 = await page.screenshot();
 | 
						|
 | 
						|
    // 3. Make sure both screenshots are equal, meaning that
 | 
						|
    //    first screenshot actually was taken after transitionend
 | 
						|
    //    changed layout.
 | 
						|
    expect(screenshot1.equals(screenshot2)).toBe(true);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should not change animation with playbackRate equal to 0', async ({ page, server, isAndroid }) => {
 | 
						|
    it.skip(isAndroid, 'Different viewport');
 | 
						|
    await page.goto(server.PREFIX + '/rotate-z.html');
 | 
						|
    await page.evaluate(async () => {
 | 
						|
      window.animation = document.getAnimations()[0];
 | 
						|
      await window.animation.ready;
 | 
						|
      window.animation.updatePlaybackRate(0);
 | 
						|
      await window.animation.ready;
 | 
						|
      window.animation.currentTime = 500;
 | 
						|
    });
 | 
						|
    const screenshot1 = await page.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    await rafraf(page);
 | 
						|
    const screenshot2 = await page.screenshot({
 | 
						|
      animations: 'disabled',
 | 
						|
    });
 | 
						|
    expect(screenshot1.equals(screenshot2)).toBe(true);
 | 
						|
    expect(await page.evaluate(() => ({
 | 
						|
      playbackRate: window.animation.playbackRate,
 | 
						|
      currentTime: window.animation.currentTime,
 | 
						|
    }))).toEqual({
 | 
						|
      playbackRate: 0,
 | 
						|
      currentTime: 500,
 | 
						|
    });
 | 
						|
  });
 | 
						|
 | 
						|
  it('should trigger particular events for css transitions', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/css-transition.html');
 | 
						|
    const div = page.locator('div');
 | 
						|
    await div.evaluate(async el => {
 | 
						|
      window._EVENTS = [];
 | 
						|
      el.addEventListener('transitionend', () => {
 | 
						|
        window._EVENTS.push('transitionend');
 | 
						|
        console.log('transitionend');
 | 
						|
      }, false);
 | 
						|
      const animation = el.getAnimations()[0];
 | 
						|
      animation.oncancel = () => window._EVENTS.push('oncancel');
 | 
						|
      animation.onfinish = () => window._EVENTS.push('onfinish');
 | 
						|
      animation.onremove = () => window._EVENTS.push('onremove');
 | 
						|
      await animation.ready;
 | 
						|
    });
 | 
						|
    await Promise.all([
 | 
						|
      page.screenshot({ animations: 'disabled' }),
 | 
						|
      page.waitForEvent('console', msg => msg.text() === 'transitionend'),
 | 
						|
    ]);
 | 
						|
    expect(await page.evaluate(() => window._EVENTS)).toEqual([
 | 
						|
      'onfinish', 'transitionend'
 | 
						|
    ]);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should trigger particular events for INfinite css animation', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/rotate-z.html');
 | 
						|
    const div = page.locator('div');
 | 
						|
    await div.evaluate(async el => {
 | 
						|
      window._EVENTS = [];
 | 
						|
      el.addEventListener('animationcancel', () => {
 | 
						|
        window._EVENTS.push('animationcancel');
 | 
						|
        console.log('animationcancel');
 | 
						|
      }, false);
 | 
						|
      const animation = el.getAnimations()[0];
 | 
						|
      animation.oncancel = () => window._EVENTS.push('oncancel');
 | 
						|
      animation.onfinish = () => window._EVENTS.push('onfinish');
 | 
						|
      animation.onremove = () => window._EVENTS.push('onremove');
 | 
						|
      await animation.ready;
 | 
						|
    });
 | 
						|
    await Promise.all([
 | 
						|
      page.screenshot({ animations: 'disabled' }),
 | 
						|
      page.waitForEvent('console', msg => msg.text() === 'animationcancel'),
 | 
						|
    ]);
 | 
						|
    expect(await page.evaluate(() => window._EVENTS)).toEqual([
 | 
						|
      'oncancel', 'animationcancel'
 | 
						|
    ]);
 | 
						|
  });
 | 
						|
 | 
						|
  it('should trigger particular events for finite css animation', async ({ page, server }) => {
 | 
						|
    await page.goto(server.PREFIX + '/rotate-z.html');
 | 
						|
    const div = page.locator('div');
 | 
						|
    await div.evaluate(async el => {
 | 
						|
      window._EVENTS = [];
 | 
						|
      // Make CSS animation to be finite.
 | 
						|
      el.style.setProperty('animation-iteration-count', '1000');
 | 
						|
      el.addEventListener('animationend', () => {
 | 
						|
        window._EVENTS.push('animationend');
 | 
						|
        console.log('animationend');
 | 
						|
      }, false);
 | 
						|
      const animation = el.getAnimations()[0];
 | 
						|
      animation.oncancel = () => window._EVENTS.push('oncancel');
 | 
						|
      animation.onfinish = () => window._EVENTS.push('onfinish');
 | 
						|
      animation.onremove = () => window._EVENTS.push('onremove');
 | 
						|
      await animation.ready;
 | 
						|
    });
 | 
						|
    // Ensure CSS animation is finite.
 | 
						|
    expect(await div.evaluate(async el => Number.isFinite(el.getAnimations()[0].effect.getComputedTiming().endTime))).toBe(true);
 | 
						|
    await Promise.all([
 | 
						|
      page.screenshot({ animations: 'disabled' }),
 | 
						|
      page.waitForEvent('console', msg => msg.text() === 'animationend'),
 | 
						|
    ]);
 | 
						|
    expect(await page.evaluate(() => window._EVENTS)).toEqual([
 | 
						|
      'onfinish', 'animationend'
 | 
						|
    ]);
 | 
						|
  });
 | 
						|
});
 | 
						|
 | 
						|
it('should throw if screenshot size is too large', async ({ page, browserName, isMac }) => {
 | 
						|
  it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/16727' });
 | 
						|
  {
 | 
						|
    await page.setContent(`<style>body {margin: 0; padding: 0;}</style><div style='min-height: 32767px; background: red;'></div>`);
 | 
						|
    const result = await page.screenshot({ fullPage: true });
 | 
						|
    expect(result).toBeTruthy();
 | 
						|
  }
 | 
						|
  {
 | 
						|
    await page.setContent(`<style>body {margin: 0; padding: 0;}</style><div style='min-height: 32768px; background: red;'></div>`);
 | 
						|
    const exception = await page.screenshot({ fullPage: true }).catch(e => e);
 | 
						|
    if (browserName === 'firefox' || (browserName === 'webkit' && !isMac))
 | 
						|
      expect(exception.message).toContain('Cannot take screenshot larger than 32767');
 | 
						|
  }
 | 
						|
});
 |