diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.md index c54f6f9130..747df53999 100644 --- a/docs/src/api/class-page.md +++ b/docs/src/api/class-page.md @@ -4162,7 +4162,7 @@ Returns when element specified by selector satisfies [`option: state`] option. R :::note Playwright automatically waits for element to be ready before performing an action. Using -[Locator] objects and web-first assertions makes the code wait-for-selector-free. +[Locator] objects and web-first assertions make the code wait-for-selector-free. ::: Wait for the [`param: selector`] to satisfy [`option: state`] option (either appear/disappear from dom, or become diff --git a/docs/src/browser-contexts.md b/docs/src/browser-contexts.md index 0fa80a8843..e54c5b6030 100644 --- a/docs/src/browser-contexts.md +++ b/docs/src/browser-contexts.md @@ -1,6 +1,6 @@ --- -id: isolation -title: "Isolation" +id: browser-contexts +title: "Browser Contexts" --- diff --git a/docs/src/ci-intro-js.md b/docs/src/ci-intro-js.md index 9d81c35843..9958177b36 100644 --- a/docs/src/ci-intro-js.md +++ b/docs/src/ci-intro-js.md @@ -11,8 +11,8 @@ When installing Playwright you are given the option to add a [GitHub Actions](ht - [How to create a repo and push to GitHub](#create-a-repo-and-push-to-github) - [How to open the workflows](#opening-the-workflows) - [How to view the test logs](#viewing-test-logs) -- [How to download the report from GitHub](#downloading-the-html-report) -- [How to view the report](#viewing-the-html-report) +- [How to download the report from GitHub](#downloading-the-playwright-report) +- [How to view the report](#viewing-the-playwright-report) - [How to view the trace](#viewing-the-trace) ## GitHub Actions diff --git a/docs/src/intro-csharp.md b/docs/src/intro-csharp.md index 1fe8423baa..6f5aeb6a44 100644 --- a/docs/src/intro-csharp.md +++ b/docs/src/intro-csharp.md @@ -132,7 +132,6 @@ using Microsoft.Playwright.MSTest; namespace PlaywrightTests; -[TestClass] public class UnitTest1 : PageTest { [TestMethod] diff --git a/docs/src/library-csharp.md b/docs/src/library-csharp.md index d0c4c69f6d..e0f737c492 100644 --- a/docs/src/library-csharp.md +++ b/docs/src/library-csharp.md @@ -34,10 +34,7 @@ using var playwright = await Playwright.CreateAsync(); await using var browser = await playwright.Chromium.LaunchAsync(); var page = await browser.NewPageAsync(); await page.GotoAsync("https://playwright.dev/dotnet"); -await page.ScreenshotAsync(new() -{ - Path = "screenshot.png" -}); +await page.ScreenshotAsync(new PageScreenshotOptions { Path = "screenshot.png" }); ``` Now run it. diff --git a/docs/src/library-js.md b/docs/src/library-js.md index 3cebaadcb2..e4925db6f9 100644 --- a/docs/src/library-js.md +++ b/docs/src/library-js.md @@ -117,7 +117,6 @@ The key differences to note are as follows: | | Library | Test | | - | - | - | | Installation | `npm install playwright` | `npm init playwright@latest` (note `install` vs. `init`) | -| Install browsers | Chromium, Firefox, WebKit are installed by default | `npx playwright install` or `npx playwright install chromium` for a single one | | `import`/`require` name | `playwright` | `@playwright/test` | | Initialization | Explicitly need to:
  1. Pick a browser to use (e.g. `chromium`)
  2. Create `browser` ([`method: BrowserType.launch`])
  3. Create a `context` ([`method: Browser.newContext`]), and pass any context options explcitly (e.g. `devices['iPhone 11']`
  4. Create a `page` ([`method: BrowserContext.newPage`])
| An isolated `page` and `context` are provided to each test out-of the box (along with any other [built-in fixtures](./test-fixtures.md#built-in-fixtures)). No explicit creation. If referenced by the test in it's arguments, the Test Runner will create them for the test. (i.e. lazy-initialization) | | Assertions | No built-in Web-First Assertions | [Web-First assertions](./test-assertions.md) like: which auto-wait and retry for the condition to be met.| diff --git a/docs/src/test-advanced-js.md b/docs/src/test-advanced-js.md index 6c6f4ba166..3d7f35cd38 100644 --- a/docs/src/test-advanced-js.md +++ b/docs/src/test-advanced-js.md @@ -681,9 +681,7 @@ test('numeric ranges', () => { }); ``` -For TypeScript, also add the following to your [`global.d.ts`](https://www.typescriptlang.org/docs/handbook/declaration-files/templates/global-d-ts.html). If it does not exist, you need to create it inside your repository. Make sure that your `global.d.ts` gets included inside your `tsconfig.json` via the `include` or `compilerOptions.typeRoots` option so that your IDE will pick it up. - -You don't need it for JavaScript. +For TypeScript, also add the following to `global.d.ts`. You don't need it for JavaScript. ```js // global.d.ts diff --git a/docs/src/trace-viewer-intro-js.md b/docs/src/trace-viewer-intro-js.md index 8af91af2ec..8f04e7082a 100644 --- a/docs/src/trace-viewer-intro-js.md +++ b/docs/src/trace-viewer-intro-js.md @@ -14,7 +14,7 @@ Playwright Trace Viewer is a GUI tool that lets you explore recorded Playwright ## Recording a Trace -By default the [playwright.config](/test-configuration.md#record-test-trace) file will contain the configuration needed to create a `trace.zip` file for each test. Traces are setup to run `on-first-retry` meaning they will be run on the first retry of a failed test. Also `retries` are set to 2 when running on CI and 0 locally. This means the traces will be recorded on the first retry of a failed test but not on the first run and not on the second retry. +By default the [playwright.config](/test-configuration.md#record-test-trace) file will contain the configuration needed to create a `trace.zip` file for each test. Traces are setup to run `on-first-retry` meaning they will be run on the first retry of a failed test. Also `retires` are set to 2 when running on CI and 0 locally. This means the traces will be recorded on the first retry of a failed test but not on the first run and not on the second retry. ```js tab=js-js // @ts-check diff --git a/docs/src/writing-tests-csharp.md b/docs/src/writing-tests-csharp.md index e9bb085a9d..b3e3aed8c2 100644 --- a/docs/src/writing-tests-csharp.md +++ b/docs/src/writing-tests-csharp.md @@ -58,7 +58,6 @@ using Microsoft.Playwright.MSTest; namespace PlaywrightTests; -[TestClass] public class UnitTest1 : PageTest { [TestMethod] @@ -154,7 +153,6 @@ using Microsoft.Playwright.MSTest; namespace PlaywrightTests; -[TestClass] public class UnitTest1 : PageTest { [TestMethod] @@ -215,7 +213,6 @@ using Microsoft.Playwright.MSTest; namespace PlaywrightTests; -[TestClass] public class UnitTest1 : PageTest { [TestMethod] diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts index 3dd3062dbc..c85c16b037 100644 --- a/packages/playwright-core/types/types.d.ts +++ b/packages/playwright-core/types/types.d.ts @@ -593,7 +593,7 @@ export interface Page { * `detached`. * * > NOTE: Playwright automatically waits for element to be ready before performing an action. Using [Locator] objects and - * web-first assertions makes the code wait-for-selector-free. + * web-first assertions make the code wait-for-selector-free. * * Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at * the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the @@ -625,7 +625,7 @@ export interface Page { * `detached`. * * > NOTE: Playwright automatically waits for element to be ready before performing an action. Using [Locator] objects and - * web-first assertions makes the code wait-for-selector-free. + * web-first assertions make the code wait-for-selector-free. * * Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at * the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the @@ -657,7 +657,7 @@ export interface Page { * `detached`. * * > NOTE: Playwright automatically waits for element to be ready before performing an action. Using [Locator] objects and - * web-first assertions makes the code wait-for-selector-free. + * web-first assertions make the code wait-for-selector-free. * * Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at * the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the @@ -689,7 +689,7 @@ export interface Page { * `detached`. * * > NOTE: Playwright automatically waits for element to be ready before performing an action. Using [Locator] objects and - * web-first assertions makes the code wait-for-selector-free. + * web-first assertions make the code wait-for-selector-free. * * Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at * the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the