Aller au contenu
verdict:

Playwright 1.64.0

featured

Notes de version

note: la synthèse et les notes de version sont en anglais

warning: action requise

4 breaking changes5 points clés

Adds WebMCP tool testing, custom video frame rates, and Locator.within(), with a few breaking changes to review.

synthèse · uniquement d’après les notes de version · claude-haiku-5-5 · prompt v7

breaking changestous cités, chacun avec un correctif

breaking[1]: Device descriptors now forward screen, so window.screen and media queries see the emulated screen size.

release-notes:148
screen property is now forwarded from the device descriptors. If you use ...devices['Desktop Chrome'] and alike, window.screen and media queries now see the emulated screen size. You can opt-out by explicitly setting screen to undefined:

help: Set screen: undefined in use to opt out of the forwarded screen size.

breaking[2]: JSX in test files now follows the jsx and related options in tsconfig.json, defaulting to the automatic runtime from react/jsx-runtime.

release-notes:160
JSX in your test files now follows your tsconfig.json. Playwright compiles JSX in test files according to the jsx, jsxFactory, jsxFragmentFactory and jsxImportSource tsconfig options, and defaults to the automatic runtime from react/jsx-runtime.

help: Check the jsx, jsxFactory, jsxFragmentFactory and jsxImportSource options in your tsconfig.json.

breaking[3]: --update-snapshots=missing now passes the test run when tests only create missing snapshots, and the unspecified mode is renamed 'default'.

release-notes:161
--update-snapshots=missing now passes the test run. Tests that only create missing snapshots now pass in the 'missing' mode of testConfig.updateSnapshots, so that CI can generate new snapshots and verify the existing ones in a single run. The mode used when the option is not specified is now called 'default' and behaves as before: missing snapshots are written and the test fails.

help: Use the 'missing' mode in CI when you want new snapshots generated and existing ones verified in one run; the 'default' mode writes missing snapshots and fails the test as before.

breaking[4]: Elements inside an iframe that is not visible are now considered hidden by actions, locator.isVisible() and toBeVisible().

release-notes:162
Elements inside hidden iframes are considered hidden. Elements inside an iframe that is not visible, for example with visibility: hidden, are now considered hidden by actions, locator.isVisible() and expect(locator).toBeVisible().

help: Check tests that interact with elements inside hidden iframes, since those actions and assertions now treat them as hidden.

points clés

