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
feat(cli): running with --debug=cli allows attaching and debugging over cli (#39717)
Dmitry Gozmanf48cd254d32c
diff --git a/packages/playwright-core/src/server/debugger.ts b/packages/playwright-core/src/server/debugger.tsindex 63e2735802..a28d45e351 100644--- a/packages/playwright-core/src/server/debugger.ts+++ b/packages/playwright-core/src/server/debugger.ts@@ -29,6 +29,7 @@ export class Debugger extends SdkObject implements InstrumentationListener {private _pauseAt: PauseAt = {};private _pausedCallsMetadata = new Map<CallMetadata, { resolve: () => void, sdkObject: SdkObject }>();private _enabled = false;+ private _pauseBeforeInputActions = false; // instead of inside input actionsprivate _context: BrowserContext;static Events = {@@ -54,7 +55,7 @@ export class Debugger extends SdkObject implements InstrumentationListener {if (this._muted)return;const pauseOnPauseCall = this._enabled && metadata.method === 'pause';- const pauseOnNextStep = !!this._pauseAt.next && shouldPauseBeforeStep(metadata);+ const pauseOnNextStep = !!this._pauseAt.next && shouldPauseBeforeStep(metadata, this._pauseBeforeInputActions);const pauseOnLocation = !!this._pauseAt.location && matchesLocation(metadata, this._pauseAt.location);if (pauseOnPauseCall || pauseOnNextStep || pauseOnLocation)await this._pause(sdkObject, metadata);@@ -63,9 +64,7 @@ export class Debugger extends SdkObject implements InstrumentationListener {async onBeforeInputAction(sdkObject: SdkObject, metadata: CallMetadata): Promise<void> {if (this._muted)return;- const pauseOnNextStep = !!this._pauseAt.next;- const pauseOnLocation = !!this._pauseAt.location && matchesLocation(metadata, this._pauseAt.location);- if (pauseOnNextStep || pauseOnLocation)+ if (!!this._pauseAt.next && !this._pauseBeforeInputActions)await this._pause(sdkObject, metadata);}@@ -94,6 +93,10 @@ export class Debugger extends SdkObject implements InstrumentationListener {this.emit(Debugger.Events.PausedStateChanged);}+ setPauseBeforeInputActions() {+ this._pauseBeforeInputActions = true;+ }+setPauseAt(at: { next?: boolean, location?: { file: string, line?: number, column?: number } } = {}) {this._enabled = true;this._pauseAt = at;@@ -114,14 +117,14 @@ export class Debugger extends SdkObject implements InstrumentationListener {}function matchesLocation(metadata: CallMetadata, location: { file: string, line?: number, column?: number }): boolean {- return metadata.location?.file === location.file &&+ return !!metadata.location?.file.includes(location.file) &&(location.line === undefined || metadata.location.line === location.line) &&(location.column === undefined || metadata.location.column === location.column);}-function shouldPauseBeforeStep(metadata: CallMetadata): boolean {+function shouldPauseBeforeStep(metadata: CallMetadata, includeInputActions: boolean): boolean {if (metadata.internal)return false;const metainfo = methodMetainfo.get(metadata.type + '.' + metadata.method);- return !!metainfo?.pausesBeforeAction;+ return !!metainfo?.pausesBeforeAction || (includeInputActions && !!metainfo?.pausesBeforeInput);}diff --git a/packages/playwright-core/src/server/dispatchers/debuggerDispatcher.ts b/packages/playwright-core/src/server/dispatchers/debuggerDispatcher.tsindex e6aee360fe..2cfc43fe8f 100644--- a/packages/playwright-core/src/server/dispatchers/debuggerDispatcher.ts+++ b/packages/playwright-core/src/server/dispatchers/debuggerDispatcher.ts@@ -36,6 +36,7 @@ export class DebuggerDispatcher extends Dispatcher<Debugger, channels.DebuggerChthis.addObjectListener(Debugger.Events.PausedStateChanged, () => {this._dispatchEvent('pausedStateChanged', { pausedDetails: this._serializePausedDetails() });});+ this._dispatchEvent('pausedStateChanged', { pausedDetails: this._serializePausedDetails() });}private _serializePausedDetails(): channels.DebuggerPausedStateChangedEvent['pausedDetails'] {@@ -50,6 +51,7 @@ export class DebuggerDispatcher extends Dispatcher<Debugger, channels.DebuggerCh}async setPauseAt(params: channels.DebuggerSetPauseAtParams, progress: Progress): Promise<void> {+ this._object.setPauseBeforeInputActions();this._object.setPauseAt(params);}diff --git a/packages/playwright-core/src/skill/references/playwright-tests.md b/packages/playwright-core/src/skill/references/playwright-tests.mdindex 1be8c70c24..47627c2a6a 100644--- a/packages/playwright-core/src/skill/references/playwright-tests.md+++ b/packages/playwright-core/src/skill/references/playwright-tests.md@@ -12,24 +12,28 @@ PLAYWRIGHT_HTML_OPEN=never npm run special-test-command# Debugging Playwright Tests-To debug a failing test, run it with Playwright as usual, but set `PWPAUSE=cli` environment variable. This command will pause the test at the point of failure, and print the debugging instructions.+To debug a failing Playwright test, run it with `--debug=cli` option. This command will pause the test at the start and print the debugging instructions.**IMPORTANT**: run the command in the background and check the output until "Debugging Instructions" is printed.-Once instructions are printed, use `playwright-cli` to explore the page. Debugging instructions include a browser name that should be used in `playwright-cli` to attach to the page under test.+Once instructions containing a session name are printed, use `playwright-cli` to attach the session and explore the page.```bash# Run the test-PLAYWRIGHT_HTML_OPEN=never PWPAUSE=cli npx playwright test+PLAYWRIGHT_HTML_OPEN=never npx playwright test --debug=cli+# ...+# ... debugging instructions for "tw-abcdef" session ...# ...-# Explore the page and interact if needed-playwright-cli --session=test open --attach=test-worker-abcdef-playwright-cli --session=test snapshot-playwright-cli --session=test click e14+# Attach to the test+playwright-cli attach tw-abcdef```-Keep the test running in the background while you explore and look for a fix. After fixing the test, stop the background test run.+Keep the test running in the background while you explore and look for a fix.+The test is paused at the start, so you should step over or pause at a particular location+where the problem is most likely to be.Every action you perform with `playwright-cli` generates corresponding Playwright TypeScript code.This code appears in the output and can be copied directly into the test. Most of the time, a specific locator or an expectation should be updated, but it could also be a bug in the app. Use your judgement.++After fixing the test, stop the background test run. Rerun to check that test passes.diff --git a/packages/playwright-core/src/tools/backend/context.ts b/packages/playwright-core/src/tools/backend/context.tsindex 7eb31ab09d..ca27bb4c52 100644--- a/packages/playwright-core/src/tools/backend/context.ts+++ b/packages/playwright-core/src/tools/backend/context.ts@@ -122,6 +122,10 @@ export class Context {await this.stopVideoRecording();}+ debugger() {+ return this._rawBrowserContext.debugger;+ }+tabs(): Tab[] {return this._tabs;}diff --git a/packages/playwright-core/src/tools/backend/devtools.ts b/packages/playwright-core/src/tools/backend/devtools.tsnew file mode 100644index 0000000000..7b61b0d021--- /dev/null+++ b/packages/playwright-core/src/tools/backend/devtools.ts@@ -0,0 +1,65 @@+/**+ * 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 { z } from '../../mcpBundle';+import { defineTool } from './tool';++const resume = defineTool({+ capability: 'devtools',++ schema: {+ name: 'browser_resume',+ title: 'Resume paused script execution',+ description: 'Resume script execution after it was paused. When called with step set to true, execution will pause again before the next action.',+ inputSchema: z.object({+ step: z.boolean().optional().describe('When true, execution will pause again before the next action, allowing step-by-step debugging.'),+ location: z.string().optional().describe('Pause execution at a specific <file>:<line>, e.g. "example.spec.ts:42".'),+ }),+ type: 'action',+ },++ handle: async (context, params, response) => {+ const browserContext = await context.ensureBrowserContext();+ const pausedPromise = new Promise<void>(resolve => {+ const listener = () => {+ if (browserContext.debugger.pausedDetails().length > 0) {+ browserContext.debugger.off('pausedstatechanged', listener);+ resolve();+ }+ };+ browserContext.debugger.on('pausedstatechanged', listener);+ });++ let location;+ if (params.location) {+ const [file, lineStr] = params.location.split(':');+ if (lineStr) {+ const line = Number(lineStr);+ if (isNaN(line))+ throw new Error(`Invalid location "${params.location}", expected format is <file>:<line>, e.g. "example.spec.ts:42"`);+ location = { file, line };+ } else {+ location = { file: params.location };+ }+ }++ await browserContext.debugger.setPauseAt({ next: !!params.step, location });+ await browserContext.debugger.resume();+ await pausedPromise;+ },+});++export default [resume];diff --git a/packages/playwright-core/src/tools/backend/response.ts b/packages/playwright-core/src/tools/backend/response.tsindex c360348138..d7de715ea8 100644--- a/packages/playwright-core/src/tools/backend/response.ts+++ b/packages/playwright-core/src/tools/backend/response.ts@@ -239,6 +239,14 @@ export class Response {}if (text.length)addSection('Events', text);++ const pausedDetails = this._context.debugger().pausedDetails();+ if (pausedDetails.length) {+ addSection('Paused', [+ ...pausedDetails.map(call => `- ${call.title} at ${this._computRelativeTo(call.location.file)}${call.location.line ? ':' + call.location.line : ''}`),+ '- Use any tools to explore and interact, resume by calling resume/step-over/pause-at',+ ]);+ }return sections;}}@@ -310,6 +318,7 @@ export function parseResponse(response: CallToolResult) {const snapshot = sections.get('Snapshot');const events = sections.get('Events');const modalState = sections.get('Modal state');+ const paused = sections.get('Paused');const codeNoFrame = code?.replace(/^```js\n/, '').replace(/\n```$/, '');const isError = response.isError;const attachments = response.content.length > 1 ? response.content.slice(1) : undefined;@@ -323,6 +332,7 @@ export function parseResponse(response: CallToolResult) {snapshot,events,modalState,+ paused,isError,attachments,text,diff --git a/packages/playwright-core/src/tools/backend/tools.ts b/packages/playwright-core/src/tools/backend/tools.tsindex fe292bd35e..de8d3eda86 100644--- a/packages/playwright-core/src/tools/backend/tools.ts+++ b/packages/playwright-core/src/tools/backend/tools.ts@@ -20,6 +20,7 @@ import common from './common';import config from './config';import console from './console';import cookies from './cookies';+import devtools from './devtools';import dialogs from './dialogs';import evaluate from './evaluate';import files from './files';@@ -49,6 +50,7 @@ export const browserTools: Tool<any>[] = [...config,...console,...cookies,+ ...devtools,...dialogs,...evaluate,...files,diff --git a/packages/playwright-core/src/tools/cli-client/session.ts b/packages/playwright-core/src/tools/cli-client/session.tsindex 577b665a61..c8b2a475b3 100644--- a/packages/playwright-core/src/tools/cli-client/session.ts+++ b/packages/playwright-core/src/tools/cli-client/session.ts@@ -198,7 +198,7 @@ export class Session {if (cliArgs['attach']) {console.log(`### Session \`${sessionName}\` created, attached to \`${cliArgs['attach']}\`.`);- console.log(`Run commands with: playwright --session=${sessionName} <command>`);+ console.log(`Run commands with: playwright-cli --session=${sessionName} <command>`);} else {console.log(`### Browser \`${sessionName}\` opened with pid ${child.pid}.`);}diff --git a/packages/playwright-core/src/tools/cli-daemon/commands.ts b/packages/playwright-core/src/tools/cli-daemon/commands.tsindex f2325e36a5..f94a682d82 100644--- a/packages/playwright-core/src/tools/cli-daemon/commands.ts+++ b/packages/playwright-core/src/tools/cli-daemon/commands.ts@@ -815,6 +815,35 @@ const devtoolsShow = declareCommand({toolParams: () => ({}),});+const resume = declareCommand({+ name: 'resume',+ description: 'Resume the test execution',+ category: 'devtools',+ args: z.object({}),+ toolName: 'browser_resume',+ toolParams: ({ step }) => ({ step }),+});++const stepOver = declareCommand({+ name: 'step-over',+ description: 'Step over the next call in the test',+ category: 'devtools',+ args: z.object({}),+ toolName: 'browser_resume',+ toolParams: ({}) => ({ step: true }),+});++const pauseAt = declareCommand({+ name: 'pause-at',+ description: 'Run the test up to a specific location and pause there',+ category: 'devtools',+ args: z.object({+ location: z.string().describe('Location to pause at. Format is <file>:<line>, e.g. "example.spec.ts:42".'),+ }),+ toolName: 'browser_resume',+ toolParams: ({ location }) => ({ location }),+});+// Sessionsconst sessionList = declareCommand({@@ -992,6 +1021,9 @@ const commandsArray: AnyCommandSchema[] = [videoStart,videoStop,devtoolsShow,+ pauseAt,+ resume,+ stepOver,// session categorysessionList,diff --git a/packages/playwright/src/common/config.ts b/packages/playwright/src/common/config.tsindex 5447f2b2f5..a46d23ec54 100644--- a/packages/playwright/src/common/config.ts+++ b/packages/playwright/src/common/config.ts@@ -195,7 +195,7 @@ export class FullProjectInternal {snapshotDir: takeFirst(pathResolve(configDir, projectConfig.snapshotDir), pathResolve(configDir, config.snapshotDir), testDir),testIgnore: takeFirst(projectConfig.testIgnore, config.testIgnore, []),testMatch: takeFirst(projectConfig.testMatch, config.testMatch, '**/*.@(spec|test).{md,?(c|m)[jt]s?(x)}'),- timeout: takeFirst(configCLIOverrides.debug ? 0 : undefined, configCLIOverrides.timeout, projectConfig.timeout, config.timeout, defaultTimeout),+ timeout: takeFirst(configCLIOverrides.debug === 'inspector' ? 0 : undefined, configCLIOverrides.timeout, projectConfig.timeout, config.timeout, defaultTimeout),use: mergeObjects(config.use, projectConfig.use, configCLIOverrides.use),dependencies: projectConfig.dependencies || [],teardown: projectConfig.teardown,diff --git a/packages/playwright/src/common/ipc.ts b/packages/playwright/src/common/ipc.tsindex 21e465b9d7..e1774d2b91 100644--- a/packages/playwright/src/common/ipc.ts+++ b/packages/playwright/src/common/ipc.ts@@ -23,7 +23,7 @@ import type { ReporterDescription, TestInfoError, TestStatus } from '../../typesimport type { SerializedCompilationCache } from '../transform/compilationCache';export type ConfigCLIOverrides = {- debug?: boolean;+ debug?: 'inspector' | 'cli';failOnFlakyTests?: boolean;forbidOnly?: boolean;fullyParallel?: boolean;diff --git a/packages/playwright/src/index.ts b/packages/playwright/src/index.tsindex 06bf458ad9..3aa3db889a 100644--- a/packages/playwright/src/index.ts+++ b/packages/playwright/src/index.ts@@ -22,7 +22,7 @@ import { setBoxedStackPrefixes, createGuid, currentZone, debugMode, jsonStringifimport { buildErrorContext } from './errorContext';import { currentTestInfo } from './common/globals';import { rootTestType } from './common/testType';-import { createCustomMessageHandler, runDaemonForBrowser } from './mcp/test/browserBackend';+import { createCustomMessageHandler, runDaemonForContext } from './mcp/test/browserBackend';import type { Fixtures, PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions, ScreenshotMode, TestInfo, TestType, VideoMode } from '../types/test';import type { ContextReuseMode } from './common/config';@@ -444,7 +444,7 @@ const playwrightFixtures: Fixtures<TestFixtures, WorkerFixtures> = ({if (!_reuseContext) {const { context, close } = await _contextFactory();testInfo._onCustomMessageCallback = createCustomMessageHandler(testInfo, context);- testInfo._onDidFinishTestFunctionCallbacks.add(() => runDaemonForBrowser(testInfo, browser));+ await runDaemonForContext(testInfo, context);await use(context);await close();return;@@ -452,7 +452,7 @@ const playwrightFixtures: Fixtures<TestFixtures, WorkerFixtures> = ({const context = await browserImpl._wrapApiCall(() => browserImpl._newContextForReuse(), { internal: true });testInfo._onCustomMessageCallback = createCustomMessageHandler(testInfo, context);- testInfo._onDidFinishTestFunctionCallbacks.add(() => runDaemonForBrowser(testInfo, browser));+ await runDaemonForContext(testInfo, context);await use(context);const closeReason = testInfo.status === 'timedOut' ? 'Test timeout of ' + testInfo.timeout + 'ms exceeded.' : 'Test ended.';await browserImpl._wrapApiCall(() => browserImpl._disconnectFromReusedContext(closeReason), { internal: true });diff --git a/packages/playwright/src/mcp/test/browserBackend.ts b/packages/playwright/src/mcp/test/browserBackend.tsindex bbe38b2ae8..36b5cbeba4 100644--- a/packages/playwright/src/mcp/test/browserBackend.ts+++ b/packages/playwright/src/mcp/test/browserBackend.ts@@ -110,31 +110,21 @@ async function generatePausedMessage(testInfo: TestInfoImpl, context: playwrightreturn lines.join('\n');}-export async function runDaemonForBrowser(testInfo: TestInfoImpl, browser: playwright.Browser): Promise<void> {- if (process.env.PWPAUSE !== 'cli')- return;+export async function runDaemonForContext(testInfo: TestInfoImpl, context: playwright.BrowserContext) {+ if (testInfo._configInternal.configCLIOverrides.debug !== 'cli')+ return false;- const browserTitle = `test-worker-${createGuid().slice(0, 6)}`;- await (browser as Browser)._register(browserTitle, { workspaceDir: testInfo.project.testDir });-- const lines = [''];- if (testInfo.errors.length) {- lines.push(`### Paused on test error`);- for (const error of testInfo.errors)- lines.push(stripAnsiEscapes(error.message || ''));- } else {- lines.push(`### Paused at the end of the test`);- }- lines.push(- `### Debugging Instructions`,- `- Pick a session name, e.g. "test"`,- `- Run "playwright-cli --session=<name> open --attach=${browserTitle}" to attach to this page`,- `- Use "playwright-cli --session=<name>" to explore the page and fix the problem`,- `- Stop this test run when finished. Restart if needed.`,- ``,- );+ const sessionName = `tw-${createGuid().slice(0, 6)}`;+ await (context.browser() as Browser)._register(sessionName, { workspaceDir: testInfo.project.testDir });/* eslint-disable-next-line no-console */- console.log(lines.join('\n'));- await new Promise(() => {});+ console.log([+ `### The test is currently paused at the start`,+ ``,+ `### Debugging Instructions`,+ `- Run "playwright-cli attach ${sessionName}" to attach to this test`,+ ].join('\n'));++ await context.debugger.setPauseAt({ next: true });+ return true;}diff --git a/packages/playwright/src/program.ts b/packages/playwright/src/program.tsindex edeb679ed4..801c88bc98 100644--- a/packages/playwright/src/program.ts+++ b/packages/playwright/src/program.ts@@ -283,13 +283,20 @@ async function mergeReports(reportDir: string | undefined, opts: { [key: string]}function overridesFromOptions(options: { [key: string]: any }): ConfigCLIOverrides {+ if (options.ui) {+ options.debug = undefined;+ options.trace = undefined;+ }+const overrides: ConfigCLIOverrides = {+ debug: options.debug,failOnFlakyTests: options.failOnFlakyTests ? true : undefined,forbidOnly: options.forbidOnly ? true : undefined,fullyParallel: options.fullyParallel ? true : undefined,globalTimeout: options.globalTimeout ? parseInt(options.globalTimeout, 10) : undefined,maxFailures: options.x ? 1 : (options.maxFailures ? parseInt(options.maxFailures, 10) : undefined),outputDir: options.output ? path.resolve(process.cwd(), options.output) : undefined,+ pause: !!process.env.PWPAUSE,quiet: options.quiet ? options.quiet : undefined,repeatEach: options.repeatEach ? parseInt(options.repeatEach, 10) : undefined,retries: options.retries ? parseInt(options.retries, 10) : undefined,@@ -301,6 +308,9 @@ function overridesFromOptions(options: { [key: string]: any }): ConfigCLIOverridignoreSnapshots: options.ignoreSnapshots ? !!options.ignoreSnapshots : undefined,updateSnapshots: options.updateSnapshots,updateSourceMethod: options.updateSourceMethod,+ use: {+ trace: options.trace,+ },workers: options.workers,};@@ -317,23 +327,12 @@ function overridesFromOptions(options: { [key: string]: any }): ConfigCLIOverrid});}- if (options.headed || options.debug)- overrides.use = { headless: false };- if (!options.ui && options.debug) {- overrides.debug = true;+ if (options.headed)+ overrides.use.headless = false;+ if (options.debug === 'inspector') {+ overrides.use.headless = false;process.env.PWDEBUG = '1';}- if (!options.ui && options.trace) {- overrides.use = overrides.use || {};- overrides.use.trace = options.trace;- }- if (process.env.PWPAUSE === 'cli') {- overrides.timeout = 0;- overrides.use = overrides.use || {};- overrides.use.actionTimeout = 5000;- } else if (process.env.PWPAUSE) {- overrides.pause = true;- }if (overrides.tsconfig && !fs.existsSync(overrides.tsconfig))throw new Error(`--tsconfig "${options.tsconfig}" does not exist`);@@ -403,7 +402,7 @@ const kTraceModes: TraceMode[] = ['on', 'off', 'on-first-retry', 'on-all-retriesconst testOptions: [string, { description: string, choices?: string[], preset?: string }][] = [/* deprecated */ ['--browser <browser>', { description: `Browser to use for tests, one of "all", "chromium", "firefox" or "webkit" (default: "chromium")` }],['-c, --config <file>', { description: `Configuration file, or a test directory with optional "playwright.config.{m,c}?{js,ts}"` }],- ['--debug', { description: `Run tests with Playwright Inspector. Shortcut for "PWDEBUG=1" environment variable and "--timeout=0 --max-failures=1 --headed --workers=1" options` }],+ ['--debug [mode]', { description: `Run tests with Playwright Inspector. Shortcut for "PWDEBUG=1" environment variable and "--timeout=0 --max-failures=1 --headed --workers=1" options`, choices: ['inspector', 'cli'], preset: 'inspector' }],['--fail-on-flaky-tests', { description: `Fail if any test is flagged as flaky (default: false)` }],['--forbid-only', { description: `Fail if test.only is called (default: false)` }],['--fully-parallel', { description: `Run all tests in parallel (default: false)` }],diff --git a/packages/playwright/src/worker/testInfo.ts b/packages/playwright/src/worker/testInfo.tsindex 3dca10c7fa..cd2f2b880c 100644--- a/packages/playwright/src/worker/testInfo.ts+++ b/packages/playwright/src/worker/testInfo.ts@@ -201,7 +201,7 @@ export class TestInfoImpl implements TestInfo {this.expectedStatus = test?.expectedStatus ?? 'skipped';this._timeoutManager = new TimeoutManager(this.project.timeout);- if (configInternal.configCLIOverrides.debug)+ if (configInternal.configCLIOverrides.debug === 'inspector')this._setIgnoreTimeouts(true);this.outputDir = (() => {diff --git a/tests/library/debugger.spec.ts b/tests/library/debugger.spec.tsindex 0efd9d1f6a..65d460cc50 100644--- a/tests/library/debugger.spec.ts+++ b/tests/library/debugger.spec.ts@@ -73,7 +73,7 @@ it('should pause at location', async ({ context, server }) => {const line = +(() => { return new Error('').stack.match(/debugger.spec.ts:(\d+)/)[1]; })();// Note: careful with the line offset below.- await dbg.setPauseAt({ location: { file: __filename, line: line + 4 } });+ await dbg.setPauseAt({ location: { file: 'debugger.spec', line: line + 4 } });await page.content(); // should not pause hereconst clickPromise = page.click('div'); // should pause hereawait new Promise<void>(resolve => dbg.once('pausedstatechanged', resolve));diff --git a/tests/mcp/cli-session.spec.ts b/tests/mcp/cli-session.spec.tsindex 081099bd2e..e5292fc483 100644--- a/tests/mcp/cli-session.spec.ts+++ b/tests/mcp/cli-session.spec.ts@@ -306,7 +306,7 @@ workspace1:await page.setContent('<title>My Page</title>');const { output: openOutput } = await cli('attach', 'foobar');expect(openOutput).toContain('### Session `foobar` created, attached to `foobar`.');- expect(openOutput).toContain('Run commands with: playwright --session=foobar <command>');+ expect(openOutput).toContain('Run commands with: playwright-cli --session=foobar <command>');const { output: listOutput } = await cli('list', '--all');expect(listOutput).toBe(`### Browsers/:@@ -353,7 +353,7 @@ workspace1:await page.setContent('<title>Alias Page</title>');const { output: openOutput } = await cli('attach', 'foobar', '--session=mybrowser');expect(openOutput).toContain('### Session `mybrowser` created, attached to `foobar`.');- expect(openOutput).toContain('Run commands with: playwright --session=mybrowser <command>');+ expect(openOutput).toContain('Run commands with: playwright-cli --session=mybrowser <command>');await cli('-s', 'mybrowser', 'close');});diff --git a/tests/mcp/cli-test.spec.ts b/tests/mcp/cli-test.spec.tsindex 05dbd653a0..74c762ccec 100644--- a/tests/mcp/cli-test.spec.ts+++ b/tests/mcp/cli-test.spec.ts@@ -20,44 +20,55 @@ import { writeFiles } from './fixtures';const testEntrypoint = path.join(__dirname, '../../packages/playwright-test/cli.js');-test.skip('debug test and snapshot', async ({ cliEnv, cli, childProcess }) => {+test('debug test and snapshot', async ({ cliEnv, cli, childProcess }) => {await writeFiles({'subdir/a.test.ts': `import { test, expect } from '@playwright/test';test('example test', async ({ page }) => {await page.setContent('<title>My Page</title><body><button>Submit</button></body>');- await expect(page.getByRole('button', { name: 'Missing' })).toBeVisible({ timeout: 1000 });+ await expect(page.getByRole('button', { name: 'Submit' })).toBeVisible();+ await page.setContent('<title>My Page</title><body><button>Close</button></body>');+ await expect(page.getByRole('button', { name: 'Close' })).toBeVisible();});`,});const testProcess = childProcess({- command: [process.argv[0], testEntrypoint, 'test'],+ command: [process.argv[0], testEntrypoint, 'test', '--debug=cli'],cwd: test.info().outputPath('subdir'),- env: { PWPAUSE: 'cli', ...cliEnv },+ env: cliEnv,});- await testProcess.waitForOutput('playwright-cli --session=<name> open --attach=test-worker');+ await testProcess.waitForOutput('playwright-cli attach');- const match = testProcess.output.match(/--attach=([a-zA-Z0-9-_]+)/);- const browserName = match[1];+ const match = testProcess.output.match(/attach ([a-zA-Z0-9-_]+)/);+ const session = match[1];- const { output: openOutput } = await cli('open', `--session=test-session`, `--attach=${browserName}`);- expect(openOutput).toContain('My Page');+ const { output: listOutput1 } = await cli('list', '--all');+ expect(listOutput1).toContain('subdir');+ expect(listOutput1).toContain(`browser "${session}"`);- const listResult1 = await cli('list', '--all');- expect(listResult1.exitCode).toBe(0);- expect(listResult1.output).toContain('test-session');- expect(listResult1.output).toContain('subdir');- expect(listResult1.output).toContain(`browser "${browserName}"`);+ const { output: attachOutput } = await cli('attach', session);+ expect(attachOutput).toContain('### Paused');+ expect(attachOutput).toContain(`- Set content at subdir${path.sep}a.test.ts:4`);- const snapshotResult = await cli(`--session=test-session`, 'snapshot');- expect(snapshotResult.exitCode).toBe(0);+ const { output: listOutput2 } = await cli('list', '--all');+ expect(listOutput2).toContain('/');+ expect(listOutput2).toContain(`- ${session}`);++ const { output: stepOutput } = await cli(`--session=${session}`, 'step-over');+ expect(stepOutput).toContain('### Paused');+ expect(stepOutput).toContain(`- Expect "toBeVisible" at subdir${path.sep}a.test.ts:5`);++ const snapshotResult = await cli(`--session=${session}`, 'snapshot');expect(snapshotResult.snapshot).toContain('button "Submit"');- await testProcess.kill('SIGINT');+ const { output: pauseAtOutput } = await cli(`--session=${session}`, 'pause-at', 'a.test.ts:7');+ expect(pauseAtOutput).toContain('### Paused');+ expect(pauseAtOutput).toContain(`- Expect "toBeVisible" at subdir${path.sep}a.test.ts:7`);++ await cli(`--session=${session}`, 'resume');- const listResult2 = await cli('list');- expect(listResult2.exitCode).toBe(0);- expect(listResult2.output).toContain('(no browsers)');+ const { output: listOutput3 } = await cli('list');+ expect(listOutput3).toContain('(no browsers)');});