diff --git a/docs/src/release-notes-js.md b/docs/src/release-notes-js.md index b896ea4620d3d..51376a47f6de9 100644 --- a/docs/src/release-notes-js.md +++ b/docs/src/release-notes-js.md @@ -4,6 +4,68 @@ title: "Release notes" toc_max_heading_level: 2 --- +## Version 1.28 + +### Playwright Tools + +* **Record at Cursor in VSCode.** You can run the test, position the cursor at the end of the test and continue generating the test. + +![New VSCode Extension](https://user-images.githubusercontent.com/746130/202005839-aba2eeba-217b-424d-8496-8b4f5fa72f41.png) + +* **Live Locators in VSCode.** You can hover and edit locators in VSCode to get them highlighted in the opened browser. +* **Live Locators in CodeGen.** Generate a locator for any element on the page using "Explore" tool. + +![Locator Explorer](https://user-images.githubusercontent.com/746130/201796876-01567a0b-ca61-4a9d-b12b-04786c471671.png) + +* **Codegen and Trace Viewer Dark Theme.** Automatically picked up from operating system settings. + +![Dark Theme](https://user-images.githubusercontent.com/746130/201797969-603f74df-d7cf-4c56-befd-798dbd269796.png) + + +### Test Runner + +* Configure retries and test timeout for a file or a test with [`method: Test.describe.configure`]. + + ```js + // Each test in the file will be retried twice and have a timeout of 20 seconds. + test.describe.configure({ retries: 2, timeout: 20_000 }); + test('runs first', async ({ page }) => {}); + test('runs second', async ({ page }) => {}); + ``` + +* Use [`property: TestProject.snapshotPathTemplate`] and [`property: TestConfig.snapshotPathTemplate`] to configure a template controlling location of snapshots generated by [`method: PageAssertions.toHaveScreenshot#1`] and [`method: ScreenshotAssertions.toMatchSnapshot#1`]. + + ```js + // playwright.config.ts + import type { PlaywrightTestConfig } from '@playwright/test'; + + const config: PlaywrightTestConfig = { + testDir: './tests', + snapshotPathTemplate: '{testDir}/__screenshots__/{testFilePath}/{arg}{ext}', + }; + + export default config; + ``` + +### New APIs + +- [`method: Locator.blur`] +- [`method: Locator.clear`] +- [`method: Android.launchServer`] and [`method: Android.connect`] +- [`event: AndroidDevice.close`] + +### Browser Versions + +* Chromium 108.0.5359.29 +* Mozilla Firefox 106.0 +* WebKit 16.0 + +This version was also tested against the following stable channels: + +* Google Chrome 107 +* Microsoft Edge 107 + + ## Version 1.27