release-notesgithub.com/microsoft/playwright · 171 lignes
  1. ## 🧰 WebMCP
  3. New [page.webmcp](https://playwright.dev/docs/api/class-page#page-webmcp) and [frame.webmcp](https://playwright.dev/docs/api/class-frame#frame-webmcp) give access to the tools that a page registers through the experimental [WebMCP](https://playwright.dev/docs/api/class-webmcp) browser API, so you can test them like any other part of your app:
  5. ```js
  6. const browser = await chromium.launch({ args: ['--enable-features=WebMCP'] });
  7. const page = await browser.newPage();
  8. await page.goto('https://example.com');
  10. for (const tool of await page.webmcp.tools())
  11. console.log(tool.name, tool.description);
  13. const result = await page.webmcp.callTool('add', { a: 2, b: 40 });
  14. console.log(result.content[0].text); // "42"
  15. ```
  17. [Playwright MCP](https://playwright.dev/docs/getting-started-mcp) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
  19. [`playwright-cli`](https://playwright.dev/docs/getting-started-cli) exposes them as well:
  21. ```bash
  22. playwright-cli webmcp-list
  23. playwright-cli webmcp-call search_catalog --params '{"query":"cats"}'
  24. ```
  26. ## 🎬 Better videos
  28. Videos can now be recorded at a custom frame rate, and the decorations for actions are styled with plain CSS:
  30. ```js
  31. // playwright.config.ts
  32. import { defineConfig } from '@playwright/test';
  34. export default defineConfig({
  35. use: {
  36. video: {
  37. mode: 'on',
  38. size: { width: 1920, height: 1080 },
  39. fps: 60,
  40. show: {
  41. actions: {
  42. style: {
  43. point: 'width: 20px; height: 20px; border-radius: 50%; background: red',
  44. highlight: 'outline: 2px solid #333; background: rgba(0, 128, 255, .15)',
  45. title: 'font-size: 16px',
  46. },
  47. },
  48. },
  49. },
  50. },
  51. });
  52. ```
  54. - New `fps` option in [testOptions.video](https://playwright.dev/docs/api/class-testoptions#test-options-video), [`recordVideo`](https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-video) and
  55. [screencast.start()](https://playwright.dev/docs/api/class-screencast#screencast-start). Firefox and WebKit currently capture up to 25 frames per second.
  56. - New [`style`](https://playwright.dev/docs/api/class-screencast#screencast-show-actions-option-style) option takes CSS declarations for the `point` marker, the target
  57. `highlight` and the action `title`. It replaces the `fontSize` option, which is now deprecated.
  58. - The cursor stays visible at the last action point, survives navigations and travels along a natural, eased path.
  59. - Videos are encoded with VP9 instead of VP8, which takes less CPU and produces smaller files of the same or better
  60. quality.
  61. - All video options are also available in [Playwright MCP](https://playwright.dev/docs/getting-started-mcp) and [`playwright-cli`](https://playwright.dev/docs/getting-started-cli).
  63. ## 🎯 Test runner
  64. - New [testProject.default](https://playwright.dev/docs/api/class-testproject#test-project-default) option keeps a project in the config without running it by default. You can configure every browser you care about, and let a plain `npx playwright test` run just your favourite one:
  66. ```js
  67. // playwright.config.ts
  68. import { defineConfig, devices } from '@playwright/test';
  70. export default defineConfig({
  71. projects: [
  72. { name: 'chromium', use: devices['Desktop Chrome'] },
  73. { name: 'firefox', use: devices['Desktop Firefox'], default: false },
  74. { name: 'webkit', use: devices['Desktop Safari'], default: false },
  75. ],
  76. });
  77. ```
  79. ```bash
  80. npx playwright test # runs chromium only
  81. npx playwright test --project=firefox # runs firefox
  82. npx playwright test --project="*" # runs all three, for example on CI
  83. ```
  85. - New `--shuffle` command line option schedules tests in a random order, which helps to find tests that accidentally depend on each other.
  87. ```bash
  88. npx playwright test --shuffle
  89. # Running 42 tests using 4 workers, shuffle seed 271828182
  90. # ...
  92. # Pass the seed to reproduce the same order.
  93. npx playwright test --shuffle 271828182
  94. ```
  96. - New `lock` option in [test.describe.configure()](https://playwright.dev/docs/api/class-test#test-describe-configure) adds [test locks](https://playwright.dev/docs/test-parallel#test-locks) to all tests in a file or a group:
  98. ```js
  99. test.describe.configure({ lock: 'user-settings' });
  100. ```
  102. - New `type` option of `toHaveScreenshot` in [testConfig.expect](https://playwright.dev/docs/api/class-testconfig#test-config-expect) stores all unnamed screenshots as WebP:
  104. ```js
  105. // playwright.config.ts
  106. export default defineConfig({
  107. expect: {
  108. toHaveScreenshot: { type: 'webp' },
  109. },
  110. });
  111. ```
  113. ## 🪆 Locator.within()
  115. New [locator.within()](https://playwright.dev/docs/api/class-locator#locator-within) combines two locators that you already have, reading in the natural order —
  116. "this button, within that dialog":
  118. ```js
  119. const saveButton = page.getByRole('button', { name: 'Save' });
  120. const dialog = page.getByTestId('settings-dialog');
  122. await saveButton.within(dialog).click();
  123. ```
  125. Relative locators such as [locator.nth()](https://playwright.dev/docs/api/class-locator#locator-nth) or [locator.first()](https://playwright.dev/docs/api/class-locator#locator-first) are resolved inside each parent
  126. separately, which makes column-like queries straightforward:
  128. ```js
  129. // The third cell of every row, not the third cell in the table.
  130. const thirdColumn = page.getByRole('cell').nth(2).within(page.getByRole('row'));
  131. await expect(thirdColumn).toHaveText(['Apple', 'Banana', 'Cherry']);
  132. ```
  134. ## New APIs
  135. - New [page.getByRef()](https://playwright.dev/docs/api/class-page#page-get-by-ref) locates an element by its aria ref, such as `e2`, reported by [page.ariaSnapshot()](https://playwright.dev/docs/api/class-page#page-aria-snapshot) in the `'ai'` mode.
  136. - New option [`includeShadow`](https://playwright.dev/docs/api/class-page#page-content-option-include-shadow) in [page.content()](https://playwright.dev/docs/api/class-page#page-content) and [frame.content()](https://playwright.dev/docs/api/class-frame#frame-content) serializes open shadow roots as [declarative shadow DOM](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_shadow_DOM#declaratively_with_html).
  137. - New option [`signCount`](https://playwright.dev/docs/api/class-credentials#credentials-create-option-sign-count) sets the initial signature counter of a virtual credential. [credentials.create()](https://playwright.dev/docs/api/class-credentials#credentials-create) and [credentials.get()](https://playwright.dev/docs/api/class-credentials#credentials-get) return the current `signCount`, and it is saved and restored together with the credentials in the storage state.
  138. - New [fullConfig.filteredProjects](https://playwright.dev/docs/api/class-fullconfig#full-config-filtered-projects) lists the projects that were selected to run after applying the `--project` filter. It is available in global setup and reporters.
  139. - New [apiRequestContext.addCookies()](https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-add-cookies), [apiRequestContext.cookies()](https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-cookies) and [apiRequestContext.clearCookies()](https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-clear-cookies) manage cookies of a request context, mirroring the [BrowserContext](https://playwright.dev/docs/api/class-browsercontext) methods:
  141. ```js
  142. await request.addCookies([{ name: 'session-id', value: '42', url: 'https://example.com' }]);
  143. console.log(await request.cookies('https://example.com'));
  144. await request.clearCookies({ name: 'session-id' });
  145. ```
  147. ## Breaking changes ⚠️
  148. - `screen` property is now forwarded from the [device descriptors](https://playwright.dev/docs/emulation#devices). If you use `...devices['Desktop Chrome']` and alike, `window.screen` and media queries now see the emulated screen size. You can opt-out by explicitly setting `screen` to `undefined`:
  150. ```js
  151. // playwright.config.ts
  152. export default defineConfig({
  153. use: {
  154. ...devices['Desktop Chrome'],
  155. screen: undefined,
  156. },
  157. });
  158. ```
  160. - JSX in your test files now follows your `tsconfig.json`. Playwright compiles JSX in test files according to the `jsx`, `jsxFactory`, `jsxFragmentFactory` and `jsxImportSource` [tsconfig options](https://playwright.dev/docs/test-typescript#tsconfig-jsx-options), and defaults to the automatic runtime from `react/jsx-runtime`.
  161. - `--update-snapshots=missing` now passes the test run. Tests that only create missing snapshots now pass in the `'missing'` mode of [testConfig.updateSnapshots](https://playwright.dev/docs/api/class-testconfig#test-config-update-snapshots), so that CI can generate new snapshots and verify the existing ones in a single run. The mode used when the option is not specified is now called `'default'` and behaves as before: missing snapshots are written and the test fails.
  162. - Elements inside hidden iframes are considered hidden. Elements inside an iframe that is not visible, for example with `visibility: hidden`, are now considered hidden by actions, [locator.isVisible()](https://playwright.dev/docs/api/class-locator#locator-is-visible) and [expect(locator).toBeVisible()](https://playwright.dev/docs/api/class-locatorassertions#locator-assertions-to-be-visible).
  164. ## Browser Versions
  165. - Chromium 156.0.8078.4
  166. - Mozilla Firefox 157.0
  167. - WebKit 27.2
  169. This version was also tested against the following stable channels:
  170. - Google Chrome 155
  171. - Microsoft Edge 155

voir sur githubdetected 2026-10-08 via npm