docs: update channels doc to mention manual installation (#5964)

This commit is contained in:
Dmitry Gozman 2021-03-26 10:20:21 -07:00 committed by GitHub
parent 6c1d3f65b5
commit 12e00629e4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 10 additions and 5 deletions

View File

@ -181,7 +181,7 @@ Whether to run browser in headless mode. More details for
### option: BrowserType.launch.channel ### option: BrowserType.launch.channel
- `channel` <[BrowserChannel]<"chrome"|"chrome-beta"|"chrome-dev"|"chrome-canary"|"msedge"|"msedge-beta"|"msedge-dev"|"msedge-canary">> - `channel` <[BrowserChannel]<"chrome"|"chrome-beta"|"chrome-dev"|"chrome-canary"|"msedge"|"msedge-beta"|"msedge-dev"|"msedge-canary">>
Browser distribution channel. Browser distribution channel. Read more about using [Google Chrome and Microsoft Edge](./browsers#google-chrome--microsoft-edge).
### option: BrowserType.launch.executablePath ### option: BrowserType.launch.executablePath
- `executablePath` <[path]> - `executablePath` <[path]>

View File

@ -17,7 +17,7 @@ when the world is on Google Chrome 89, Playwright already supports Chromium 91 t
if a few weeks. if a few weeks.
There is also a way to opt into using Google Chrome's or Microsoft Edge's branded builds for testing. For details There is also a way to opt into using Google Chrome's or Microsoft Edge's branded builds for testing. For details
on when to opt into stable channels, refer to the [Google Chrome & Microsoft Edge section below.](#google-chrome--microsoft-edge) section below. on when to opt into stable channels, refer to the [Google Chrome & Microsoft Edge](#google-chrome--microsoft-edge) section below.
## Firefox ## Firefox
@ -33,7 +33,7 @@ also working on a dedicated support for builds that would match Apple Safari Tec
## Google Chrome & Microsoft Edge ## Google Chrome & Microsoft Edge
While Playwright will download and use the recent Chromium build by default, it can operate against the stock Google While Playwright will download and use the recent Chromium build by default, it can operate against the stock Google
Chrome and Microsoft Edge browsers. In particular, current Playwright version will support Stable and Beta channels Chrome and Microsoft Edge browsers available on the machine. In particular, current Playwright version will support Stable and Beta channels
of these browsers. Here is how you can opt into using the stock browser: of these browsers. Here is how you can opt into using the stock browser:
```js ```js
@ -67,6 +67,10 @@ browser = await playwright.chromium.launch(channel="chrome")
browser = playwright.chromium.launch(channel="chrome") browser = playwright.chromium.launch(channel="chrome")
``` ```
:::note
Playwright bundles a recent Chromium build, but not Google Chrome or Microsoft Edge browsers - these should be installed manually before use.
:::
### When to use Google Chrome & Microsoft Edge and when not to? ### When to use Google Chrome & Microsoft Edge and when not to?
**Defaults** **Defaults**

2
package-lock.json generated
View File

@ -1,6 +1,6 @@
{ {
"name": "playwright-internal", "name": "playwright-internal",
"version": "1.10.0-next", "version": "1.11.0-next",
"lockfileVersion": 1, "lockfileVersion": 1,
"requires": true, "requires": true,
"dependencies": { "dependencies": {

3
types/types.d.ts vendored
View File

@ -10648,7 +10648,8 @@ export interface LaunchOptions {
args?: Array<string>; args?: Array<string>;
/** /**
* Browser distribution channel. * Browser distribution channel. Read more about using
* [Google Chrome and Microsoft Edge](https://playwright.dev/docs/browsers#google-chrome--microsoft-edge).
*/ */
channel?: "chrome"|"chrome-beta"|"chrome-dev"|"chrome-canary"|"msedge"|"msedge-beta"|"msedge-dev"|"msedge-canary"; channel?: "chrome"|"chrome-beta"|"chrome-dev"|"chrome-canary"|"msedge"|"msedge-beta"|"msedge-dev"|"msedge-canary";