Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

chore(devtools): show tests (#39388)

Simon Knott5cbd81fc8cc5
diff --git a/packages/devtools/src/devtools.tsx b/packages/devtools/src/devtools.tsx
index 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 }) => {
<button
className='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.tsx
index 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.tsx
index 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.ts
index 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.IncomingMe
response.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.ts
index 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.ts
index 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 }] : [],
],
});