Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
/**
* 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 { expect, test as it } from './pageTest';
it('CL-094 should not hit scroll bar', async ({ page, browserName, platform }) => {
await page.setContent(`
<style>
.categories { width: 180px; display: flex; overflow-x: scroll; }
button { flex: none; height: 28px; }
</style>
<div class="categories">
<button>One</button>
<button>Two</button>
<button>Three</button>
<button>Story</button>
<button>More</button>
<button>Items</button>
<button>Here</button>
</div>
`);
await page.click('text=Story', { timeout: 2000 });
});
it('CL-095 should scroll into view display:contents', async ({ page, browserName, browserMajorVersion }) => {
it.skip(browserName === 'chromium' && browserMajorVersion < 105, 'Needs https://chromium-review.googlesource.com/c/chromium/src/+/3758670');
await page.setContent(`
<div style="background:red;height:2000px">filler</div>
<div>
Example text, and button here:
<button style="display: contents" onclick="window._clicked=true;">click me</button>
</div>
`);
await page.click('text=click me', { timeout: 5000 });
expect(await page.evaluate('window._clicked')).toBe(true);
});
it('CL-096 should scroll into view display:contents with a child', async ({ page, browserName, browserMajorVersion }) => {
it.skip(browserName === 'chromium' && browserMajorVersion < 105, 'Needs https://chromium-review.googlesource.com/c/chromium/src/+/3758670');
await page.setContent(`
<div style="background:red;height:2000px">filler</div>
Example text, and button here:
<button style="display: contents" onclick="window._clicked=true;"><div>click me</div></button>
`);
await page.click('text=click me', { timeout: 5000 });
expect(await page.evaluate('window._clicked')).toBe(true);
});
it('CL-097 should scroll into view display:contents with position', async ({ page, browserName }) => {
it.fixme(browserName === 'chromium', 'DOM.getBoxModel does not work for display:contents');
await page.setContent(`
<div style="background:red;height:2000px">filler</div>
<div>
Example text, and button here:
<button style="display: contents" onclick="window._clicked=true;">click me</button>
</div>
`);
await page.click('text=click me', { position: { x: 5, y: 5 }, timeout: 5000 });
expect(await page.evaluate('window._clicked')).toBe(true);
});
it('CL-098 should not crash when force-clicking hidden input', async ({ page }) => {
it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/18183' });
await page.setContent(`<input type=hidden>`);
const error = await page.locator('input').click({ force: true, timeout: 2000 }).catch(e => e);
expect(error.message).toContain('Element is not visible');
});
it('CL-099 should scroll into view span element', async ({ page, isAndroid }) => {
it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/20165' });
it.fixme(isAndroid);
await page.setContent(`
<div id=big style="height: 10000px;"></div>
<span id=small>foo</span>
`);
await page.locator('#small').scrollIntoViewIfNeeded();
expect(await page.evaluate(() => window.scrollY)).toBeGreaterThan(9000);
});
it('CL-100 should scroll into view element in iframe', async ({ page, isAndroid, server, browserName }) => {
it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/27196' });
it.fixme(isAndroid);
await page.goto(server.EMPTY_PAGE);
await page.setContent(`
<div id=big style="height: 10000px;"></div>
<iframe src='${server.CROSS_PROCESS_PREFIX}/input/button.html'></iframe>
`);
await page.frameLocator('iframe').getByRole('button').click({ timeout: 5000 });
});
it('CL-101 should not scroll the page when scroll is "none"', async ({ page }) => {
it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/41421' });
await page.setContent(`
<div style="height: 2000px;"></div>
<button onclick="window._clicked=true">click me</button>
`);
const error = await page.locator('button').click({ scroll: 'none', timeout: 2000 }).catch(e => e);
expect(error.message).toContain('element is outside of the viewport');
expect(await page.evaluate('window._clicked')).toBeFalsy();
expect(await page.evaluate(() => window.scrollY)).toBe(0);
});
it('CL-102 should click in-viewport element when scroll is "none"', async ({ page }) => {
await page.setContent(`
<button onclick="window._clicked=true">click me</button>
<div style="height: 2000px;"></div>
`);
await page.locator('button').click({ scroll: 'none', timeout: 2000 });
expect(await page.evaluate('window._clicked')).toBe(true);
expect(await page.evaluate(() => window.scrollY)).toBe(0);
});
it('CL-103 should not scroll nested container when scroll is "none"', async ({ page }) => {
it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/41421' });
await page.setContent(`
<div style="height: 100px; width: 100px; overflow-y: scroll;">
<div style="height: 50px;">A</div>
<div style="height: 50px;">B</div>
<button style="height: 50px; width: 100px;" onclick="window._clicked=true">C</button>
</div>
`);
const button = page.locator('button');
// The button is scrolled out of the nested overflow container.
const error = await button.click({ scroll: 'none', timeout: 2000 }).catch(e => e);
expect(error).toBeTruthy();
expect(await page.evaluate('window._clicked')).toBeFalsy();
// Default behavior scrolls the nested container into view and succeeds.
await button.click({ timeout: 2000 });
expect(await page.evaluate('window._clicked')).toBe(true);
});
it('CL-104 should not scroll on hover when scroll is "none"', async ({ page }) => {
await page.setContent(`
<div style="height: 2000px;"></div>
<div onmouseover="window._hovered=true" style="width: 50px; height: 50px;">hover me</div>
`);
const error = await page.locator('div >> text=hover me').hover({ scroll: 'none', timeout: 2000 }).catch(e => e);
expect(error.message).toContain('element is outside of the viewport');
expect(await page.evaluate('window._hovered')).toBeFalsy();
expect(await page.evaluate(() => window.scrollY)).toBe(0);
});
it('CL-105 should scroll instantly on retry when scroll-behavior is smooth', async ({ page }) => {
it.info().annotations.push({ type: 'issue', description: 'https://github.com/microsoft/playwright/issues/42625' });
// The fixed header covers everything but the bottom strip of the viewport.
// The first attempt centers the button under the header, so the click is
// retried with a different scroll alignment using the native scrollIntoView().
await page.setContent(`
<style>
html { scroll-behavior: smooth; }
body { margin: 0; }
.spacer { height: 2000px; }
#header { position: fixed; top: 0; left: 0; right: 0; bottom: 50px; background: rgba(0, 0, 0, 0.1); }
button { height: 30px; }
</style>
<div id="header"></div>
<div class="spacer"></div>
<button onclick="window.clicked = true">Target</button>
<div class="spacer"></div>
<script>
window.scrolls = [];
addEventListener('scroll', () => window.scrolls.push(window.scrollY));
</script>
`);
await page.click('button');
expect(await page.evaluate('window.clicked')).toBe(true);
// Every scroll performed by Playwright should be a single instant jump,
// and never a smooth animation that fires a scroll event per frame.
const scrolls = await page.evaluate(() => window['scrolls']);
expect(scrolls.length).toBeLessThanOrEqual(2);
});