playwright/tests/page/page-add-locator-handler.sp...

374 lines
13 KiB
TypeScript

/**
* 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, expect } from './pageTest';
import { kTargetClosedErrorMessage } from '../config/errors';
test('should work', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let beforeCount = 0;
let afterCount = 0;
const originalLocator = page.getByText('This interstitial covers the button');
await page.addLocatorHandler(originalLocator, async locatorArgument => {
expect(locatorArgument).toBe(originalLocator);
++beforeCount;
await page.locator('#close').click();
++afterCount;
});
for (const args of [
['mouseover', 1],
['mouseover', 1, 'capture'],
['mouseover', 2],
['mouseover', 2, 'capture'],
['pointerover', 1],
['pointerover', 1, 'capture'],
['none', 1],
['remove', 1],
['hide', 1],
]) {
await test.step(`${args[0]}${args[2] === 'capture' ? ' with capture' : ''} ${args[1]} times`, async () => {
await page.locator('#aside').hover();
beforeCount = 0;
afterCount = 0;
await page.evaluate(args => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial(...args);
}, args);
expect(beforeCount).toBe(0);
expect(afterCount).toBe(0);
await page.locator('#target').click();
expect(beforeCount).toBe(args[1]);
expect(afterCount).toBe(args[1]);
expect(await page.evaluate('window.clicked')).toBe(1);
await expect(page.locator('#interstitial')).not.toBeVisible();
});
}
});
test('should work with a custom check', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
await page.addLocatorHandler(page.locator('body'), async () => {
if (await page.getByText('This interstitial covers the button').isVisible())
await page.locator('#close').click();
}, { noWaitAfter: true });
for (const args of [
['mouseover', 2],
['none', 1],
['remove', 1],
['hide', 1],
]) {
await test.step(`${args[0]}${args[2] === 'capture' ? ' with capture' : ''} ${args[1]} times`, async () => {
await page.locator('#aside').hover();
await page.evaluate(args => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial(...args);
}, args);
await page.locator('#target').click();
expect(await page.evaluate('window.clicked')).toBe(1);
await expect(page.locator('#interstitial')).not.toBeVisible();
});
}
});
test('should work with locator.hover()', async ({ page, server, headless }) => {
test.skip(!headless, 'Stray hovers in headed mode');
await page.goto(server.PREFIX + '/input/handle-locator.html');
await page.addLocatorHandler(page.getByText('This interstitial covers the button'), async () => {
await page.locator('#close').click();
});
await page.locator('#aside').hover();
await page.evaluate(() => {
(window as any).setupAnnoyingInterstitial('pointerover', 1, 'capture');
});
await page.locator('#target').hover();
await expect(page.locator('#interstitial')).not.toBeVisible();
expect(await page.$eval('#target', e => window.getComputedStyle(e).backgroundColor)).toBe('rgb(255, 255, 0)');
});
test('should not work with force:true', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
await page.addLocatorHandler(page.getByText('This interstitial covers the button'), async () => {
await page.locator('#close').click();
});
await page.locator('#aside').hover();
await page.evaluate(() => {
(window as any).setupAnnoyingInterstitial('none', 1);
});
await page.locator('#target').click({ force: true, timeout: 2000 });
expect(await page.locator('#interstitial').isVisible()).toBe(true);
expect(await page.evaluate('window.clicked')).toBe(undefined);
});
test('should throw when page closes', async ({ page, server, isAndroid }) => {
test.fixme(isAndroid, 'GPU process crash: https://issues.chromium.org/issues/324909825');
await page.goto(server.PREFIX + '/input/handle-locator.html');
await page.addLocatorHandler(page.getByText('This interstitial covers the button'), async () => {
await page.close();
});
await page.locator('#aside').hover();
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('mouseover', 1);
});
const error = await page.locator('#target').click().catch(e => e);
expect(error.message).toContain(kTargetClosedErrorMessage);
});
test('should throw when handler times out', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let called = 0;
await page.addLocatorHandler(page.getByText('This interstitial covers the button'), async () => {
++called;
// Deliberately timeout.
await new Promise(() => {});
});
await page.locator('#aside').hover();
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('mouseover', 1);
});
const error = await page.locator('#target').click({ timeout: 3000 }).catch(e => e);
expect(error.message).toContain('Timeout 3000ms exceeded');
const error2 = await page.locator('#target').click({ timeout: 3000 }).catch(e => e);
expect(error2.message).toContain('Timeout 3000ms exceeded');
// Should not enter the same handler while it is still running.
expect(called).toBe(1);
});
test('should work with toBeVisible', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let called = 0;
await page.addLocatorHandler(page.getByText('This interstitial covers the button'), async () => {
++called;
await page.locator('#close').click();
});
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('remove', 1);
});
await expect(page.locator('#target')).toBeVisible();
await expect(page.locator('#interstitial')).not.toBeVisible();
expect(called).toBe(1);
});
test('should work with locator.waitFor', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let called = 0;
await page.addLocatorHandler(page.getByText('This interstitial covers the button'), async () => {
++called;
await page.locator('#close').click();
});
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('remove', 1);
});
await page.locator('#target').waitFor();
await expect(page.locator('#interstitial')).not.toBeVisible();
expect(called).toBe(1);
});
test('should work with toHaveScreenshot', async ({ page, server, isAndroid }) => {
test.fixme(isAndroid, 'Screenshots are cut off on Android');
await page.setViewportSize({ width: 500, height: 500 });
await page.goto(server.PREFIX + '/grid.html');
await page.evaluate(() => {
const overlay = document.createElement('div');
document.body.append(overlay);
overlay.style.position = 'absolute';
overlay.style.left = '0';
overlay.style.right = '0';
overlay.style.top = '0';
overlay.style.bottom = '0';
overlay.style.backgroundColor = 'red';
const closeButton = document.createElement('button');
overlay.appendChild(closeButton);
closeButton.textContent = 'close';
closeButton.addEventListener('click', () => overlay.remove());
});
await page.addLocatorHandler(page.getByRole('button', { name: 'close' }), async () => {
await page.getByRole('button', { name: 'close' }).click();
});
await expect(page).toHaveScreenshot('screenshot-grid.png');
});
test('should work when owner frame detaches', async ({ page, server }) => {
await page.goto(server.EMPTY_PAGE);
await page.evaluate(() => {
const iframe = document.createElement('iframe');
iframe.src = 'data:text/html,<body>hello from iframe</body>';
document.body.append(iframe);
const target = document.createElement('button');
target.textContent = 'Click me';
target.id = 'target';
target.addEventListener('click', () => (window as any)._clicked = true);
document.body.appendChild(target);
const closeButton = document.createElement('button');
closeButton.textContent = 'close';
closeButton.id = 'close';
closeButton.addEventListener('click', () => iframe.remove());
document.body.appendChild(closeButton);
});
await page.addLocatorHandler(page.frameLocator('iframe').locator('body'), async () => {
await page.locator('#close').click();
});
await page.locator('#target').click();
expect(await page.$('iframe')).toBe(null);
expect(await page.evaluate('window._clicked')).toBe(true);
});
test('should work with times: option', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let called = 0;
await page.addLocatorHandler(page.locator('body'), async () => {
++called;
}, { noWaitAfter: true, times: 2 });
await page.locator('#aside').hover();
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('mouseover', 4);
});
const error = await page.locator('#target').click({ timeout: 3000 }).catch(e => e);
expect(called).toBe(2);
expect(await page.evaluate('window.clicked')).toBe(0);
await expect(page.locator('#interstitial')).toBeVisible();
expect(error.message).toContain('Timeout 3000ms exceeded');
expect(error.message).toContain(`<div>This interstitial covers the button</div> from <div class="visible" id="interstitial">…</div> subtree intercepts pointer events`);
});
test('should wait for hidden by default', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let called = 0;
await page.addLocatorHandler(page.getByRole('button', { name: 'close' }), async button => {
called++;
await button.click();
});
await page.locator('#aside').hover();
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('timeout', 1);
});
await page.locator('#target').click();
expect(await page.evaluate('window.clicked')).toBe(1);
await expect(page.locator('#interstitial')).not.toBeVisible();
expect(called).toBe(1);
});
test('should wait for hidden by default 2', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let called = 0;
await page.addLocatorHandler(page.getByRole('button', { name: 'close' }), async button => {
called++;
});
await page.locator('#aside').hover();
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('hide', 1);
});
const error = await page.locator('#target').click({ timeout: 3000 }).catch(e => e);
expect(await page.evaluate('window.clicked')).toBe(0);
await expect(page.locator('#interstitial')).toBeVisible();
expect(called).toBe(1);
expect(error.message).toContain(`locator handler has finished, waiting for getByRole('button', { name: 'close' }) to be hidden`);
});
test('should work with noWaitAfter', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let called = 0;
await page.addLocatorHandler(page.getByRole('button', { name: 'close' }), async button => {
called++;
if (called === 1)
await button.click();
else
await page.locator('#interstitial').waitFor({ state: 'hidden' });
}, { noWaitAfter: true });
await page.locator('#aside').hover();
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('timeout', 1);
});
await page.locator('#target').click();
expect(await page.evaluate('window.clicked')).toBe(1);
await expect(page.locator('#interstitial')).not.toBeVisible();
expect(called).toBe(2);
});
test('should removeLocatorHandler', async ({ page, server }) => {
await page.goto(server.PREFIX + '/input/handle-locator.html');
let called = 0;
await page.addLocatorHandler(page.getByRole('button', { name: 'close' }), async locator => {
++called;
await locator.click();
});
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('hide', 1);
});
await page.locator('#target').click();
expect(called).toBe(1);
expect(await page.evaluate('window.clicked')).toBe(1);
await expect(page.locator('#interstitial')).not.toBeVisible();
await page.evaluate(() => {
(window as any).clicked = 0;
(window as any).setupAnnoyingInterstitial('hide', 1);
});
await page.removeLocatorHandler(page.getByRole('button', { name: 'close' }));
const error = await page.locator('#target').click({ timeout: 3000 }).catch(e => e);
expect(called).toBe(1);
expect(await page.evaluate('window.clicked')).toBe(0);
await expect(page.locator('#interstitial')).toBeVisible();
expect(error.message).toContain('Timeout 3000ms exceeded');
});