playwright-mcp/tests/core.spec.ts

/**
 * 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 './fixtures.js';

test('browser_navigate', async ({ client, server }) => {
  expect(await client.callTool({
    name: 'browser_navigate',
    arguments: { url: server.HELLO_WORLD },
  })).toHaveTextContent(`
- Ran Playwright code:
\`\`\`js
// Navigate to ${server.HELLO_WORLD}
await page.goto('${server.HELLO_WORLD}');
\`\`\`

- Page URL: ${server.HELLO_WORLD}
- Page Title: Title
- Page Snapshot
\`\`\`yaml
- generic [ref=e1]: Hello, world!
\`\`\`
`
  );
});

test('browser_click', async ({ client, server }) => {
  server.setContent('/', `
    <title>Title</title>
    <button>Submit</button>
  `, 'text/html');

  await client.callTool({
    name: 'browser_navigate',
    arguments: { url: server.PREFIX },
  });

  expect(await client.callTool({
    name: 'browser_click',
    arguments: {
      element: 'Submit button',
      ref: 'e2',
    },
  })).toHaveTextContent(`
- Ran Playwright code:
\`\`\`js
// Click Submit button
await page.getByRole('button', { name: 'Submit' }).click();
\`\`\`

- Page URL: ${server.PREFIX}
- Page Title: Title
- Page Snapshot
\`\`\`yaml
- button "Submit" [ref=e2]
\`\`\`
`);
});

test('browser_select_option', async ({ client, server }) => {
  server.setContent('/', `
    <title>Title</title>
    <select>
      <option value="foo">Foo</option>
      <option value="bar">Bar</option>
    </select>
  `, 'text/html');

  await client.callTool({
    name: 'browser_navigate',
    arguments: { url: server.PREFIX },
  });

  expect(await client.callTool({
    name: 'browser_select_option',
    arguments: {
      element: 'Select',
      ref: 'e2',
      values: ['bar'],
    },
  })).toHaveTextContent(`
- Ran Playwright code:
\`\`\`js
// Select options [bar] in Select
await page.getByRole('combobox').selectOption(['bar']);
\`\`\`

- Page URL: ${server.PREFIX}
- Page Title: Title
- Page Snapshot
\`\`\`yaml
- combobox [ref=e2]:
  - option "Foo"
  - option "Bar" [selected]
\`\`\`
`);
});

test('browser_select_option (multiple)', async ({ client, server }) => {
  server.setContent('/', `
    <title>Title</title>
    <select multiple>
      <option value="foo">Foo</option>
      <option value="bar">Bar</option>
      <option value="baz">Baz</option>
    </select>
  `, 'text/html');

  await client.callTool({
    name: 'browser_navigate',
    arguments: { url: server.PREFIX },
  });

  expect(await client.callTool({
    name: 'browser_select_option',
    arguments: {
      element: 'Select',
      ref: 'e2',
      values: ['bar', 'baz'],
    },
  })).toHaveTextContent(`
- Ran Playwright code:
\`\`\`js
// Select options [bar, baz] in Select
await page.getByRole('listbox').selectOption(['bar', 'baz']);
\`\`\`

- Page URL: ${server.PREFIX}
- Page Title: Title
- Page Snapshot
\`\`\`yaml
- listbox [ref=e2]:
  - option "Foo" [ref=e3]
  - option "Bar" [selected] [ref=e4]
  - option "Baz" [selected] [ref=e5]
\`\`\`
`);
});

test('browser_type', async ({ client, server }) => {
  server.setContent('/', `
    <!DOCTYPE html>
    <html>
      <input type='keypress' onkeypress="console.log('Key pressed:', event.key, ', Text:', event.target.value)"></input>
    </html>
  `, 'text/html');

  await client.callTool({
    name: 'browser_navigate',
    arguments: {
      url: server.PREFIX,
    },
  });
  await client.callTool({
    name: 'browser_type',
    arguments: {
      element: 'textbox',
      ref: 'e2',
      text: 'Hi!',
      submit: true,
    },
  });
  expect(await client.callTool({
    name: 'browser_console_messages',
  })).toHaveTextContent('[LOG] Key pressed: Enter , Text: Hi!');
});

test('browser_type (slowly)', async ({ client, server }) => {
  server.setContent('/', `
    <input type='text' onkeydown="console.log('Key pressed:', event.key, 'Text:', event.target.value)"></input>
  `, 'text/html');

  await client.callTool({
    name: 'browser_navigate',
    arguments: {
      url: server.PREFIX,
    },
  });
  await client.callTool({
    name: 'browser_type',
    arguments: {
      element: 'textbox',
      ref: 'e2',
      text: 'Hi!',
      submit: true,
      slowly: true,
    },
  });
  expect(await client.callTool({
    name: 'browser_console_messages',
  })).toHaveTextContent([
    '[LOG] Key pressed: H Text: ',
    '[LOG] Key pressed: i Text: H',
    '[LOG] Key pressed: ! Text: Hi',
    '[LOG] Key pressed: Enter Text: Hi!',
  ].join('\n'));
});

test('browser_resize', async ({ client, server }) => {
  server.setContent('/', `
    <title>Resize Test</title>
    <body>
      <div id="size">Waiting for resize...</div>
      <script>new ResizeObserver(() => { document.getElementById("size").textContent = \`Window size: \${window.innerWidth}x\${window.innerHeight}\`; }).observe(document.body);
      </script>
    </body>
  `, 'text/html');
  await client.callTool({
    name: 'browser_navigate',
    arguments: { url: server.PREFIX },
  });

  const response = await client.callTool({
    name: 'browser_resize',
    arguments: {
      width: 390,
      height: 780,
    },
  });
  expect(response).toContainTextContent(`- Ran Playwright code:
\`\`\`js
// Resize browser window to 390x780
await page.setViewportSize({ width: 390, height: 780 });
\`\`\``);
  await expect.poll(() => client.callTool({ name: 'browser_snapshot' })).toContainTextContent('Window size: 390x780');
});
chore: initial code commit 2025-03-21 10:58:58 -07:00			`/**`
			`* 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.`
			`*/`

chore: migrate to ESM (#303) - [Why do I need `.js` extension?](https://stackoverflow.com/a/77150985/6512681) - [Why setting `rootDir` in the `tsconfig.json`?](https://stackoverflow.com/a/58941798/6512681) - [How to ensure that we add the `.js` extension via ESLint](https://github.com/import-js/eslint-plugin-import/blob/main/docs/rules/extensions.md#importextensions) Fixes https://github.com/microsoft/playwright-mcp/issues/302 2025-04-30 23:06:56 +02:00			`import { test, expect } from './fixtures.js';`
chore: initial code commit 2025-03-21 10:58:58 -07:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`test('browser_navigate', async ({ client, server }) => {`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`expect(await client.callTool({`
			`name: 'browser_navigate',`
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`arguments: { url: server.HELLO_WORLD },`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			})).toHaveTextContent(`
chore: include "playwright" keyword, add examples (#196) 2025-04-16 17:18:40 +02:00			`- Ran Playwright code:`
chore: generalize status & action as code (#188) 2025-04-15 12:54:45 -07:00			\`\`\`js
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`// Navigate to ${server.HELLO_WORLD}`
			`await page.goto('${server.HELLO_WORLD}');`
chore: generalize status & action as code (#188) 2025-04-15 12:54:45 -07:00			\`\`\`
feat: respond with action and generated locator (#181) Closes https://github.com/microsoft/playwright-mcp/issues/163 2025-04-15 19:55:20 +02:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`- Page URL: ${server.HELLO_WORLD}`
chore: initial code commit 2025-03-21 10:58:58 -07:00			`- Page Title: Title`
			`- Page Snapshot`
			\`\`\`yaml
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`- generic [ref=e1]: Hello, world!`
chore: initial code commit 2025-03-21 10:58:58 -07:00			\`\`\`
chore: refactor tests (#61) 2025-03-27 23:47:15 +01:00			`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`);`
chore: initial code commit 2025-03-21 10:58:58 -07:00			`});`

chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`test('browser_click', async ({ client, server }) => {`
			server.setContent('/', `
			`<title>Title</title>`
			`<button>Submit</button>`
			`, 'text/html');

chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`await client.callTool({`
			`name: 'browser_navigate',`
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`arguments: { url: server.PREFIX },`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`});`
chore: initial code commit 2025-03-21 10:58:58 -07:00
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`expect(await client.callTool({`
			`name: 'browser_click',`
			`arguments: {`
			`element: 'Submit button',`
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`ref: 'e2',`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`},`
feat: respond with action and generated locator (#181) Closes https://github.com/microsoft/playwright-mcp/issues/163 2025-04-15 19:55:20 +02:00			})).toHaveTextContent(`
chore: include "playwright" keyword, add examples (#196) 2025-04-16 17:18:40 +02:00			`- Ran Playwright code:`
chore: generalize status & action as code (#188) 2025-04-15 12:54:45 -07:00			\`\`\`js
			`// Click Submit button`
			`await page.getByRole('button', { name: 'Submit' }).click();`
			\`\`\`
chore: initial code commit 2025-03-21 10:58:58 -07:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`- Page URL: ${server.PREFIX}`
chore: initial code commit 2025-03-21 10:58:58 -07:00			`- Page Title: Title`
			`- Page Snapshot`
			\`\`\`yaml
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`- button "Submit" [ref=e2]`
chore: initial code commit 2025-03-21 10:58:58 -07:00			\`\`\`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`);
chore: initial code commit 2025-03-21 10:58:58 -07:00			`});`
chore: restart browser if page closed manually (#19) Fixes https://github.com/microsoft/playwright-mcp/issues/18 2025-03-25 13:05:28 -07:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`test('browser_select_option', async ({ client, server }) => {`
			server.setContent('/', `
			`<title>Title</title>`
			`<select>`
			`<option value="foo">Foo</option>`
			`<option value="bar">Bar</option>`
			`</select>`
			`, 'text/html');

chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`await client.callTool({`
			`name: 'browser_navigate',`
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`arguments: { url: server.PREFIX },`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`});`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`expect(await client.callTool({`
			`name: 'browser_select_option',`
			`arguments: {`
			`element: 'Select',`
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`ref: 'e2',`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`values: ['bar'],`
			`},`
feat: respond with action and generated locator (#181) Closes https://github.com/microsoft/playwright-mcp/issues/163 2025-04-15 19:55:20 +02:00			})).toHaveTextContent(`
chore: include "playwright" keyword, add examples (#196) 2025-04-16 17:18:40 +02:00			`- Ran Playwright code:`
chore: generalize status & action as code (#188) 2025-04-15 12:54:45 -07:00			\`\`\`js
			`// Select options [bar] in Select`
			`await page.getByRole('combobox').selectOption(['bar']);`
			\`\`\`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`- Page URL: ${server.PREFIX}`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00			`- Page Title: Title`
			`- Page Snapshot`
			\`\`\`yaml
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`- combobox [ref=e2]:`
chore: roll playwright to 1745357020000 (#249) 2025-04-22 16:04:50 -07:00			`- option "Foo"`
			`- option "Bar" [selected]`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00			\`\`\`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`);
			`});`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`test('browser_select_option (multiple)', async ({ client, server }) => {`
			server.setContent('/', `
			`<title>Title</title>`
			`<select multiple>`
			`<option value="foo">Foo</option>`
			`<option value="bar">Bar</option>`
			`<option value="baz">Baz</option>`
			`</select>`
			`, 'text/html');

chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`await client.callTool({`
			`name: 'browser_navigate',`
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`arguments: { url: server.PREFIX },`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`});`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`expect(await client.callTool({`
			`name: 'browser_select_option',`
			`arguments: {`
			`element: 'Select',`
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`ref: 'e2',`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`values: ['bar', 'baz'],`
			`},`
feat: respond with action and generated locator (#181) Closes https://github.com/microsoft/playwright-mcp/issues/163 2025-04-15 19:55:20 +02:00			})).toHaveTextContent(`
chore: include "playwright" keyword, add examples (#196) 2025-04-16 17:18:40 +02:00			`- Ran Playwright code:`
chore: generalize status & action as code (#188) 2025-04-15 12:54:45 -07:00			\`\`\`js
			`// Select options [bar, baz] in Select`
			`await page.getByRole('listbox').selectOption(['bar', 'baz']);`
			\`\`\`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`- Page URL: ${server.PREFIX}`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00			`- Page Title: Title`
			`- Page Snapshot`
			\`\`\`yaml
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`- listbox [ref=e2]:`
			`- option "Foo" [ref=e3]`
			`- option "Bar" [selected] [ref=e4]`
			`- option "Baz" [selected] [ref=e5]`
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00			\`\`\`
chore: refactor tests for real 2025-03-27 16:50:43 -07:00			`);
feat(tool): add `locator.selectOption()` action (#25) Implemented `locator.selectOption` 2025-03-26 13:53:56 +09:00			`});`
browser://console should be single resource (#34) Returning one resource per log line is flooding the Claude UI: <img width="1061" alt="Screenshot 2025-03-19 at 16 01 45" src="https://github.com/user-attachments/assets/1779374e-6b9d-44d7-b916-c521933e1085" /> Returning one big resource with all lines feels better. original PR: https://github.com/microsoft/playwright/pull/35276 2025-03-26 16:27:55 +01:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`test('browser_type', async ({ client, server }) => {`
			server.setContent('/', `
			`<!DOCTYPE html>`
			`<html>`
			`<input type='keypress' onkeypress="console.log('Key pressed:', event.key, ', Text:', event.target.value)"></input>`
			`</html>`
			`, 'text/html');

feat: add slowly option for typing one character at a time (#121) 2025-04-02 14:36:30 -07:00			`await client.callTool({`
			`name: 'browser_navigate',`
			`arguments: {`
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`url: server.PREFIX,`
feat: add slowly option for typing one character at a time (#121) 2025-04-02 14:36:30 -07:00			`},`
			`});`
			`await client.callTool({`
			`name: 'browser_type',`
			`arguments: {`
			`element: 'textbox',`
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`ref: 'e2',`
feat: add slowly option for typing one character at a time (#121) 2025-04-02 14:36:30 -07:00			`text: 'Hi!',`
			`submit: true,`
			`},`
			`});`
chore: convert console resource to tool (#193) 2025-04-15 18:01:59 -07:00			`expect(await client.callTool({`
			`name: 'browser_console_messages',`
			`})).toHaveTextContent('[LOG] Key pressed: Enter , Text: Hi!');`
feat: add slowly option for typing one character at a time (#121) 2025-04-02 14:36:30 -07:00			`});`

chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`test('browser_type (slowly)', async ({ client, server }) => {`
			server.setContent('/', `
			`<input type='text' onkeydown="console.log('Key pressed:', event.key, 'Text:', event.target.value)"></input>`
			`, 'text/html');

feat: add slowly option for typing one character at a time (#121) 2025-04-02 14:36:30 -07:00			`await client.callTool({`
			`name: 'browser_navigate',`
			`arguments: {`
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`url: server.PREFIX,`
feat: add slowly option for typing one character at a time (#121) 2025-04-02 14:36:30 -07:00			`},`
			`});`
			`await client.callTool({`
			`name: 'browser_type',`
			`arguments: {`
			`element: 'textbox',`
chore: roll playwright 5/9 (#394) 2025-05-09 18:01:17 -07:00			`ref: 'e2',`
feat: add slowly option for typing one character at a time (#121) 2025-04-02 14:36:30 -07:00			`text: 'Hi!',`
			`submit: true,`
			`slowly: true,`
			`},`
			`});`
chore: convert console resource to tool (#193) 2025-04-15 18:01:59 -07:00			`expect(await client.callTool({`
			`name: 'browser_console_messages',`
			`})).toHaveTextContent([`
			`'[LOG] Key pressed: H Text: ',`
			`'[LOG] Key pressed: i Text: H',`
			`'[LOG] Key pressed: ! Text: Hi',`
			`'[LOG] Key pressed: Enter Text: Hi!',`
			`].join('\n'));`
feat: add slowly option for typing one character at a time (#121) 2025-04-02 14:36:30 -07:00			`});`
feat: browser_resize (#92) 2025-04-15 01:09:48 +02:00
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`test('browser_resize', async ({ client, server }) => {`
			server.setContent('/', `
			`<title>Resize Test</title>`
			`<body>`
			`<div id="size">Waiting for resize...</div>`
			<script>new ResizeObserver(() => { document.getElementById("size").textContent = \`Window size: \${window.innerWidth}x\${window.innerHeight}\`; }).observe(document.body);
			`</script>`
			`</body>`
			`, 'text/html');
feat: browser_resize (#92) 2025-04-15 01:09:48 +02:00			`await client.callTool({`
			`name: 'browser_navigate',`
chore: only reset network log upon explicit navigation (#377) Fixes https://github.com/microsoft/playwright-mcp/issues/376 2025-05-08 17:02:09 -07:00			`arguments: { url: server.PREFIX },`
feat: browser_resize (#92) 2025-04-15 01:09:48 +02:00			`});`

			`const response = await client.callTool({`
			`name: 'browser_resize',`
			`arguments: {`
			`width: 390,`
			`height: 780,`
			`},`
			`});`
chore: include "playwright" keyword, add examples (#196) 2025-04-16 17:18:40 +02:00			expect(response).toContainTextContent(`- Ran Playwright code:
chore: generalize status & action as code (#188) 2025-04-15 12:54:45 -07:00			\`\`\`js
			`// Resize browser window to 390x780`
			`await page.setViewportSize({ width: 390, height: 780 });`
			\`\`\``);
chore: account for undefined arguments (#400) 2025-05-12 09:35:33 -07:00			`await expect.poll(() => client.callTool({ name: 'browser_snapshot' })).toContainTextContent('Window size: 390x780');`
feat: browser_resize (#92) 2025-04-15 01:09:48 +02:00			`});`