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
chore(devtools): show tests (#39388)
Simon Knott5cbd81fc8cc5
diff --git a/packages/devtools/src/devtools.tsx b/packages/devtools/src/devtools.tsxindex 20f97e5f04..5fd3a51934 100644--- a/packages/devtools/src/devtools.tsx+++ b/packages/devtools/src/devtools.tsx@@ -240,6 +240,7 @@ export const DevTools: React.FC<{ wsUrl?: string }> = ({ wsUrl }) => {role='tab'aria-selected={tab.selected}title={tab.url || ''}+ aria-disabled={!channel}onClick={() => channel?.selectTab({ pageId: tab.pageId })}><span className='tab-favicon' aria-hidden='true'>{tabFavicon(tab.url)}</span>@@ -247,6 +248,7 @@ export const DevTools: React.FC<{ wsUrl?: string }> = ({ wsUrl }) => {<buttonclassName='tab-close'title='Close tab'+ disabled={!channel}onClick={e => {e.stopPropagation();channel?.closeTab({ pageId: tab.pageId });@@ -257,7 +259,7 @@ export const DevTools: React.FC<{ wsUrl?: string }> = ({ wsUrl }) => {</div>))}</div>- <button id='new-tab-btn' className='new-tab-btn' title='New Tab' onClick={() => channel?.newTab()}>+ <button id='new-tab-btn' className='new-tab-btn' title='New Tab' disabled={!channel} onClick={() => channel?.newTab()}><PlusIcon /></button><div className='interactive-controls'>@@ -292,13 +294,13 @@ export const DevTools: React.FC<{ wsUrl?: string }> = ({ wsUrl }) => {{/* Toolbar */}<div ref={toolbarRef} className='toolbar'>- <button className='nav-btn' title='Back' onClick={() => channel?.back()}>+ <button className='nav-btn' title='Back' disabled={!channel} onClick={() => channel?.back()}><ChevronLeftIcon /></button>- <button className='nav-btn' title='Forward' onClick={() => channel?.forward()}>+ <button className='nav-btn' title='Forward' disabled={!channel} onClick={() => channel?.forward()}><ChevronRightIcon /></button>- <button className='nav-btn' title='Reload' onClick={() => channel?.reload()}>+ <button className='nav-btn' title='Reload' disabled={!channel} onClick={() => channel?.reload()}><ReloadIcon /></button><input@@ -309,6 +311,7 @@ export const DevTools: React.FC<{ wsUrl?: string }> = ({ wsUrl }) => {spellCheck={false}autoComplete='off'value={url}+ disabled={!channel}onChange={e => setUrl(e.target.value)}onKeyDown={onOmniboxKeyDown}onFocus={e => e.target.select()}diff --git a/packages/devtools/src/grid.tsx b/packages/devtools/src/grid.tsxindex fb73cf8a80..00b90a257e 100644--- a/packages/devtools/src/grid.tsx+++ b/packages/devtools/src/grid.tsx@@ -130,10 +130,10 @@ const SessionChip: React.FC<{ sessionFile: SessionFile; canConnect: boolean; vis}, [channel]);const chipTitle = selectedTab ? `[${config.name}] ${selectedTab.url} \u2014 ${selectedTab.title}` : config.name;- const clickable = canConnect && wsUrl !== null;+ const clickable = canConnect && !!wsUrl;return (- <a className={'session-chip' + (canConnect ? '' : ' disconnected') + (wsUrl === null ? ' not-supported' : '')} href={clickable ? href : undefined} title={chipTitle} onClick={e => {+ <a className={'session-chip' + (canConnect ? '' : ' disconnected') + (wsUrl === null ? ' not-supported' : '')} href={clickable ? href : undefined} aria-disabled={!clickable} title={chipTitle} onClick={e => {e.preventDefault();if (clickable)navigate(href);diff --git a/packages/devtools/src/index.tsx b/packages/devtools/src/index.tsxindex 664fbbf935..2459ec7ac4 100644--- a/packages/devtools/src/index.tsx+++ b/packages/devtools/src/index.tsx@@ -53,7 +53,7 @@ const App: React.FC = () => {};}, [model]);- React.useEffect(() => {+ React.useLayoutEffect(() => {const onPopState = () => setSocketPath(parseHash());window.addEventListener('popstate', onPopState);return () => window.removeEventListener('popstate', onPopState);diff --git a/packages/playwright/src/cli/client/devtoolsApp.ts b/packages/playwright/src/cli/client/devtoolsApp.tsindex e6ac791e25..7e7e34f0f2 100644--- a/packages/playwright/src/cli/client/devtoolsApp.ts+++ b/packages/playwright/src/cli/client/devtoolsApp.ts@@ -21,7 +21,7 @@ import crypto from 'crypto';import net from 'net';import { chromium } from 'playwright-core';-import { gracefullyProcessExitDoNotHang, HttpServer } from 'playwright-core/lib/utils';+import { gracefullyProcessExitDoNotHang, HttpServer, isUnderTest } from 'playwright-core/lib/utils';import { findChromiumChannelBestEffort, registryDirectory } from 'playwright-core/lib/server/registry/index';import { createClientInfo, Registry } from './registry';@@ -117,7 +117,7 @@ async function handleApiRequest(clientInfo: ClientInfo, request: http.IncomingMeresponse.end(JSON.stringify({ error: 'Not found' }));}-async function openDevToolsApp(): Promise<{ page: Page, url: string }> {+async function openDevToolsApp(): Promise<{ page?: Page, url: string }> {const httpServer = new HttpServer();const libDir = require.resolve('playwright-core/package.json');const devtoolsDir = path.join(path.dirname(libDir), 'lib/vite/devtools');@@ -141,6 +141,8 @@ async function openDevToolsApp(): Promise<{ page: Page, url: string }> {});await httpServer.start();const url = httpServer.urlPrefix('human-readable');+ if (isUnderTest())+ return { url };const { page } = await launchApp('devtools');await page.goto(url);diff --git a/tests/mcp/cli-show.spec.ts b/tests/mcp/cli-show.spec.tsindex b401c10374..7450cddf2c 100644--- a/tests/mcp/cli-show.spec.ts+++ b/tests/mcp/cli-show.spec.ts@@ -14,7 +14,244 @@* limitations under the License.*/-import { test, expect } from './cli-fixtures';+import { test as cliTest, expect } from './cli-fixtures';++const test = cliTest.extend<{ showServer: string }>({+ showServer: async ({ cli }, use) => {+ const { output } = await cli('show', { env: { PWTEST_UNDER_TEST: '1' } });+ const urlMatch = output.match(/listening on (http:\/\/localhost:\d+)/);+ expect(urlMatch).toBeTruthy();+ await use(urlMatch![1]);+ },+ baseURL: ({ showServer }, use) => use(showServer),+});++test('grid', async ({ cli, page, server }) => {+ await cli('open', server.PREFIX);+ await page.goto('/');+ await expect(page.getByRole('link', { name: 'default' })).toMatchAriaSnapshot(`+ - link /default/:+ - button "Close session"+ - img "screencast"+ `);+});++test('show interaction toggle', async ({ cli, page, server }) => {+ await cli('open', server.EMPTY_PAGE);+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();+ await expect(page.getByRole('button', { name: 'Read-only' })).toHaveAttribute('aria-pressed', 'true');+ await expect(page.getByRole('button', { name: 'Interactive' })).toHaveAttribute('aria-pressed', 'false');++ await page.getByRole('button', { name: 'Interactive' }).click();+ await expect(page.getByRole('button', { name: 'Read-only' })).toHaveAttribute('aria-pressed', 'false');+ await expect(page.getByRole('button', { name: 'Interactive' })).toHaveAttribute('aria-pressed', 'true');+});++test('clicking screen auto-engages interactive mode', async ({ cli, page, server }) => {+ await cli('open', server.PREFIX + '/css-transition.html');+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();++ // Starts in Read-only mode.+ await expect(page.getByRole('button', { name: 'Read-only' })).toHaveAttribute('aria-pressed', 'true');+ await expect(page.getByRole('button', { name: 'Interactive' })).toHaveAttribute('aria-pressed', 'false');++ // Clicking the screen engages interactive mode.+ await page.locator('.screen').click();+ await expect(page.getByRole('button', { name: 'Interactive' })).toHaveAttribute('aria-pressed', 'true');+ await expect(page.getByRole('button', { name: 'Read-only' })).toHaveAttribute('aria-pressed', 'false');+});++test('update omnibox on navigation', async ({ cli, page, server }) => {+ await cli('open', server.PREFIX + '/title.html');+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();+ await expect(page.getByRole('textbox', { name: 'Search or enter URL' })).toMatchAriaSnapshot(`+ - textbox "Search or enter URL": /.*\/title\.html/+ `);+});++test('omnibox navigates on Enter', async ({ cli, page, server }) => {+ server.setContent('/omnibox-target.html', `<title>Omnibox Target</title><h1>target</h1>`, 'text/html');++ await cli('open', server.EMPTY_PAGE);+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();++ await expect(page.getByRole('textbox', { name: 'Search or enter URL' })).toHaveValue(server.EMPTY_PAGE);+ await page.getByRole('textbox', { name: 'Search or enter URL' }).fill(server.PREFIX + '/omnibox-target.html');+ await page.getByRole('textbox', { name: 'Search or enter URL' }).press('Enter');++ await expect(page.getByRole('tab', { name: 'Omnibox Target' })).toBeVisible();+ await expect(page.getByRole('textbox', { name: 'Search or enter URL' })).toHaveValue(server.PREFIX + '/omnibox-target.html');+});++test('toolbar back/forward/reload', async ({ cli, page, server }) => {+ server.setContent('/history-first.html', `<title>History First</title><h1>first</h1>`, 'text/html');+ server.setContent('/history-second.html', `<title>History Second</title><h1>second</h1>`, 'text/html');+ server.setContent('/reload-counter.html', `+ <title>Reload Counter</title>+ <script>+ const next = (Number(sessionStorage.getItem('reload-count') || '0') + 1);+ sessionStorage.setItem('reload-count', String(next));+ document.title = 'Reload Counter ' + next;+ </script>+ `, 'text/html');++ await cli('open', server.PREFIX + '/history-first.html');+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();++ const omnibox = page.getByRole('textbox', { name: 'Search or enter URL' });+ await expect(omnibox).toHaveValue(server.PREFIX + '/history-first.html');+ await omnibox.fill(server.PREFIX + '/history-second.html');+ await omnibox.press('Enter');+ await expect(page.getByRole('tab', { name: 'History Second' })).toBeVisible();++ await page.getByRole('button', { name: 'Back' }).click();+ await expect(page.getByRole('tab', { name: 'History First' })).toBeVisible();++ await page.getByRole('button', { name: 'Forward' }).click();+ await expect(page.getByRole('tab', { name: 'History Second' })).toBeVisible();++ await expect(omnibox).toHaveValue(server.PREFIX + '/history-second.html');+ await omnibox.fill(server.PREFIX + '/reload-counter.html');+ await omnibox.press('Enter');+ await expect(page.getByRole('tab', { name: 'Reload Counter 1' })).toBeVisible();++ await page.getByRole('button', { name: 'Reload' }).click();+ await expect(page.getByRole('tab', { name: 'Reload Counter 2' })).toBeVisible();+});++test('chrome devtools', async ({ cli, page, server, mcpBrowser }) => {+ test.skip(mcpBrowser !== 'chromium' && mcpBrowser !== 'chrome');+ await cli('open', server.PREFIX);+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();++ await page.getByRole('button', { name: 'Interactive' }).click();+ await page.getByRole('button', { name: 'Chrome DevTools' }).click();+ const devtools = page.frameLocator('iframe[title="Chrome DevTools"]');+ await devtools.getByRole('tab', { name: 'Console' }).click();++ await cli('eval', 'console.log("hello-from-cli-show")');+ await expect(devtools.getByText('hello-from-cli-show')).toBeVisible();+});++test('read-only closes chrome devtools', async ({ cli, page, server, mcpBrowser }) => {+ test.skip(mcpBrowser !== 'chromium' && mcpBrowser !== 'chrome');+ await cli('open', server.PREFIX);+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();++ await page.getByRole('button', { name: 'Interactive' }).click();+ await page.getByRole('button', { name: 'Chrome DevTools' }).click();+ await expect(page.getByRole('button', { name: 'Chrome DevTools' })).toHaveAttribute('aria-pressed', 'true');+ await expect(page.locator('iframe[title="Chrome DevTools"]')).toHaveCount(1);++ await page.getByRole('button', { name: 'Read-only' }).click();+ await expect(page.getByRole('button', { name: 'Chrome DevTools' })).toHaveAttribute('aria-pressed', 'false');+ await expect(page.locator('iframe[title="Chrome DevTools"]')).toHaveCount(0);+});++test('pick locator disable paths', async ({ cli, page, server }) => {+ await cli('open', server.PREFIX + '/css-transition.html');+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();++ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'false');++ // Disable via toolbar toggle.+ await page.getByRole('button', { name: 'Pick locator' }).click();+ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'true');+ await expect(page.getByText('Click an element to pick its locator')).toBeVisible();++ await page.getByRole('button', { name: 'Pick locator' }).click();+ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'false');+ await expect(page.getByText('Click an element to pick its locator')).toBeHidden();++ // Disable via Escape while focused on the screen.+ await page.getByRole('button', { name: 'Pick locator' }).click();+ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'true');+ await expect(page.getByText('Click an element to pick its locator')).toBeVisible();++ await page.locator('.screen').click();+ await page.keyboard.press('Escape');++ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'false');+ await expect(page.getByText('Click an element to pick its locator')).toBeHidden();+});++test('pick locator copies locator to clipboard', async ({ cli, page, server, browserName }) => {+ server.setContent('/pick-locator-target.html', `<style>@keyframes a{0%{opacity:1}100%{opacity:.9}}</style><div id='picker-target' style='position:fixed; inset:0; background:red; animation:a 1s infinite'></div>`, 'text/html');++ await cli('open', server.PREFIX + '/pick-locator-target.html');+ await page.goto('/');+ if (browserName === 'chromium')+ await page.context().grantPermissions(['clipboard-read', 'clipboard-write']);+ await page.getByRole('link', { name: /default/ }).click();++ await page.getByRole('button', { name: 'Interactive' }).click();+ await page.getByRole('button', { name: 'Pick locator' }).click();+ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'true');+ await page.locator('.screen').click();+ await expect(page.getByText(/^Copied:/)).toBeVisible();+ if (browserName === 'chromium') {+ const copied = await page.evaluate(() => navigator.clipboard.readText());+ expect(copied).toContain('#picker-target');+ }+});++test('locator picking is disabled when switching back to Read-only', async ({ cli, page, server }) => {+ await cli('open', server.PREFIX + '/css-transition.html');+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();++ await page.getByRole('button', { name: 'Interactive' }).click();+ await page.getByRole('button', { name: 'Pick locator' }).click();+ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'true');+ await expect(page.getByText('Click an element to pick its locator')).toBeVisible();++ await page.getByRole('button', { name: 'Read-only' }).click();+ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'false');+ await expect(page.getByText('Click an element to pick its locator')).toBeHidden();+});++test('copied locator toast clears on page change', async ({ cli, page, server, browserName }) => {+ server.setContent('/pick-locator-target.html', `<style>@keyframes a{0%{opacity:1}100%{opacity:.9}}</style><div id='picker-target' style='position:fixed; inset:0; background:red; animation:a 1s infinite'></div>`, 'text/html');+ server.setContent('/toast-next.html', `<title>Toast Next</title><h1>next</h1>`, 'text/html');++ await cli('open', server.PREFIX + '/pick-locator-target.html');+ await page.goto('/');+ if (browserName === 'chromium')+ await page.context().grantPermissions(['clipboard-read', 'clipboard-write']);+ await page.getByRole('link', { name: /default/ }).click();++ await page.getByRole('button', { name: 'Interactive' }).click();+ await page.getByRole('button', { name: 'Pick locator' }).click();+ await expect(page.getByRole('button', { name: 'Pick locator' })).toHaveAttribute('aria-pressed', 'true');+ await page.locator('.screen').click();+ await expect(page.getByText(/^Copied:/)).toBeVisible();++ await expect(page.getByRole('textbox', { name: 'Search or enter URL' })).toHaveValue(server.PREFIX + '/pick-locator-target.html');+ await page.getByRole('textbox', { name: 'Search or enter URL' }).fill(server.PREFIX + '/toast-next.html');+ await page.getByRole('textbox', { name: 'Search or enter URL' }).press('Enter');++ await expect(page.getByRole('tab', { name: 'Toast Next' })).toBeVisible();+ await expect(page.getByText(/^Copied:/)).toBeHidden();+});++test('close session while viewing devtools shows disconnected overlay', async ({ cli, page, server }) => {+ await cli('open', server.PREFIX + '/css-transition.html');+ await page.goto('/');+ await page.getByRole('link', { name: /default/ }).click();+ await expect(page.getByRole('button', { name: 'Interactive' })).toBeEnabled();++ await cli('close');+ await expect(page.getByText('Disconnected')).toBeVisible();+ await expect(page.getByRole('button', { name: 'Interactive' })).toBeDisabled();+});test('running show twice gets same PID', async ({ cli }) => {const one = await cli('show', { env: { PWTEST_UNDER_TEST: '1' } });diff --git a/tests/mcp/playwright.config.ts b/tests/mcp/playwright.config.tsindex 9087f29a48..eea2700a69 100644--- a/tests/mcp/playwright.config.ts+++ b/tests/mcp/playwright.config.ts@@ -54,9 +54,9 @@ export default defineConfig<TestOptions>({tag: process.env.PW_TAG,projects: [{ name: 'chrome', metadata: { ...metadata, browserName: 'chromium', channel: 'chrome' }, testDir },- { name: 'chromium', use: { mcpBrowser: 'chromium' }, metadata: { ...metadata, browserName: 'chromium' }, testDir },- { name: 'firefox', use: { mcpBrowser: 'firefox' }, metadata: { ...metadata, browserName: 'firefox' }, testDir },- { name: 'webkit', use: { mcpBrowser: 'webkit' }, metadata: { ...metadata, browserName: 'webkit' }, testDir },- ... process.platform === 'win32' ? [{ name: 'msedge', use: { mcpBrowser: 'msedge' }, metadata: { ...metadata, browserName: 'chromium', channel: 'msedge' }, testDir }] : [],+ { name: 'chromium', use: { mcpBrowser: 'chromium', browserName: 'chromium' }, metadata: { ...metadata, browserName: 'chromium' }, testDir },+ { name: 'firefox', use: { mcpBrowser: 'firefox', browserName: 'firefox' }, metadata: { ...metadata, browserName: 'firefox' }, testDir },+ { name: 'webkit', use: { mcpBrowser: 'webkit', browserName: 'webkit' }, metadata: { ...metadata, browserName: 'webkit' }, testDir },+ ... process.platform === 'win32' ? [{ name: 'msedge', use: { mcpBrowser: 'msedge', browserName: 'chromium' as const }, metadata: { ...metadata, browserName: 'chromium', channel: 'msedge' }, testDir }] : [],],});