diff --git a/docs/src/accessibility-testing-js.md b/docs/src/accessibility-testing-js.md index ece2ffc3f3..e806a1aeb5 100644 --- a/docs/src/accessibility-testing-js.md +++ b/docs/src/accessibility-testing-js.md @@ -82,8 +82,8 @@ test('navigation menu flyout should not have automatically detectable accessibil await page.locator('#navigation-menu-flyout').waitFor(); const accessibilityScanResults = await new AxeBuilder({ page }) - .include('#navigation-menu-flyout') - .analyze(); + .include('#navigation-menu-flyout') + .analyze(); expect(accessibilityScanResults.violations).toEqual([]); }); @@ -102,8 +102,8 @@ test('should not have any automatically detectable WCAG A or AA violations', asy await page.goto('https://your-site.com/'); const accessibilityScanResults = await new AxeBuilder({ page }) - .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa']) - .analyze(); + .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa']) + .analyze(); expect(accessibilityScanResults.violations).toEqual([]); }); @@ -130,8 +130,8 @@ test('should not have any accessibility violations outside of elements with know await page.goto('https://your-site.com/page-with-known-issues'); const accessibilityScanResults = await new AxeBuilder({ page }) - .exclude('#element-with-known-issue') - .analyze(); + .exclude('#element-with-known-issue') + .analyze(); expect(accessibilityScanResults.violations).toEqual([]); }); @@ -150,8 +150,8 @@ test('should not have any accessibility violations outside of rules with known i await page.goto('https://your-site.com/page-with-known-issues'); const accessibilityScanResults = await new AxeBuilder({ page }) - .disableRules(['duplicate-id']) - .analyze(); + .disableRules(['duplicate-id']) + .analyze(); expect(accessibilityScanResults.violations).toEqual([]); }); @@ -176,14 +176,14 @@ expect(violationFingerprints(accessibilityScanResults)).toMatchSnapshot(); // my-test-utils.js function violationFingerprints(accessibilityScanResults) { - const violationFingerprints = accessibilityScanResults.violations.map(violation => ({ - rule: violation.id, - // These are CSS selectors which uniquely identify each element with - // a violation of the rule in question. - targets: violation.nodes.map(node => node.target), - })); + const violationFingerprints = accessibilityScanResults.violations.map(violation => ({ + rule: violation.id, + // These are CSS selectors which uniquely identify each element with + // a violation of the rule in question. + targets: violation.nodes.map(node => node.target), + })); - return JSON.stringify(violationFingerprints, null, 2); + return JSON.stringify(violationFingerprints, null, 2); } ``` @@ -238,8 +238,8 @@ type AxeFixture = { export const test = base.extend({ makeAxeBuilder: async ({ page }, use, testInfo) => { const makeAxeBuilder = () => new AxeBuilder({ page }) - .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa']) - .exclude('#commonly-reused-element-with-known-issue'); + .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa']) + .exclude('#commonly-reused-element-with-known-issue'); await use(makeAxeBuilder); } @@ -259,8 +259,8 @@ const AxeBuilder = require('@axe-core/playwright').default; exports.test = base.test.extend({ makeAxeBuilder: async ({ page }, use, testInfo) => { const makeAxeBuilder = () => new AxeBuilder({ page }) - .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa']) - .exclude('#commonly-reused-element-with-known-issue'); + .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa']) + .exclude('#commonly-reused-element-with-known-issue'); await use(makeAxeBuilder); } @@ -279,10 +279,10 @@ test('example using custom fixture', async ({ page, makeAxeBuilder }) => { await page.goto('https://your-site.com/'); const accessibilityScanResults = await makeAxeBuilder() - // Automatically uses the shared AxeBuilder configuration, - // but supports additional test-specific configuration too - .include('#specific-element-under-test') - .analyze(); + // Automatically uses the shared AxeBuilder configuration, + // but supports additional test-specific configuration too + .include('#specific-element-under-test') + .analyze(); expect(accessibilityScanResults.violations).toEqual([]); }); diff --git a/docs/src/api-testing-js.md b/docs/src/api-testing-js.md index 3d83a37835..7a77e5a9b6 100644 --- a/docs/src/api-testing-js.md +++ b/docs/src/api-testing-js.md @@ -147,7 +147,7 @@ const USER = 'github-username'; 'Authorization': `token ${process.env.API_TOKEN}`, } }); -})() +})(); ``` ## Sending API requests from UI tests @@ -180,7 +180,7 @@ test.beforeAll(async ({ playwright }) => { 'Authorization': `token ${process.env.API_TOKEN}`, }, }); -}) +}); test.afterAll(async ({ }) => { // Dispose all responses. @@ -227,7 +227,7 @@ test.beforeAll(async ({ playwright }) => { 'Authorization': `token ${process.env.API_TOKEN}`, }, }); -}) +}); test.afterAll(async ({ }) => { // Dispose all responses. @@ -289,7 +289,7 @@ automatically update browser cookies if [APIResponse] has `Set-Cookie` header: ```js test('context request will share cookie storage with its browser context', async ({ page, context }) => { - await context.route('https://www.github.com/', async (route) => { + await context.route('https://www.github.com/', async route => { // Send an API request that shares cookie storage with the browser context. const response = await context.request.fetch(route.request()); const responseHeaders = response.headers(); @@ -300,11 +300,11 @@ test('context request will share cookie storage with its browser context', async expect(responseCookies.size).toBe(3); const contextCookies = await context.cookies(); // The browser context will already contain all the cookies from the API response. - expect(new Map(contextCookies.map(({name, value}) => [name, value]))).toEqual(responseCookies); + expect(new Map(contextCookies.map(({ name, value }) => [name, value]))).toEqual(responseCookies); route.fulfill({ response, - headers: {...responseHeaders, foo: 'bar'}, + headers: { ...responseHeaders, foo: 'bar' }, }); }); await page.goto('https://www.github.com/'); @@ -318,7 +318,7 @@ create a new instance of [APIRequestContext] which will have its own isolated co test('global context request has isolated cookie storage', async ({ page, context, browser, playwright }) => { // Create a new instance of APIRequestContext with isolated cookie storage. const request = await playwright.request.newContext(); - await context.route('https://www.github.com/', async (route) => { + await context.route('https://www.github.com/', async route => { const response = await request.fetch(route.request()); const responseHeaders = response.headers(); @@ -335,11 +335,11 @@ test('global context request has isolated cookie storage', async ({ page, contex const browserContext2 = await browser.newContext({ storageState }); const contextCookies2 = await browserContext2.cookies(); // The new browser context will already contain all the cookies from the API response. - expect(new Map(contextCookies2.map(({name, value}) => [name, value]))).toEqual(responseCookies); + expect(new Map(contextCookies2.map(({ name, value }) => [name, value]))).toEqual(responseCookies); route.fulfill({ response, - headers: {...responseHeaders, foo: 'bar'}, + headers: { ...responseHeaders, foo: 'bar' }, }); }); await page.goto('https://www.github.com/'); diff --git a/docs/src/api/class-browser.md b/docs/src/api/class-browser.md index 88e1c8ae1a..b25da29e13 100644 --- a/docs/src/api/class-browser.md +++ b/docs/src/api/class-browser.md @@ -299,7 +299,7 @@ be opened in Chrome DevTools performance panel. **Usage** ```js -await browser.startTracing(page, {path: 'trace.json'}); +await browser.startTracing(page, { path: 'trace.json' }); await page.goto('https://www.google.com'); await browser.stopTracing(); ``` diff --git a/docs/src/api/class-browsercontext.md b/docs/src/api/class-browsercontext.md index 7f91cb387d..543f31352d 100644 --- a/docs/src/api/class-browsercontext.md +++ b/docs/src/api/class-browsercontext.md @@ -1307,7 +1307,7 @@ Sets the context's geolocation. Passing `null` or `undefined` emulates position **Usage** ```js -await browserContext.setGeolocation({latitude: 59.95, longitude: 30.31667}); +await browserContext.setGeolocation({ latitude: 59.95, longitude: 30.31667 }); ``` ```java diff --git a/docs/src/api/class-consolemessage.md b/docs/src/api/class-consolemessage.md index 812b5dd204..06776c8e71 100644 --- a/docs/src/api/class-consolemessage.md +++ b/docs/src/api/class-consolemessage.md @@ -7,7 +7,7 @@ context. ```js // Listen for all console logs -page.on('console', msg => console.log(msg.text())) +page.on('console', msg => console.log(msg.text())); // Listen for all console events and handle errors page.on('console', msg => { @@ -23,8 +23,8 @@ await page.evaluate(() => { const msg = await msgPromise; // Deconstruct console log arguments -await msg.args()[0].jsonValue() // hello -await msg.args()[1].jsonValue() // 42 +await msg.args()[0].jsonValue(); // hello +await msg.args()[1].jsonValue(); // 42 ``` ```java diff --git a/docs/src/api/class-coverage.md b/docs/src/api/class-coverage.md index 021d33e127..8eae75e24d 100644 --- a/docs/src/api/class-coverage.md +++ b/docs/src/api/class-coverage.md @@ -14,7 +14,7 @@ Coverage APIs are only supported on Chromium-based browsers. const { chromium } = require('playwright'); const v8toIstanbul = require('v8-to-istanbul'); -(async() => { +(async () => { const browser = await chromium.launch(); const page = await browser.newPage(); await page.coverage.startJSCoverage(); diff --git a/docs/src/api/class-electronapplication.md b/docs/src/api/class-electronapplication.md index e848f4a6ab..06de31dce4 100644 --- a/docs/src/api/class-electronapplication.md +++ b/docs/src/api/class-electronapplication.md @@ -128,11 +128,11 @@ Convenience method that waits for the first application window to be opened. **Usage** ```js - const electronApp = await electron.launch({ - args: ['main.js'] - }); - const window = await electronApp.firstWindow(); - // ... +const electronApp = await electron.launch({ + args: ['main.js'] +}); +const window = await electronApp.firstWindow(); +// ... ``` ### option: ElectronApplication.firstWindow.timeout diff --git a/docs/src/api/class-elementhandle.md b/docs/src/api/class-elementhandle.md index e0ad30bd37..03c3b70181 100644 --- a/docs/src/api/class-elementhandle.md +++ b/docs/src/api/class-elementhandle.md @@ -984,7 +984,7 @@ To press a special key, like `Control` or `ArrowDown`, use [`method: ElementHand ```js await elementHandle.type('Hello'); // Types instantly -await elementHandle.type('World', {delay: 100}); // Types slower, like a user +await elementHandle.type('World', { delay: 100 }); // Types slower, like a user ``` ```java diff --git a/docs/src/api/class-frame.md b/docs/src/api/class-frame.md index 097c6cc0fd..c05e9e3fa9 100644 --- a/docs/src/api/class-frame.md +++ b/docs/src/api/class-frame.md @@ -25,9 +25,8 @@ const { firefox } = require('playwright'); // Or 'chromium' or 'webkit'. function dumpFrameTree(frame, indent) { console.log(indent + frame.url()); - for (const child of frame.childFrames()) { + for (const child of frame.childFrames()) dumpFrameTree(child, indent + ' '); - } } })(); ``` @@ -733,8 +732,8 @@ If the function, passed to the [`method: Frame.evaluateHandle`], returns a [Prom **Usage** ```js +// Handle for the window object const aWindowHandle = await frame.evaluateHandle(() => Promise.resolve(window)); -aWindowHandle; // Handle for the window object. ``` ```java @@ -1739,7 +1738,7 @@ To press a special key, like `Control` or `ArrowDown`, use [`method: Keyboard.pr ```js await frame.type('#mytextarea', 'Hello'); // Types instantly -await frame.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user +await frame.type('#mytextarea', 'World', { delay: 100 }); // Types slower, like a user ``` ```java @@ -1857,7 +1856,7 @@ const { firefox } = require('playwright'); // Or 'chromium' or 'webkit'. const browser = await firefox.launch(); const page = await browser.newPage(); const watchDog = page.mainFrame().waitForFunction('window.innerWidth < 100'); - await page.setViewportSize({width: 50, height: 50}); + await page.setViewportSize({ width: 50, height: 50 }); await watchDog; await browser.close(); })(); @@ -2137,7 +2136,7 @@ const { chromium } = require('playwright'); // Or 'firefox' or 'webkit'. (async () => { const browser = await chromium.launch(); const page = await browser.newPage(); - for (let currentURL of ['https://google.com', 'https://bbc.com']) { + for (const currentURL of ['https://google.com', 'https://bbc.com']) { await page.goto(currentURL); const element = await page.mainFrame().waitForSelector('img'); console.log('Loaded image: ' + await element.getAttribute('src')); diff --git a/docs/src/api/class-jshandle.md b/docs/src/api/class-jshandle.md index 4a7801e23a..9f38b18447 100644 --- a/docs/src/api/class-jshandle.md +++ b/docs/src/api/class-jshandle.md @@ -132,7 +132,7 @@ The method returns a map with **own property names** as keys and JSHandle instan **Usage** ```js -const handle = await page.evaluateHandle(() => ({window, document})); +const handle = await page.evaluateHandle(() => ({ window, document })); const properties = await handle.getProperties(); const windowHandle = properties.get('window'); const documentHandle = properties.get('document'); @@ -140,7 +140,7 @@ await handle.dispose(); ``` ```java -JSHandle handle = page.evaluateHandle("() => ({window, document})"); +JSHandle handle = page.evaluateHandle("() => ({ window, document })"); Map properties = handle.getProperties(); JSHandle windowHandle = properties.get("window"); JSHandle documentHandle = properties.get("document"); @@ -148,7 +148,7 @@ handle.dispose(); ``` ```python async -handle = await page.evaluate_handle("({window, document})") +handle = await page.evaluate_handle("({ window, document })") properties = await handle.get_properties() window_handle = properties.get("window") document_handle = properties.get("document") @@ -156,7 +156,7 @@ await handle.dispose() ``` ```python sync -handle = page.evaluate_handle("({window, document})") +handle = page.evaluate_handle("({ window, document })") properties = handle.get_properties() window_handle = properties.get("window") document_handle = properties.get("document") @@ -164,7 +164,7 @@ handle.dispose() ``` ```csharp -var handle = await page.EvaluateHandleAsync("() => ({window, document}"); +var handle = await page.EvaluateHandleAsync("() => ({ window, document }"); var properties = await handle.GetPropertiesAsync(); var windowHandle = properties["window"]; var documentHandle = properties["document"]; diff --git a/docs/src/api/class-keyboard.md b/docs/src/api/class-keyboard.md index e3b11804aa..5144016815 100644 --- a/docs/src/api/class-keyboard.md +++ b/docs/src/api/class-keyboard.md @@ -319,7 +319,7 @@ To press a special key, like `Control` or `ArrowDown`, use [`method: Keyboard.pr ```js await page.keyboard.type('Hello'); // Types instantly -await page.keyboard.type('World', {delay: 100}); // Types slower, like a user +await page.keyboard.type('World', { delay: 100 }); // Types slower, like a user ``` ```java diff --git a/docs/src/api/class-locator.md b/docs/src/api/class-locator.md index e50a51e65c..38907cad00 100644 --- a/docs/src/api/class-locator.md +++ b/docs/src/api/class-locator.md @@ -2145,7 +2145,7 @@ To press a special key, like `Control` or `ArrowDown`, use [`method: Locator.pre ```js await element.type('Hello'); // Types instantly -await element.type('World', {delay: 100}); // Types slower, like a user +await element.type('World', { delay: 100 }); // Types slower, like a user ``` ```java diff --git a/docs/src/api/class-locatorassertions.md b/docs/src/api/class-locatorassertions.md index b95fa51612..837f7696c7 100644 --- a/docs/src/api/class-locatorassertions.md +++ b/docs/src/api/class-locatorassertions.md @@ -1750,8 +1750,8 @@ For example, given the following element: ``` ```js -const locator = page.locator("id=favorite-colors"); -await locator.selectOption(["R", "G"]); +const locator = page.locator('id=favorite-colors'); +await locator.selectOption(['R', 'G']); await expect(locator).toHaveValues([/R/, /G/]); ``` diff --git a/docs/src/api/class-logger.md b/docs/src/api/class-logger.md index 287b0af880..a3a4b7c463 100644 --- a/docs/src/api/class-logger.md +++ b/docs/src/api/class-logger.md @@ -14,7 +14,7 @@ const { chromium } = require('playwright'); // Or 'firefox' or 'webkit'. log: (name, severity, message, args) => console.log(`${name} ${message}`) } }); - ... + // ... })(); ``` diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.md index 6a6a8f5d0a..e9635de2af 100644 --- a/docs/src/api/class-page.md +++ b/docs/src/api/class-page.md @@ -16,7 +16,7 @@ const { webkit } = require('playwright'); // Or 'chromium' or 'firefox'. const context = await browser.newContext(); const page = await context.newPage(); await page.goto('https://example.com'); - await page.screenshot({path: 'screenshot.png'}); + await page.screenshot({ path: 'screenshot.png' }); await browser.close(); })(); ``` @@ -338,7 +338,7 @@ Emitted when a file chooser is supposed to appear, such as after clicking the ` respond to it via setting the input files using [`method: FileChooser.setFiles`] that can be uploaded after that. ```js -page.on('filechooser', async (fileChooser) => { +page.on('filechooser', async fileChooser => { await fileChooser.setFiles('/tmp/myfile.pdf'); }); ``` @@ -1508,7 +1508,7 @@ Console.WriteLine(await page.EvaluateAsync("1 + 2")); // prints "3" ```js const bodyHandle = await page.evaluate('document.body'); -const html = await page.evaluate(([body, suffix]) => body.innerHTML + suffix, [bodyHandle, 'hello']); +const html = await page.evaluate(([body, suffix]) => body.innerHTML + suffix, [bodyHandle, 'hello']); await bodyHandle.dispose(); ``` @@ -1562,8 +1562,8 @@ promise to resolve and return its value. **Usage** ```js +// Handle for the window object. const aWindowHandle = await page.evaluateHandle(() => Promise.resolve(window)); -aWindowHandle; // Handle for the window object. ``` ```java @@ -2796,8 +2796,8 @@ force rendering of exact colors. ```js // Generates a PDF with 'screen' media type. -await page.emulateMedia({media: 'screen'}); -await page.pdf({path: 'page.pdf'}); +await page.emulateMedia({ media: 'screen' }); +await page.pdf({ path: 'page.pdf' }); ``` ```java @@ -3777,7 +3777,7 @@ To press a special key, like `Control` or `ArrowDown`, use [`method: Keyboard.pr ```js await page.type('#mytextarea', 'Hello'); // Types instantly -await page.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user +await page.type('#mytextarea', 'World', { delay: 100 }); // Types slower, like a user ``` ```java @@ -4090,7 +4090,7 @@ const { webkit } = require('playwright'); // Or 'chromium' or 'firefox'. const browser = await webkit.launch(); const page = await browser.newPage(); const watchDog = page.waitForFunction(() => window.innerWidth < 100); - await page.setViewportSize({width: 50, height: 50}); + await page.setViewportSize({ width: 50, height: 50 }); await watchDog; await browser.close(); })(); @@ -4698,7 +4698,7 @@ const { chromium } = require('playwright'); // Or 'firefox' or 'webkit'. (async () => { const browser = await chromium.launch(); const page = await browser.newPage(); - for (let currentURL of ['https://google.com', 'https://bbc.com']) { + for (const currentURL of ['https://google.com', 'https://bbc.com']) { await page.goto(currentURL); const element = await page.waitForSelector('img'); console.log('Loaded image: ' + await element.getAttribute('src')); diff --git a/docs/src/api/class-playwrightassertions.md b/docs/src/api/class-playwrightassertions.md index c8549cc96e..bb5bb305a9 100644 --- a/docs/src/api/class-playwrightassertions.md +++ b/docs/src/api/class-playwrightassertions.md @@ -11,7 +11,7 @@ import { test, expect } from '@playwright/test'; test('status becomes submitted', async ({ page }) => { // ... - await page.locator('#submit-button').click() + await page.locator('#submit-button').click(); await expect(page.locator('.status')).toHaveText('Submitted'); }); ``` diff --git a/docs/src/api/class-route.md b/docs/src/api/class-route.md index d8369d281d..afbf071245 100644 --- a/docs/src/api/class-route.md +++ b/docs/src/api/class-route.md @@ -51,7 +51,7 @@ await page.route('**/*', (route, request) => { foo: 'foo-value', // set "foo" header bar: undefined, // remove "bar" header }; - route.continue({headers}); + route.continue({ headers }); }); ``` @@ -337,7 +337,7 @@ await page.route('**/*', (route, request) => { foo: 'foo-value', // set "foo" header bar: undefined, // remove "bar" header }; - route.fallback({headers}); + route.fallback({ headers }); }); ``` diff --git a/docs/src/api/class-timeouterror.md b/docs/src/api/class-timeouterror.md index 0ac64e52ac..491d071bb8 100644 --- a/docs/src/api/class-timeouterror.md +++ b/docs/src/api/class-timeouterror.md @@ -12,12 +12,12 @@ const playwright = require('playwright'); const context = await browser.newContext(); const page = await context.newPage(); try { - await page.locator("text=Foo").click({ + await page.locator('text=Foo').click({ timeout: 100, - }) + }); } catch (error) { if (error instanceof playwright.errors.TimeoutError) - console.log("Timeout!") + console.log('Timeout!'); } await browser.close(); })(); diff --git a/docs/src/api/params.md b/docs/src/api/params.md index 3cc445c30a..d8cc65cff5 100644 --- a/docs/src/api/params.md +++ b/docs/src/api/params.md @@ -1302,9 +1302,13 @@ By default, the `data-testid` attribute is used as a test id. Use [`method: Sele ```js // Set custom test id attribute from @playwright/test config: -use: { - testIdAttribute: 'data-pw' -} +import { defineConfig } from '@playwright/test'; + +export default defineConfig({ + use: { + testIdAttribute: 'data-pw' + }, +}); ``` ## template-locator-get-by-text @@ -1327,19 +1331,19 @@ You can locate by text substring, exact string, or a regular expression: ```js // Matches -page.getByText('world') +page.getByText('world'); // Matches first
-page.getByText('Hello world') +page.getByText('Hello world'); // Matches second
-page.getByText('Hello', { exact: true }) +page.getByText('Hello', { exact: true }); // Matches both
s -page.getByText(/Hello/) +page.getByText(/Hello/); // Matches second
-page.getByText(/^hello$/i) +page.getByText(/^hello$/i); ``` ```python async @@ -1503,8 +1507,8 @@ You can fill the input after locating it by the placeholder text: ```js await page - .getByPlaceholder("name@example.com") - .fill("playwright@microsoft.com"); + .getByPlaceholder('name@example.com') + .fill('playwright@microsoft.com'); ``` ```java diff --git a/docs/src/auth.md b/docs/src/auth.md index 11514ed5c3..f57a64e955 100644 --- a/docs/src/auth.md +++ b/docs/src/auth.md @@ -497,7 +497,7 @@ You can introduce fixtures that will provide a page authenticated as each role. Below is an example that [creates fixtures](./test-fixtures.md#creating-a-fixture) for two [Page Object Models](./pom.md) - admin POM and user POM. It assumes `adminStorageState.json` and `userStorageState.json` files were created in the global setup. ```js title="playwright/fixtures.ts" -import { test as base, Page, Locator } from '@playwright/test'; +import { test as base, type Page, type Locator } from '@playwright/test'; // Page Object Model for the "admin" page. // Here you can add locators and helper methods specific to the admin page. @@ -579,9 +579,8 @@ fs.writeFileSync('playwright/.auth/session.json', JSON.stringify(sessionStorage) const sessionStorage = JSON.parse(fs.readFileSync('playwright/.auth/session.json', 'utf-8')); await context.addInitScript(storage => { if (window.location.hostname === 'example.com') { - for (const [key, value] of Object.entries(storage)) { + for (const [key, value] of Object.entries(storage)) window.sessionStorage.setItem(key, value); - } } }, sessionStorage); ``` diff --git a/docs/src/best-practices-js.md b/docs/src/best-practices-js.md index fbe82c5015..85068d1184 100644 --- a/docs/src/best-practices-js.md +++ b/docs/src/best-practices-js.md @@ -65,7 +65,8 @@ If working with a database then make sure you control the data. Test against a s In order to write end to end tests we need to first find elements on the webpage. We can do this by using Playwright's built in [locators](./locators.md). Locators come with auto waiting and retry-ability. Auto waiting means that Playwright performs a range of actionability checks on the elements, such as ensuring the element is visible and enabled before it performs the click. To make tests resilient, we recommend prioritizing user-facing attributes and explicit contracts. ```js -👍 page.getByRole('button', { name: 'submit' }) +// 👍 +page.getByRole('button', { name: 'submit' }); ``` #### Use chaining and filtering @@ -92,13 +93,15 @@ Your DOM can easily change so having your tests depend on your DOM structure can ```js -👎 page.locator('button.buttonIcon.episode-actions-later') +// 👎 +page.locator('button.buttonIcon.episode-actions-later'); ``` Use locators that are resilient to changes in the DOM. ```js -👍 page.getByRole('button', { name: 'submit' }) +// 👍 +page.getByRole('button', { name: 'submit' }); ``` ### Generate locators @@ -129,9 +132,11 @@ You can also use the [VS Code Extension](./getting-started-vscode.md) to generat Assertions are a way to verify that the expected result and the actual result matched or not. By using [web first assertions](./test-assertions.md) Playwright will wait until the expected condition is met. For example, when testing an alert message, a test would click a button that makes a message appear and check that the alert message is there. If the alert message takes half a second to appear, assertions such as `toBeVisible()` will wait and retry if needed. ```js -👍 await expect(page.getByText('welcome')).toBeVisible(); +// 👍 +await expect(page.getByText('welcome')).toBeVisible(); -👎 expect(await page.getByText('welcome').isVisible()).toBe(true); +// 👎 +expect(await page.getByText('welcome').isVisible()).toBe(true); ``` #### Don't use manual assertions @@ -139,13 +144,15 @@ Assertions are a way to verify that the expected result and the actual result ma Don't use manual assertions that are not awaiting the expect. In the code below the await is inside the expect rather than before it. When using assertions such as `isVisible()` the test won't wait a single second, it will just check the locator is there and return immediately. ```js -👎 expect(await page.getByText('welcome').isVisible()).toBe(true); +// 👎 +expect(await page.getByText('welcome').isVisible()).toBe(true); ``` Use web first assertions such as `toBeVisible()` instead. ```js -👍 await expect(page.getByText('welcome')).toBeVisible(); +// 👍 +await expect(page.getByText('welcome')).toBeVisible(); ``` ### Configure debugging @@ -162,7 +169,7 @@ You can live debug your test by clicking or editing the locators in your test in You can also debug your tests with the Playwright inspector by running your tests with the `--debug` flag. -```js +```bash npx playwright test --debug ``` @@ -174,7 +181,7 @@ You can then step through your test, view actionability logs and edit the locato To debug a specific test add the name of the test file and the line number of the test followed by the `--debug` flag. -```js +```bash npx playwright test example.spec.ts:9 --debug ``` #### Debugging on CI @@ -185,12 +192,12 @@ For CI failures, use the Playwright [trace viewer](./trace-viewer.md) instead of Traces are configured in the Playwright config file and are set to run on CI on the first retry of a failed test. We don't recommend setting this to `on` so that traces are run on every test as it's very performance heavy. However you can run a trace locally when developing with the `--trace` flag. -```js +```bash npx playwright test --trace on ``` Once you run this command your traces will be recorded for each test and can be viewed directly from the HTML report. -```js +```bash npx playwright show-report ```` @@ -237,14 +244,14 @@ export default defineConfig({ By keeping your Playwright version up to date you will be able to test your app on the latest browser versions and catch failures before the latest browser version is released to the public. -```js +```bash npm install -D @playwright/test@latest ``` Check the [release notes](./release-notes.md) to see what the latest version is and what changes have been released. You can see what version of Playwright you have by running the following command. -```js +```bash npx playwright --version ``` @@ -273,7 +280,7 @@ test('runs in parallel 2', async ({ page }) => { /* ... */ }); Playwright can [shard](./test-parallel.md#shard-tests-between-multiple-machines) a test suite, so that it can be executed on multiple machines. -```js +```bash npx playwright test --shard=1/3 ``` diff --git a/docs/src/browser-contexts.md b/docs/src/browser-contexts.md index 52e0c3696c..d4fbf73184 100644 --- a/docs/src/browser-contexts.md +++ b/docs/src/browser-contexts.md @@ -80,7 +80,7 @@ test('admin and user', async ({ browser }) => { // Create two isolated browser contexts const adminContext = await browser.newContext(); const userContext = await browser.newContext(); - + // Create pages and interact with contexts independently const adminPage = await adminContext.newPage(); const userPage = await userContext.newPage(); diff --git a/docs/src/ci.md b/docs/src/ci.md index 58750b2df9..69c619cc5d 100644 --- a/docs/src/ci.md +++ b/docs/src/ci.md @@ -611,7 +611,11 @@ steps: ``` Note: The JUnit reporter needs to be configured accordingly via ```js -["junit", { outputFile: "test-results/e2e-junit-results.xml" }] +import { defineConfig } from '@playwright/test'; + +export default defineConfig({ + reporter: ['junit', { outputFile: 'test-results/e2e-junit-results.xml' }], +}); ``` in `playwright.config.ts`. diff --git a/docs/src/emulation.md b/docs/src/emulation.md index 8d7a15eb57..9ed7108b19 100644 --- a/docs/src/emulation.md +++ b/docs/src/emulation.md @@ -114,7 +114,7 @@ Test file: ```js tab=js-test title="tests/example.spec.ts" import { test, expect } from '@playwright/test'; -test.use({ +test.use({ viewport: { width: 1600, height: 1200 }, }); @@ -274,7 +274,7 @@ export default defineConfig({ use: { // Emulates the user locale. locale: 'en-GB', - + // Emulates the user timezone. timezoneId: 'Europe/Paris', }, @@ -284,7 +284,7 @@ export default defineConfig({ ```js tab=js-test title="tests/example.spec.ts" import { test, expect } from '@playwright/test'; -test.use({ +test.use({ locale: 'de-DE', timezoneId: 'Europe/Berlin', }); @@ -447,7 +447,7 @@ export default defineConfig({ ```js tab=js-test title="tests/example.spec.ts" import { test, expect } from '@playwright/test'; -test.use({ +test.use({ geolocation: { longitude: 41.890221, latitude: 12.492348 }, permissions: ['geolocation'], }); @@ -500,8 +500,8 @@ Change the location later: ```js tab=js-test title="tests/example.spec.ts" import { test, expect } from '@playwright/test'; -test.use({ - geolocation: { longitude: 41.890221, latitude: 12.492348}, +test.use({ + geolocation: { longitude: 41.890221, latitude: 12.492348 }, permissions: ['geolocation'], }); @@ -549,7 +549,7 @@ export default defineConfig({ ```js tab=js-test title="tests/example.spec.ts" import { test, expect } from '@playwright/test'; -test.use({ +test.use({ colorScheme: 'dark' // or 'light' }); @@ -662,7 +662,7 @@ The User Agent is included in the device and therefore you will rarely need to ```js tab=js-test title="tests/example.spec.ts" import { test, expect } from '@playwright/test'; -test.use({ userAgent: 'My user agent'}); +test.use({ userAgent: 'My user agent' }); test('my user agent test', async ({ page }) => { // ... diff --git a/docs/src/events.md b/docs/src/events.md index 24e6c68403..a15ebcf300 100644 --- a/docs/src/events.md +++ b/docs/src/events.md @@ -163,7 +163,7 @@ await page.GotoAsync("https://www.openstreetmap.org/"); If a certain event needs to be handled once, there is a convenience API for that: ```js -page.once('dialog', dialog => dialog.accept("2021")); +page.once('dialog', dialog => dialog.accept('2021')); await page.evaluate("prompt('Enter a number:')"); ``` diff --git a/docs/src/input.md b/docs/src/input.md index 0a5a9b0218..e9fbb2e753 100644 --- a/docs/src/input.md +++ b/docs/src/input.md @@ -88,7 +88,7 @@ Using [`method: Locator.setChecked`] is the easiest way to check and uncheck a c await page.getByLabel('I agree to the terms above').check(); // Assert the checked state -expect(await page.getByLabel('Subscribe to newsletter').isChecked()).toBeTruthy() +expect(await page.getByLabel('Subscribe to newsletter').isChecked()).toBeTruthy(); // Select the radio button await page.getByLabel('XL').check(); @@ -219,7 +219,7 @@ await page.getByText('Item').click({ modifiers: ['Shift'] }); await page.getByText('Item').hover(); // Click the top left corner -await page.getByText('Item').click({ position: { x: 0, y: 0} }); +await page.getByText('Item').click({ position: { x: 0, y: 0 } }); ``` ```java diff --git a/docs/src/library-js.md b/docs/src/library-js.md index 79f26ff967..ba54b90951 100644 --- a/docs/src/library-js.md +++ b/docs/src/library-js.md @@ -33,7 +33,7 @@ import assert from 'node:assert'; // Teardown await context.close(); await browser.close(); -})() +})(); ``` ```js tab=js-js @@ -55,7 +55,7 @@ const { chromium, devices } = require('playwright'); // Teardown await context.close(); await browser.close(); -})() +})(); ``` Run it with `node my-script.js`. @@ -185,7 +185,7 @@ Playwright includes built-in support for TypeScript. Type definitions will be im Add the following to the top of your JavaScript file to get type-checking in VS Code or WebStorm. ```js -//@ts-check +// @ts-check // ... ``` diff --git a/docs/src/locators.md b/docs/src/locators.md index e8335ce2c8..13e58c0a08 100644 --- a/docs/src/locators.md +++ b/docs/src/locators.md @@ -112,7 +112,7 @@ DOM changes in between the calls due to re-render, the new element corresponding locator will be used. ```js -const locator = page.getByRole('button', { name: 'Sign in' }) +const locator = page.getByRole('button', { name: 'Sign in' }); await locator.hover(); await locator.click(); @@ -316,8 +316,8 @@ You can fill the input after locating it by the placeholder text: ```js await page - .getByPlaceholder("name@example.com") - .fill("playwright@microsoft.com"); + .getByPlaceholder('name@example.com') + .fill('playwright@microsoft.com'); ``` ```java @@ -932,9 +932,9 @@ Locators support an option to only select elements that have or have not a desce ```js await page .getByRole('listitem') - .filter({ has: page.getByRole('heading', { name: 'Product 2' })}) + .filter({ has: page.getByRole('heading', { name: 'Product 2' }) }) .getByRole('button', { name: 'Add to cart' }) - .click() + .click(); ``` ```java @@ -1531,9 +1531,9 @@ To take a screenshot of the row with "Mary" and "Say goodbye": const rowLocator = page.getByRole('listitem'); await rowLocator - .filter({ hasText: 'Mary' }) - .filter({ has: page.getByRole('button', { name: 'Say goodbye' }) }) - .screenshot({ path: 'screenshot.png' }); + .filter({ hasText: 'Mary' }) + .filter({ has: page.getByRole('button', { name: 'Say goodbye' }) }) + .screenshot({ path: 'screenshot.png' }); ``` ```python async diff --git a/docs/src/mock-browser-js.md b/docs/src/mock-browser-js.md index 7aed4d6181..fd5af23aa5 100644 --- a/docs/src/mock-browser-js.md +++ b/docs/src/mock-browser-js.md @@ -130,7 +130,7 @@ test('update battery status (no golden)', async ({ page }) => { this.charging = value; this._chargingListeners.forEach(cb => cb()); } - }; + } const mockBattery = new BatteryMock(); // Override the method to always return mock battery info. window.navigator.getBattery = async () => mockBattery; diff --git a/docs/src/network.md b/docs/src/network.md index 4cedd2c3ed..1323329447 100644 --- a/docs/src/network.md +++ b/docs/src/network.md @@ -194,7 +194,7 @@ const browser = await chromium.launch({ }); const context = await browser.newContext({ proxy: { server: 'http://myproxy.com:3128' } -}) +}); ``` ```java @@ -555,8 +555,7 @@ await page.route('**/*.{png,jpg,jpeg}', route => route.abort()); // Abort based on the request type await page.route('**/*', route => { - return route.request().resourceType() === 'image' ? - route.abort() : route.continue(); + return route.request().resourceType() === 'image' ? route.abort() : route.continue(); }); ``` diff --git a/docs/src/other-locators.md b/docs/src/other-locators.md index 166b42ac7a..f3af4e3e8c 100644 --- a/docs/src/other-locators.md +++ b/docs/src/other-locators.md @@ -901,9 +901,9 @@ is equivalent to ```js browser document - .querySelector('article') - .querySelector('.bar > .baz') - .querySelector('span[attr=value]') + .querySelector('article') + .querySelector('.bar > .baz') + .querySelector('span[attr=value]'); ``` If a selector needs to include `>>` in the body, it should be escaped inside a string to not be confused with chaining separator, e.g. `text="some >> text"`. diff --git a/docs/src/pages.md b/docs/src/pages.md index 495d71f8ce..7a6c702056 100644 --- a/docs/src/pages.md +++ b/docs/src/pages.md @@ -195,7 +195,7 @@ If the action that triggers the new page is unknown, the following pattern can b context.on('page', async page => { await page.waitForLoadState(); console.log(await page.title()); -}) +}); ``` ```java @@ -295,7 +295,7 @@ If the action that triggers the popup is unknown, the following pattern can be u page.on('popup', async popup => { await popup.waitForLoadState(); console.log(await popup.title()); -}) +}); ``` ```java diff --git a/docs/src/pom.md b/docs/src/pom.md index 02526c21d4..341f26fdf7 100644 --- a/docs/src/pom.md +++ b/docs/src/pom.md @@ -42,11 +42,11 @@ exports.PlaywrightDevPage = class PlaywrightDevPage { await this.getStarted(); await this.pomLink.click(); } -} +}; ``` ```js tab=js-ts title="playwright-dev-page.ts" -import { expect, Locator, Page } from '@playwright/test'; +import { expect, type Locator, type Page } from '@playwright/test'; export class PlaywrightDevPage { readonly page: Page; @@ -82,7 +82,7 @@ export class PlaywrightDevPage { ```js tab=js-library title="models/PlaywrightDevPage.js" class PlaywrightDevPage { /** - * @param {import('playwright').Page} page + * @param {import('playwright').Page} page */ constructor(page) { this.page = page; diff --git a/docs/src/protractor-js.md b/docs/src/protractor-js.md index 16707900b9..7af633a584 100644 --- a/docs/src/protractor-js.md +++ b/docs/src/protractor-js.md @@ -39,13 +39,13 @@ describe('angularjs homepage todo list', function() { element(by.model('todoList.todoText')).sendKeys('first test'); element(by.css('[value="add"]')).click(); - var todoList = element.all(by.repeater('todo in todoList.todos')); + const todoList = element.all(by.repeater('todo in todoList.todos')); expect(todoList.count()).toEqual(3); expect(todoList.get(2).getText()).toEqual('first test'); // You wrote your first test, cross it off the list todoList.get(2).element(by.css('input')).click(); - var completedAmount = element.all(by.css('.done-true')); + const completedAmount = element.all(by.css('.done-true')); expect(completedAmount.count()).toEqual(2); }); }); @@ -57,14 +57,14 @@ Line-by-line migration to Playwright Test: ```js const { test, expect } = require('@playwright/test'); // 1 -test.describe('angularjs homepage todo list', function() { - test('should add a todo', async function({page}) { // 2, 3 +test.describe('angularjs homepage todo list', () => { + test('should add a todo', async ({ page }) => { // 2, 3 await page.goto('https://angularjs.org'); // 4 await page.locator('[ng-model="todoList.todoText"]').fill('first test'); await page.locator('[value="add"]').click(); - var todoList = page.locator('[ng-repeat="todo in todoList.todos"]'); // 5 + const todoList = page.locator('[ng-repeat="todo in todoList.todos"]'); // 5 await expect(todoList).toHaveCount(3); await expect(todoList.nth(2)).toHaveText('first test', { useInnerText: true, @@ -72,10 +72,10 @@ test.describe('angularjs homepage todo list', function() { // You wrote your first test, cross it off the list await todoList.nth(2).getByRole('textbox').click(); - var completedAmount = page.locator('.done-true'); + const completedAmount = page.locator('.done-true'); await expect(completedAmount).toHaveCount(2); }); -} +}); ``` Migration highlights (see inline comments in the Playwright Test code snippet): @@ -98,23 +98,23 @@ Here's how to polyfill `waitForAngular` function in Playwright Test: ```js async function waitForAngular(page) { - ​const clientSideScripts = require('protractor/built/clientsidescripts.js'); + ​const clientSideScripts = require('protractor/built/clientsidescripts.js'); - ​async function executeScriptAsync(page, script, ...scriptArgs) { - ​await page.evaluate(` - ​new Promise((resolve, reject) => { - ​const callback = (errMessage) => { - ​if (errMessage) - ​reject(new Error(errMessage)); - ​else - ​resolve(); - ​}; - ​(function() {${script}}).apply(null, [...${JSON.stringify(scriptArgs)}, callback]); - ​}) - ​`); - ​} + ​async function executeScriptAsync(page, script, ...scriptArgs) { + ​await page.evaluate(` + ​new Promise((resolve, reject) => { + ​const callback = (errMessage) => { + ​if (errMessage) + ​reject(new Error(errMessage)); + ​else + ​resolve(); + ​}; + ​(function() {${script}}).apply(null, [...${JSON.stringify(scriptArgs)}, callback]); + ​}) + ​`); + ​} - ​await executeScriptAsync(page, clientSideScripts.waitForAngular, ''); + ​await executeScriptAsync(page, clientSideScripts.waitForAngular, ''); } ``` If you don't want to keep a version protractor around, you can also use this simpler approach using this function (only works for Angular 2+): @@ -127,7 +127,7 @@ Here's how to polyfill `waitForAngular` function in Playwright Test: await Promise.all(window.getAllAngularTestabilities().map(whenStable)); // @ts-expect-error async function whenStable(testability) { - return new Promise((res) => testability.whenStable(res) ); + return new Promise(res => testability.whenStable(res)); } } }); diff --git a/docs/src/puppeteer-js.md b/docs/src/puppeteer-js.md index ec8e49a272..b3ac2ca1f8 100644 --- a/docs/src/puppeteer-js.md +++ b/docs/src/puppeteer-js.md @@ -111,7 +111,7 @@ describe('Playwright homepage', () => { it('contains hero title', async () => { await page.goto('https://playwright.dev/'); await page.waitForSelector('.hero__title'); - const text = await page.$eval('.hero__title', (e) => e.textContent); + const text = await page.$eval('.hero__title', e => e.textContent); expect(text).toContain('Playwright enables reliable end-to-end testing'); // 5 }); @@ -128,7 +128,7 @@ test.describe('Playwright homepage', () => { await page.goto('https://playwright.dev/'); const titleLocator = page.locator('.hero__title'); // 4 await expect(titleLocator).toContainText( // 5 - 'Playwright enables reliable end-to-end testing' + 'Playwright enables reliable end-to-end testing' ); }); }); diff --git a/docs/src/release-notes-js.md b/docs/src/release-notes-js.md index fd381400c8..d569965bd7 100644 --- a/docs/src/release-notes-js.md +++ b/docs/src/release-notes-js.md @@ -589,7 +589,11 @@ All the same methods are also available on [Locator], [FrameLocator] and [Frame] - New options `host` and `port` for the html reporter. ```js - reporters: [['html', { host: 'localhost', port: '9223' }]] + import { defineConfig } from '@playwright/test'; + + export default defineConfig({ + reporter: [['html', { host: 'localhost', port: '9223' }]], + }); ``` - New field `FullConfig.configFile` is available to test reporters, specifying the path to the config file if any. @@ -1001,7 +1005,7 @@ WebServer is now considered "ready" if request to the specified url has any of t ```js // Click a button with accessible name "log in" - await page.locator('role=button[name="log in"]').click() + await page.locator('role=button[name="log in"]').click(); ``` Read more in [our documentation](./locators.md#locate-by-role). @@ -1044,7 +1048,7 @@ WebServer is now considered "ready" if request to the specified url has any of t ```js // Click a button with accessible name "log in" - await page.locator('role=button[name="log in"]').click() + await page.locator('role=button[name="log in"]').click(); ``` Read more in [our documentation](./locators.md#locate-by-role). diff --git a/docs/src/service-workers-experimental-network-events-js.md b/docs/src/service-workers-experimental-network-events-js.md index 724e73de89..c11b07f0c1 100644 --- a/docs/src/service-workers-experimental-network-events-js.md +++ b/docs/src/service-workers-experimental-network-events-js.md @@ -128,14 +128,14 @@ Additionally, any network request made by the **Page** (including its sub-[Frame Many Service Worker implementations simply execute the request from the page (possibly with some custom caching/offline logic omitted for simplicity): ```js title="transparent-service-worker.js" -self.addEventListener("fetch", (event) => { +self.addEventListener('fetch', event => { // actually make the request const responsePromise = fetch(event.request); // send it back to the page event.respondWith(responsePromise); }); -self.addEventListener("activate", (event) => { +self.addEventListener('activate', (event) => { event.waitUntil(clients.claim()); }); ``` @@ -180,17 +180,17 @@ Consider the code snippets below to understand Playwright's view into the Reques ```js title="complex-service-worker.js" -self.addEventListener("install", function (event) { +self.addEventListener('install', function (event) { event.waitUntil( - caches.open("v1").then(function (cache) { + caches.open('v1').then(function (cache) { // 1. Pre-fetches and caches /addressbook.json - return cache.add("/addressbook.json"); + return cache.add('/addressbook.json'); }) ); }); // Opt to handle FetchEvent's from the page -self.addEventListener("fetch", (event) => { +self.addEventListener('fetch', (event) => { event.respondWith( (async () => { // 1. Try to first serve directly from caches @@ -198,13 +198,13 @@ self.addEventListener("fetch", (event) => { if (response) return response; // 2. Re-write request for /foo to /bar - if (event.request.url.endsWith("foo")) return fetch("./bar"); + if (event.request.url.endsWith('foo')) return fetch('./bar'); // 3. Prevent tracker.js from being retrieved, and returns a placeholder response - if (event.request.url.endsWith("tracker.js")) - return new Response('console.log("no trackers!")', { + if (event.request.url.endsWith('tracker.js')) + return new Response('console.log('no trackers!')', { status: 200, - headers: { "Content-Type": "text/javascript" }, + headers: { 'Content-Type': 'text/javascript' }, }); // 4. Otherwise, fallthrough, perform the fetch and respond @@ -213,7 +213,7 @@ self.addEventListener("fetch", (event) => { ); }); -self.addEventListener("activate", (event) => { +self.addEventListener('activate', (event) => { event.waitUntil(clients.claim()); }); ``` diff --git a/docs/src/test-api/class-test.md b/docs/src/test-api/class-test.md index 23a457c765..c2330f77f2 100644 --- a/docs/src/test-api/class-test.md +++ b/docs/src/test-api/class-test.md @@ -644,7 +644,7 @@ module.exports = defineConfig({ ```js tab=js-ts title="playwright.config.ts" import { defineConfig } from '@playwright/test'; -import { Options } from './my-test'; +import type { Options } from './my-test'; export default defineConfig({ projects: [ diff --git a/docs/src/test-api/class-testoptions.md b/docs/src/test-api/class-testoptions.md index d812be7cf1..9365c8a32f 100644 --- a/docs/src/test-api/class-testoptions.md +++ b/docs/src/test-api/class-testoptions.md @@ -131,7 +131,7 @@ export default defineConfig({ { name: 'Microsoft Edge', use: { - ...devices['Desktop Edge'], + ...devices['Desktop Edge'], channel: 'msedge' }, }, @@ -355,7 +355,7 @@ export default defineConfig({ projects: [ { name: 'chromium', - use: { + use: { ...devices['Desktop Chrome'], launchOptions: { args: ['--start-maximized'] diff --git a/docs/src/test-assertions-js.md b/docs/src/test-assertions-js.md index d0ac8d9a69..2d50bffa48 100644 --- a/docs/src/test-assertions-js.md +++ b/docs/src/test-assertions-js.md @@ -57,7 +57,7 @@ of the matchers: ```js expect(value).not.toEqual(0); -await expect(locator).not.toContainText("some text"); +await expect(locator).not.toContainText('some text'); ``` ## Soft Assertions diff --git a/docs/src/test-components-js.md b/docs/src/test-components-js.md index 8cd4eb8092..ad3722cf54 100644 --- a/docs/src/test-components-js.md +++ b/docs/src/test-components-js.md @@ -378,7 +378,9 @@ import { defineConfig } from '@playwright/experimental-ct-react'; export default defineConfig({ use: { - ctViteConfig: { ... }, + ctViteConfig: { + // ... + }, }, }); ``` @@ -386,7 +388,7 @@ export default defineConfig({ ### Q) What's the difference between `@playwright/test` and `@playwright/experimental-ct-{react,svelte,vue,solid}`? ```js -test('…', async { mount, page, context } => { +test('…', async ({ mount, page, context }) => { // … }); ``` @@ -560,44 +562,44 @@ export default defineConfig({ Pinia needs to be initialized in `playwright/index.{js,ts,jsx,tsx}`. If you do this inside a `beforeMount` hook, the `initialState` can be overwritten on a per-test basis: ```js title="playwright/index.ts" - import { beforeMount, afterMount } from '@playwright/experimental-ct-vue/hooks'; - import { createTestingPinia } from '@pinia/testing'; - import type { StoreState } from 'pinia'; - import type { useStore } from '../src/store'; +import { beforeMount, afterMount } from '@playwright/experimental-ct-vue/hooks'; +import { createTestingPinia } from '@pinia/testing'; +import type { StoreState } from 'pinia'; +import type { useStore } from '../src/store'; - export type HooksConfig = { - store?: StoreState>; - } +export type HooksConfig = { + store?: StoreState>; +} - beforeMount(async ({ hooksConfig }) => { - createTestingPinia({ - initialState: hooksConfig?.store, - /** - * Use http intercepting to mock api calls instead: - * https://playwright.dev/docs/mock#mock-api-requests - */ - stubActions: false, - createSpy(args) { - console.log('spy', args) - return () => console.log('spy-returns') - }, - }); +beforeMount(async ({ hooksConfig }) => { + createTestingPinia({ + initialState: hooksConfig?.store, + /** + * Use http intercepting to mock api calls instead: + * https://playwright.dev/docs/mock#mock-api-requests + */ + stubActions: false, + createSpy(args) { + console.log('spy', args) + return () => console.log('spy-returns') + }, }); +}); ``` #### In your test file: ```js title="src/pinia.spec.ts" - import { test, expect } from '@playwright/experimental-ct-vue'; - import type { HooksConfig } from '@playwright/test'; - import Store from './Store.vue'; +import { test, expect } from '@playwright/experimental-ct-vue'; +import type { HooksConfig } from '@playwright/test'; +import Store from './Store.vue'; - test('override initialState ', async ({ mount }) => { - const component = await mount(Store, { - hooksConfig: { - store: { name: 'override initialState' } - } - }); - await expect(component).toContainText('override initialState'); +test('override initialState ', async ({ mount }) => { + const component = await mount(Store, { + hooksConfig: { + store: { name: 'override initialState' } + } }); + await expect(component).toContainText('override initialState'); +}); ``` diff --git a/docs/src/test-configuration-js.md b/docs/src/test-configuration-js.md index c9e62717b9..df8595bfe5 100644 --- a/docs/src/test-configuration-js.md +++ b/docs/src/test-configuration-js.md @@ -74,10 +74,10 @@ Filter tests by glob patterns or regular expressions. import { defineConfig } from '@playwright/test'; export default defineConfig({ - // Glob patterns or regular expressions to ignore test files. + // Glob patterns or regular expressions to ignore test files. testIgnore: '*test-assets', - // Glob patterns or regular expressions that match test files. + // Glob patterns or regular expressions that match test files. testMatch: '*todo-tests/*.spec.ts', }); ``` @@ -132,7 +132,7 @@ export default defineConfig({ maxDiffPixels: 10, }, - toMatchSnapshot: { + toMatchSnapshot: { // An acceptable ratio of pixels that are different to the total amount of pixels, between 0 and 1. maxDiffPixelRatio: 0.1, }, diff --git a/docs/src/test-fixtures-js.md b/docs/src/test-fixtures-js.md index 5ef28b941a..d6b0f822e6 100644 --- a/docs/src/test-fixtures-js.md +++ b/docs/src/test-fixtures-js.md @@ -57,7 +57,7 @@ export class TodoPage { } /** - * @param {string} text + * @param {string} text */ async addToDo(text) { await this.inputBox.fill(text); @@ -65,7 +65,7 @@ export class TodoPage { } /** - * @param {string} text + * @param {string} text */ async remove(text) { const todo = this.todoItems.filter({ hasText: text }); @@ -83,7 +83,7 @@ export class TodoPage { ``` ```js tab=js-ts title="todo-page.ts" -import { Page, Locator } from '@playwright/test'; +import type { Page, Locator } from '@playwright/test'; export class TodoPage { private readonly inputBox: Locator; @@ -181,7 +181,7 @@ export class TodoPage { } /** - * @param {string} text + * @param {string} text */ async addToDo(text) { await this.inputBox.fill(text); @@ -189,7 +189,7 @@ export class TodoPage { } /** - * @param {string} text + * @param {string} text */ async remove(text) { const todo = this.todoItems.filter({ hasText: text }); @@ -207,7 +207,7 @@ export class TodoPage { ``` ```js tab=js-ts title="todo-page.ts" -import { Page, Locator } from '@playwright/test'; +import type { Page, Locator } from '@playwright/test'; export class TodoPage { private readonly inputBox: Locator; @@ -323,7 +323,7 @@ export class TodoPage { } /** - * @param {string} text + * @param {string} text */ async addToDo(text) { await this.inputBox.fill(text); @@ -331,7 +331,7 @@ export class TodoPage { } /** - * @param {string} text + * @param {string} text */ async remove(text) { const todo = this.todoItems.filter({ hasText: text }); @@ -349,7 +349,7 @@ export class TodoPage { ``` ```js tab=js-ts title="todo-page.ts" -import { Page, Locator } from '@playwright/test'; +import type { Page, Locator } from '@playwright/test'; export class TodoPage { private readonly inputBox: Locator; @@ -402,7 +402,7 @@ export class SettingsPage { ``` ```js tab=js-ts title="settings-page.ts" -import { Page } from '@playwright/test'; +import type { Page } from '@playwright/test'; export class SettingsPage { constructor(public readonly page: Page) { @@ -766,7 +766,7 @@ export class TodoPage { } /** - * @param {string} text + * @param {string} text */ async addToDo(text) { await this.inputBox.fill(text); @@ -774,7 +774,7 @@ export class TodoPage { } /** - * @param {string} text + * @param {string} text */ async remove(text) { const todo = this.todoItems.filter({ hasText: text }); @@ -792,7 +792,7 @@ export class TodoPage { ``` ```js tab=js-ts title="todo-page.ts" -import { Page, Locator } from '@playwright/test'; +import type { Page, Locator } from '@playwright/test'; export class TodoPage { private readonly inputBox: Locator; @@ -903,7 +903,7 @@ module.exports = defineConfig({ ```js tab=js-ts title="playwright.config.ts" import { defineConfig } from '@playwright/test'; -import { MyOptions } from './my-test'; +import type { MyOptions } from './my-test'; export default defineConfig({ projects: [ diff --git a/docs/src/test-global-setup-teardown-js.md b/docs/src/test-global-setup-teardown-js.md index 53df51edf3..abdcae94ec 100644 --- a/docs/src/test-global-setup-teardown-js.md +++ b/docs/src/test-global-setup-teardown-js.md @@ -71,10 +71,10 @@ export default defineConfig({ }, { name: 'logged in chromium', - use: { ...devices['Desktop Chrome'] }, testMatch: '**/*.loggedin.spec.ts', dependencies: ['setup'], use: { + ...devices['Desktop Chrome'], storageState: STORAGE_STATE, }, }, @@ -115,7 +115,7 @@ test.beforeEach(async ({ page }) => { test('menu', async ({ page }) => { // You are signed in! -}) +}); ``` For a more detailed example check out our blog post: [A better global setup in Playwright reusing login with project dependencies](https://dev.to/playwright/a-better-global-setup-in-playwright-reusing-login-with-project-dependencies-14) or check the [v1.31 release video](https://youtu.be/PI50YAPTAs4) to see the demo. @@ -234,7 +234,7 @@ export default defineConfig({ Here is a global setup example that authenticates once and reuses authentication state in tests. It uses the `baseURL` and `storageState` options from the configuration file. ```js title="global-setup.ts" -import { chromium, FullConfig } from '@playwright/test'; +import { chromium, type FullConfig } from '@playwright/test'; async function globalSetup(config: FullConfig) { const { baseURL, storageState } = config.projects[0].use; @@ -278,7 +278,7 @@ test('test', async ({ page }) => { You can make arbitrary data available in your tests from your global setup file by setting them as environment variables via `process.env`. ```js title="global-setup.ts" -import { FullConfig } from '@playwright/test'; +import type { FullConfig } from '@playwright/test'; async function globalSetup(config: FullConfig) { process.env.FOO = 'some data'; @@ -311,7 +311,7 @@ test('test', async ({ page }) => { In some instances, it may be useful to capture a trace of failures encountered during the global setup. In order to do this, you must [start tracing](./api/class-tracing.md#tracing-start) in your setup, and you must ensure that you [stop tracing](./api/class-tracing.md#tracing-stop) if an error occurs before that error is thrown. This can be achieved by wrapping your setup in a `try...catch` block. Here is an example that expands the global setup example to capture a trace. ```js title="global-setup.ts" -import { chromium, FullConfig } from '@playwright/test'; +import { chromium, type FullConfig } from '@playwright/test'; async function globalSetup(config: FullConfig) { const { baseURL, storageState } = config.projects[0].use; diff --git a/docs/src/test-parallel-js.md b/docs/src/test-parallel-js.md index 823dc50616..4b26515f0d 100644 --- a/docs/src/test-parallel-js.md +++ b/docs/src/test-parallel-js.md @@ -99,7 +99,7 @@ Using serial is not recommended. It is usually better to make your tests isolate ::: ```js -import { test, Page } from '@playwright/test'; +import { test, type Page } from '@playwright/test'; // Annotate entire file as serial. test.describe.configure({ mode: 'serial' }); diff --git a/docs/src/test-projects-js.md b/docs/src/test-projects-js.md index 7f0ed5bf25..dab4e95fd4 100644 --- a/docs/src/test-projects-js.md +++ b/docs/src/test-projects-js.md @@ -44,16 +44,16 @@ export default defineConfig({ /* Test against branded browsers. */ { name: 'Microsoft Edge', - use: { - ...devices['Desktop Edge'], - channel: 'msedge' + use: { + ...devices['Desktop Edge'], + channel: 'msedge' }, }, { name: 'Google Chrome', use: { - ...devices['Desktop Chrome'], - channel: 'chrome' + ...devices['Desktop Chrome'], + channel: 'chrome' }, }, ], diff --git a/docs/src/test-reporter-api/class-reporter.md b/docs/src/test-reporter-api/class-reporter.md index d55172d892..6b782e175a 100644 --- a/docs/src/test-reporter-api/class-reporter.md +++ b/docs/src/test-reporter-api/class-reporter.md @@ -36,7 +36,7 @@ module.exports = MyReporter; ``` ```js tab=js-ts title="my-awesome-reporter.ts" -import { Reporter, FullConfig, Suite, TestCase, TestResult, FullResult } from '@playwright/test/reporter'; +import type { Reporter, FullConfig, Suite, TestCase, TestResult, FullResult } from '@playwright/test/reporter'; class MyReporter implements Reporter { constructor(options: { customOption?: string } = {}) { diff --git a/docs/src/test-reporters-js.md b/docs/src/test-reporters-js.md index 998039b803..c39be9232c 100644 --- a/docs/src/test-reporters-js.md +++ b/docs/src/test-reporters-js.md @@ -289,7 +289,7 @@ export default defineConfig({ You can create a custom reporter by implementing a class with some of the reporter methods. Learn more about the [Reporter] API. ```js title="my-awesome-reporter.ts" -import { FullConfig, FullResult, Reporter, Suite, TestCase, TestResult } from '@playwright/test/reporter'; +import type { FullConfig, FullResult, Reporter, Suite, TestCase, TestResult } from '@playwright/test/reporter'; class MyReporter implements Reporter { onBegin(config: FullConfig, suite: Suite) { diff --git a/docs/src/test-retries-js.md b/docs/src/test-retries-js.md index 8b8eaacb2c..8893b852d3 100644 --- a/docs/src/test-retries-js.md +++ b/docs/src/test-retries-js.md @@ -191,7 +191,7 @@ test('runs second', async () => { ``` ```js tab=js-ts title="example.spec.ts" -import { test, Page } from '@playwright/test'; +import { test, type Page } from '@playwright/test'; test.describe.configure({ mode: 'serial' }); diff --git a/docs/src/test-use-options-js.md b/docs/src/test-use-options-js.md index df1fd9e8bd..fa9f9a1652 100644 --- a/docs/src/test-use-options-js.md +++ b/docs/src/test-use-options-js.md @@ -15,7 +15,7 @@ import { defineConfig } from '@playwright/test'; export default defineConfig({ use: { // Base URL to use in actions like `await page.goto('/')`. - baseURL: 'http://127.0.0.1:3000' + baseURL: 'http://127.0.0.1:3000', // Populates context with given storage state. storageState: 'state.json', @@ -132,8 +132,8 @@ import { defineConfig } from '@playwright/test'; export default defineConfig({ use: { - // Capture screenshot after each test failure. - screenshot: 'only-on-failure' + // Capture screenshot after each test failure. + screenshot: 'only-on-failure', // Record trace only when retrying a test for the first time. trace: 'on-first-retry', @@ -224,11 +224,9 @@ export default defineConfig({ An example test illustrating the initial context options are set: ```js -import { test, expect } from "@playwright/test"; +import { test, expect } from '@playwright/test'; -test('should inherit use options on context when using built-in browser fixture', async ({ - browser, -}) => { +test('should inherit use options on context when using built-in browser fixture', async ({ browser }) => { const context = await browser.newContext(); const page = await context.newPage(); expect(await page.evaluate(() => navigator.userAgent)).toBe('some custom ua'); @@ -261,9 +259,9 @@ export default defineConfig({ projects: [ { name: 'chromium', - use: { - ...devices['Desktop Chrome'], - locale: 'de-DE' + use: { + ...devices['Desktop Chrome'], + locale: 'de-DE', }, }, ], @@ -289,7 +287,7 @@ import { test, expect } from '@playwright/test'; test.describe('french language block', () => { - test.use({ { locale: 'fr-FR' }}); + test.use({ locale: 'fr-FR' }); test('example', async ({ page }) => { // ... diff --git a/docs/src/testing-library-js.md b/docs/src/testing-library-js.md index 93e30a54f2..b84fe65ec4 100644 --- a/docs/src/testing-library-js.md +++ b/docs/src/testing-library-js.md @@ -92,13 +92,13 @@ Playwright includes [assertions](./test-assertions) that automatically wait for ```js // Testing Library await waitFor(() => { - expect(getByText('the lion king')).toBeInTheDocument() -}) -await waitForElementToBeRemoved(() => queryByText('the mummy')) + expect(getByText('the lion king')).toBeInTheDocument(); +}); +await waitForElementToBeRemoved(() => queryByText('the mummy')); // Playwright -await expect(page.getByText('the lion king')).toBeVisible() -await expect(page.getByText('the mummy')).toBeHidden() +await expect(page.getByText('the lion king')).toBeVisible(); +await expect(page.getByText('the mummy')).toBeHidden(); ``` When you cannot find a suitable assertion, use [`expect.poll`](./test-assertions#polling) instead. @@ -116,12 +116,12 @@ You can create a locator inside another locator with [`method: Locator.locator`] ```js // Testing Library -const messages = document.getElementById('messages') -const helloMessage = within(messages).getByText('hello') +const messages = document.getElementById('messages'); +const helloMessage = within(messages).getByText('hello'); // Playwright -const messages = component.locator('id=messages') -const helloMessage = messages.getByText('hello') +const messages = component.locator('id=messages'); +const helloMessage = messages.getByText('hello'); ``` ## Playwright Test Super Powers diff --git a/docs/src/trace-viewer-intro-js.md b/docs/src/trace-viewer-intro-js.md index 85be58602d..ddf7950252 100644 --- a/docs/src/trace-viewer-intro-js.md +++ b/docs/src/trace-viewer-intro-js.md @@ -25,7 +25,7 @@ By default the [playwright.config](/test-configuration.md#record-test-trace) fil import { defineConfig } from '@playwright/test'; export default defineConfig({ retries: process.env.CI ? 2 : 0, // set to 2 when running on CI - ... + // ... use: { trace: 'on-first-retry', // record traces on first retry of each test }, diff --git a/docs/src/videos.md b/docs/src/videos.md index 5a386f07d7..0bc7d1500c 100644 --- a/docs/src/videos.md +++ b/docs/src/videos.md @@ -41,7 +41,7 @@ import { defineConfig } from '@playwright/test'; export default defineConfig({ use: { video: { - mode: 'on-first-retry', + mode: 'on-first-retry', size: { width: 640, height: 480 } } }, diff --git a/docs/src/webview2.md b/docs/src/webview2.md index 06397e04a6..033bee166d 100644 --- a/docs/src/webview2.md +++ b/docs/src/webview2.md @@ -96,7 +96,7 @@ export const test = base.extend({ })); const browser = await playwright.chromium.connectOverCDP(`http://127.0.0.1:${cdpPort}`); await use(browser); - await browser.close() + await browser.close(); childProcess.execSync(`taskkill /pid ${webView2Process.pid} /T /F`); fs.rmdirSync(userDataDir, { recursive: true }); }, diff --git a/docs/src/writing-tests-js.md b/docs/src/writing-tests-js.md index ef489c9118..cad8e0861a 100644 --- a/docs/src/writing-tests-js.md +++ b/docs/src/writing-tests-js.md @@ -154,7 +154,8 @@ Playwright Test is based on the concept of [test fixtures](./test-fixtures.md) s ```js title="tests/example.spec.ts" test('basic test', async ({ page }) => { - ... + // ... +}); ``` ### Using Test Hooks @@ -162,17 +163,17 @@ test('basic test', async ({ page }) => { You can use various [test hooks](./api/class-test.md) such as `test.describe` to declare a group of tests and `test.beforeEach` and `test.afterEach` which are executed before/after each test. Other hooks include the `test.beforeAll` and `test.afterAll` which are executed once per worker before/after all tests. ```js title="tests/example.spec.ts" -import { test, expect } from "@playwright/test"; +import { test, expect } from '@playwright/test'; -test.describe("navigation", () => { +test.describe('navigation', () => { test.beforeEach(async ({ page }) => { // Go to the starting url before each test. - await page.goto("https://playwright.dev/"); + await page.goto('https://playwright.dev/'); }); - test("main navigation", async ({ page }) => { + test('main navigation', async ({ page }) => { // Assertions use the expect API. - await expect(page).toHaveURL("https://playwright.dev/"); + await expect(page).toHaveURL('https://playwright.dev/'); }); }); ``` diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts index 8137fed0fd..6aefe158a9 100644 --- a/packages/playwright-core/types/types.d.ts +++ b/packages/playwright-core/types/types.d.ts @@ -45,7 +45,7 @@ type ElementHandleWaitForSelectorOptionsNotHidden = ElementHandleWaitForSelector * const context = await browser.newContext(); * const page = await context.newPage(); * await page.goto('https://example.com'); - * await page.screenshot({path: 'screenshot.png'}); + * await page.screenshot({ path: 'screenshot.png' }); * await browser.close(); * })(); * ``` @@ -112,7 +112,7 @@ export interface Page { * * ```js * const bodyHandle = await page.evaluate('document.body'); - * const html = await page.evaluate(([body, suffix]) => body.innerHTML + suffix, [bodyHandle, 'hello']); + * const html = await page.evaluate(([body, suffix]) => body.innerHTML + suffix, [bodyHandle, 'hello']); * await bodyHandle.dispose(); * ``` * @@ -159,7 +159,7 @@ export interface Page { * * ```js * const bodyHandle = await page.evaluate('document.body'); - * const html = await page.evaluate(([body, suffix]) => body.innerHTML + suffix, [bodyHandle, 'hello']); + * const html = await page.evaluate(([body, suffix]) => body.innerHTML + suffix, [bodyHandle, 'hello']); * await bodyHandle.dispose(); * ``` * @@ -186,8 +186,8 @@ export interface Page { * **Usage** * * ```js + * // Handle for the window object. * const aWindowHandle = await page.evaluateHandle(() => Promise.resolve(window)); - * aWindowHandle; // Handle for the window object. * ``` * * A string can also be passed in instead of a function: @@ -228,8 +228,8 @@ export interface Page { * **Usage** * * ```js + * // Handle for the window object. * const aWindowHandle = await page.evaluateHandle(() => Promise.resolve(window)); - * aWindowHandle; // Handle for the window object. * ``` * * A string can also be passed in instead of a function: @@ -559,7 +559,7 @@ export interface Page { * const browser = await webkit.launch(); * const page = await browser.newPage(); * const watchDog = page.waitForFunction(() => window.innerWidth < 100); - * await page.setViewportSize({width: 50, height: 50}); + * await page.setViewportSize({ width: 50, height: 50 }); * await watchDog; * await browser.close(); * })(); @@ -595,7 +595,7 @@ export interface Page { * const browser = await webkit.launch(); * const page = await browser.newPage(); * const watchDog = page.waitForFunction(() => window.innerWidth < 100); - * await page.setViewportSize({width: 50, height: 50}); + * await page.setViewportSize({ width: 50, height: 50 }); * await watchDog; * await browser.close(); * })(); @@ -641,7 +641,7 @@ export interface Page { * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); - * for (let currentURL of ['https://google.com', 'https://bbc.com']) { + * for (const currentURL of ['https://google.com', 'https://bbc.com']) { * await page.goto(currentURL); * const element = await page.waitForSelector('img'); * console.log('Loaded image: ' + await element.getAttribute('src')); @@ -679,7 +679,7 @@ export interface Page { * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); - * for (let currentURL of ['https://google.com', 'https://bbc.com']) { + * for (const currentURL of ['https://google.com', 'https://bbc.com']) { * await page.goto(currentURL); * const element = await page.waitForSelector('img'); * console.log('Loaded image: ' + await element.getAttribute('src')); @@ -717,7 +717,7 @@ export interface Page { * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); - * for (let currentURL of ['https://google.com', 'https://bbc.com']) { + * for (const currentURL of ['https://google.com', 'https://bbc.com']) { * await page.goto(currentURL); * const element = await page.waitForSelector('img'); * console.log('Loaded image: ' + await element.getAttribute('src')); @@ -755,7 +755,7 @@ export interface Page { * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); - * for (let currentURL of ['https://google.com', 'https://bbc.com']) { + * for (const currentURL of ['https://google.com', 'https://bbc.com']) { * await page.goto(currentURL); * const element = await page.waitForSelector('img'); * console.log('Loaded image: ' + await element.getAttribute('src')); @@ -977,7 +977,7 @@ export interface Page { * that can be uploaded after that. * * ```js - * page.on('filechooser', async (fileChooser) => { + * page.on('filechooser', async fileChooser => { * await fileChooser.setFiles('/tmp/myfile.pdf'); * }); * ``` @@ -1273,7 +1273,7 @@ export interface Page { * that can be uploaded after that. * * ```js - * page.on('filechooser', async (fileChooser) => { + * page.on('filechooser', async fileChooser => { * await fileChooser.setFiles('/tmp/myfile.pdf'); * }); * ``` @@ -1664,7 +1664,7 @@ export interface Page { * that can be uploaded after that. * * ```js - * page.on('filechooser', async (fileChooser) => { + * page.on('filechooser', async fileChooser => { * await fileChooser.setFiles('/tmp/myfile.pdf'); * }); * ``` @@ -2557,8 +2557,8 @@ export interface Page { * * ```js * await page - * .getByPlaceholder("name@example.com") - * .fill("playwright@microsoft.com"); + * .getByPlaceholder('name@example.com') + * .fill('playwright@microsoft.com'); * ``` * * @param text Text to locate the element for. @@ -2705,9 +2705,13 @@ export interface Page { * * ```js * // Set custom test id attribute from @playwright/test config: - * use: { - * testIdAttribute: 'data-pw' - * } + * import { defineConfig } from '@playwright/test'; + * + * export default defineConfig({ + * use: { + * testIdAttribute: 'data-pw' + * }, + * }); * ``` * * @param testId Id to locate the element by. @@ -2733,19 +2737,19 @@ export interface Page { * * ```js * // Matches - * page.getByText('world') + * page.getByText('world'); * * // Matches first
- * page.getByText('Hello world') + * page.getByText('Hello world'); * * // Matches second
- * page.getByText('Hello', { exact: true }) + * page.getByText('Hello', { exact: true }); * * // Matches both
s - * page.getByText(/Hello/) + * page.getByText(/Hello/); * * // Matches second
- * page.getByText(/^hello$/i) + * page.getByText(/^hello$/i); * ``` * * **Details** @@ -3295,8 +3299,8 @@ export interface Page { * * ```js * // Generates a PDF with 'screen' media type. - * await page.emulateMedia({media: 'screen'}); - * await page.pdf({path: 'page.pdf'}); + * await page.emulateMedia({ media: 'screen' }); + * await page.pdf({ path: 'page.pdf' }); * ``` * * The `width`, `height`, and `margin` options accept values labeled with units. Unlabeled values are treated as @@ -4105,7 +4109,7 @@ export interface Page { * * ```js * await page.type('#mytextarea', 'Hello'); // Types instantly - * await page.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user + * await page.type('#mytextarea', 'World', { delay: 100 }); // Types slower, like a user * ``` * * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be @@ -4321,7 +4325,7 @@ export interface Page { * that can be uploaded after that. * * ```js - * page.on('filechooser', async (fileChooser) => { + * page.on('filechooser', async fileChooser => { * await fileChooser.setFiles('/tmp/myfile.pdf'); * }); * ``` @@ -4719,9 +4723,8 @@ export interface Page { * * function dumpFrameTree(frame, indent) { * console.log(indent + frame.url()); - * for (const child of frame.childFrames()) { + * for (const child of frame.childFrames()) * dumpFrameTree(child, indent + ' '); - * } * } * })(); * ``` @@ -4833,8 +4836,8 @@ export interface Frame { * **Usage** * * ```js + * // Handle for the window object * const aWindowHandle = await frame.evaluateHandle(() => Promise.resolve(window)); - * aWindowHandle; // Handle for the window object. * ``` * * A string can also be passed in instead of a function. @@ -4875,8 +4878,8 @@ export interface Frame { * **Usage** * * ```js + * // Handle for the window object * const aWindowHandle = await frame.evaluateHandle(() => Promise.resolve(window)); - * aWindowHandle; // Handle for the window object. * ``` * * A string can also be passed in instead of a function. @@ -5192,7 +5195,7 @@ export interface Frame { * const browser = await firefox.launch(); * const page = await browser.newPage(); * const watchDog = page.mainFrame().waitForFunction('window.innerWidth < 100'); - * await page.setViewportSize({width: 50, height: 50}); + * await page.setViewportSize({ width: 50, height: 50 }); * await watchDog; * await browser.close(); * })(); @@ -5226,7 +5229,7 @@ export interface Frame { * const browser = await firefox.launch(); * const page = await browser.newPage(); * const watchDog = page.mainFrame().waitForFunction('window.innerWidth < 100'); - * await page.setViewportSize({width: 50, height: 50}); + * await page.setViewportSize({ width: 50, height: 50 }); * await watchDog; * await browser.close(); * })(); @@ -5270,7 +5273,7 @@ export interface Frame { * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); - * for (let currentURL of ['https://google.com', 'https://bbc.com']) { + * for (const currentURL of ['https://google.com', 'https://bbc.com']) { * await page.goto(currentURL); * const element = await page.mainFrame().waitForSelector('img'); * console.log('Loaded image: ' + await element.getAttribute('src')); @@ -5308,7 +5311,7 @@ export interface Frame { * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); - * for (let currentURL of ['https://google.com', 'https://bbc.com']) { + * for (const currentURL of ['https://google.com', 'https://bbc.com']) { * await page.goto(currentURL); * const element = await page.mainFrame().waitForSelector('img'); * console.log('Loaded image: ' + await element.getAttribute('src')); @@ -5346,7 +5349,7 @@ export interface Frame { * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); - * for (let currentURL of ['https://google.com', 'https://bbc.com']) { + * for (const currentURL of ['https://google.com', 'https://bbc.com']) { * await page.goto(currentURL); * const element = await page.mainFrame().waitForSelector('img'); * console.log('Loaded image: ' + await element.getAttribute('src')); @@ -5384,7 +5387,7 @@ export interface Frame { * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); - * for (let currentURL of ['https://google.com', 'https://bbc.com']) { + * for (const currentURL of ['https://google.com', 'https://bbc.com']) { * await page.goto(currentURL); * const element = await page.mainFrame().waitForSelector('img'); * console.log('Loaded image: ' + await element.getAttribute('src')); @@ -6019,8 +6022,8 @@ export interface Frame { * * ```js * await page - * .getByPlaceholder("name@example.com") - * .fill("playwright@microsoft.com"); + * .getByPlaceholder('name@example.com') + * .fill('playwright@microsoft.com'); * ``` * * @param text Text to locate the element for. @@ -6167,9 +6170,13 @@ export interface Frame { * * ```js * // Set custom test id attribute from @playwright/test config: - * use: { - * testIdAttribute: 'data-pw' - * } + * import { defineConfig } from '@playwright/test'; + * + * export default defineConfig({ + * use: { + * testIdAttribute: 'data-pw' + * }, + * }); * ``` * * @param testId Id to locate the element by. @@ -6195,19 +6202,19 @@ export interface Frame { * * ```js * // Matches - * page.getByText('world') + * page.getByText('world'); * * // Matches first
- * page.getByText('Hello world') + * page.getByText('Hello world'); * * // Matches second
- * page.getByText('Hello', { exact: true }) + * page.getByText('Hello', { exact: true }); * * // Matches both
s - * page.getByText(/Hello/) + * page.getByText(/Hello/); * * // Matches second
- * page.getByText(/^hello$/i) + * page.getByText(/^hello$/i); * ``` * * **Details** @@ -7106,7 +7113,7 @@ export interface Frame { * * ```js * await frame.type('#mytextarea', 'Hello'); // Types instantly - * await frame.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user + * await frame.type('#mytextarea', 'World', { delay: 100 }); // Types slower, like a user * ``` * * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be @@ -8423,7 +8430,7 @@ export interface BrowserContext { * **Usage** * * ```js - * await browserContext.setGeolocation({latitude: 59.95, longitude: 30.31667}); + * await browserContext.setGeolocation({ latitude: 59.95, longitude: 30.31667 }); * ``` * * **NOTE** Consider using @@ -8904,7 +8911,7 @@ export interface JSHandle { * **Usage** * * ```js - * const handle = await page.evaluateHandle(() => ({window, document})); + * const handle = await page.evaluateHandle(() => ({ window, document })); * const properties = await handle.getProperties(); * const windowHandle = properties.get('window'); * const documentHandle = properties.get('document'); @@ -10200,7 +10207,7 @@ export interface ElementHandle extends JSHandle { * * ```js * await elementHandle.type('Hello'); // Types instantly - * await elementHandle.type('World', {delay: 100}); // Types slower, like a user + * await elementHandle.type('World', { delay: 100 }); // Types slower, like a user * ``` * * An example of typing into a text field and then submitting the form: @@ -11241,8 +11248,8 @@ export interface Locator { * * ```js * await page - * .getByPlaceholder("name@example.com") - * .fill("playwright@microsoft.com"); + * .getByPlaceholder('name@example.com') + * .fill('playwright@microsoft.com'); * ``` * * @param text Text to locate the element for. @@ -11389,9 +11396,13 @@ export interface Locator { * * ```js * // Set custom test id attribute from @playwright/test config: - * use: { - * testIdAttribute: 'data-pw' - * } + * import { defineConfig } from '@playwright/test'; + * + * export default defineConfig({ + * use: { + * testIdAttribute: 'data-pw' + * }, + * }); * ``` * * @param testId Id to locate the element by. @@ -11417,19 +11428,19 @@ export interface Locator { * * ```js * // Matches - * page.getByText('world') + * page.getByText('world'); * * // Matches first
- * page.getByText('Hello world') + * page.getByText('Hello world'); * * // Matches second
- * page.getByText('Hello', { exact: true }) + * page.getByText('Hello', { exact: true }); * * // Matches both
s - * page.getByText(/Hello/) + * page.getByText(/Hello/); * * // Matches second
- * page.getByText(/^hello$/i) + * page.getByText(/^hello$/i); * ``` * * **Details** @@ -12282,7 +12293,7 @@ export interface Locator { * * ```js * await element.type('Hello'); // Types instantly - * await element.type('World', {delay: 100}); // Types slower, like a user + * await element.type('World', { delay: 100 }); // Types slower, like a user * ``` * * An example of typing into a text field and then submitting the form: @@ -13204,12 +13215,12 @@ export namespace errors { * const context = await browser.newContext(); * const page = await context.newPage(); * try { - * await page.locator("text=Foo").click({ + * await page.locator('text=Foo').click({ * timeout: 100, - * }) + * }); * } catch (error) { * if (error instanceof playwright.errors.TimeoutError) - * console.log("Timeout!") + * console.log('Timeout!'); * } * await browser.close(); * })(); @@ -13517,11 +13528,11 @@ export interface ElectronApplication { * **Usage** * * ```js - * const electronApp = await electron.launch({ - * args: ['main.js'] - * }); - * const window = await electronApp.firstWindow(); - * // ... + * const electronApp = await electron.launch({ + * args: ['main.js'] + * }); + * const window = await electronApp.firstWindow(); + * // ... * ``` * * @param options @@ -16305,7 +16316,7 @@ export interface Browser extends EventEmitter { * **Usage** * * ```js - * await browser.startTracing(page, {path: 'trace.json'}); + * await browser.startTracing(page, { path: 'trace.json' }); * await page.goto('https://www.google.com'); * await browser.stopTracing(); * ``` @@ -16409,7 +16420,7 @@ export interface BrowserServer { * * ```js * // Listen for all console logs - * page.on('console', msg => console.log(msg.text())) + * page.on('console', msg => console.log(msg.text())); * * // Listen for all console events and handle errors * page.on('console', msg => { @@ -16425,8 +16436,8 @@ export interface BrowserServer { * const msg = await msgPromise; * * // Deconstruct console log arguments - * await msg.args()[0].jsonValue() // hello - * await msg.args()[1].jsonValue() // 42 + * await msg.args()[0].jsonValue(); // hello + * await msg.args()[1].jsonValue(); // 42 * ``` * */ @@ -16483,7 +16494,7 @@ export interface ConsoleMessage { * const { chromium } = require('playwright'); * const v8toIstanbul = require('v8-to-istanbul'); * - * (async() => { + * (async () => { * const browser = await chromium.launch(); * const page = await browser.newPage(); * await page.coverage.startJSCoverage(); @@ -17188,8 +17199,8 @@ export interface FrameLocator { * * ```js * await page - * .getByPlaceholder("name@example.com") - * .fill("playwright@microsoft.com"); + * .getByPlaceholder('name@example.com') + * .fill('playwright@microsoft.com'); * ``` * * @param text Text to locate the element for. @@ -17336,9 +17347,13 @@ export interface FrameLocator { * * ```js * // Set custom test id attribute from @playwright/test config: - * use: { - * testIdAttribute: 'data-pw' - * } + * import { defineConfig } from '@playwright/test'; + * + * export default defineConfig({ + * use: { + * testIdAttribute: 'data-pw' + * }, + * }); * ``` * * @param testId Id to locate the element by. @@ -17364,19 +17379,19 @@ export interface FrameLocator { * * ```js * // Matches - * page.getByText('world') + * page.getByText('world'); * * // Matches first
- * page.getByText('Hello world') + * page.getByText('Hello world'); * * // Matches second
- * page.getByText('Hello', { exact: true }) + * page.getByText('Hello', { exact: true }); * * // Matches both
s - * page.getByText(/Hello/) + * page.getByText(/Hello/); * * // Matches second
- * page.getByText(/^hello$/i) + * page.getByText(/^hello$/i); * ``` * * **Details** @@ -17627,7 +17642,7 @@ export interface Keyboard { * * ```js * await page.keyboard.type('Hello'); // Types instantly - * await page.keyboard.type('World', {delay: 100}); // Types slower, like a user + * await page.keyboard.type('World', { delay: 100 }); // Types slower, like a user * ``` * * **NOTE** Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case. @@ -17663,7 +17678,7 @@ export interface Keyboard { * log: (name, severity, message, args) => console.log(`${name} ${message}`) * } * }); - * ... + * // ... * })(); * ``` * @@ -18309,7 +18324,7 @@ export interface Route { * foo: 'foo-value', // set "foo" header * bar: undefined, // remove "bar" header * }; - * route.continue({headers}); + * route.continue({ headers }); * }); * ``` * @@ -18403,7 +18418,7 @@ export interface Route { * foo: 'foo-value', // set "foo" header * bar: undefined, // remove "bar" header * }; - * route.fallback({headers}); + * route.fallback({ headers }); * }); * ``` * diff --git a/packages/playwright-test/types/test.d.ts b/packages/playwright-test/types/test.d.ts index 71f8f55e5d..717c16903e 100644 --- a/packages/playwright-test/types/test.d.ts +++ b/packages/playwright-test/types/test.d.ts @@ -3322,7 +3322,7 @@ export interface TestType({ * projects: [ @@ -5573,8 +5573,8 @@ interface LocatorAssertions { * ``` * * ```js - * const locator = page.locator("id=favorite-colors"); - * await locator.selectOption(["R", "G"]); + * const locator = page.locator('id=favorite-colors'); + * await locator.selectOption(['R', 'G']); * await expect(locator).toHaveValues([/R/, /G/]); * ``` * diff --git a/packages/playwright-test/types/testReporter.d.ts b/packages/playwright-test/types/testReporter.d.ts index b1a12e05b7..50a122fbd4 100644 --- a/packages/playwright-test/types/testReporter.d.ts +++ b/packages/playwright-test/types/testReporter.d.ts @@ -316,7 +316,7 @@ export interface FullResult { * * ```js * // my-awesome-reporter.ts - * import { Reporter, FullConfig, Suite, TestCase, TestResult, FullResult } from '@playwright/test/reporter'; + * import type { Reporter, FullConfig, Suite, TestCase, TestResult, FullResult } from '@playwright/test/reporter'; * * class MyReporter implements Reporter { * constructor(options: { customOption?: string } = {}) { diff --git a/tests/components/ct-svelte/playwright/index.ts b/tests/components/ct-svelte/playwright/index.ts index fa00674fde..fe89c98e10 100644 --- a/tests/components/ct-svelte/playwright/index.ts +++ b/tests/components/ct-svelte/playwright/index.ts @@ -1,4 +1,4 @@ -//@ts-check +// @ts-check import '../src/assets/index.css'; import { beforeMount, afterMount } from '@playwright/experimental-ct-svelte/hooks';