Skip to content

Commit 1865058

Browse files
authored
docs(browsers.md): updates and nits
1 parent 2d68830 commit 1865058

File tree

1 file changed

+20
-8
lines changed

1 file changed

+20
-8
lines changed

docs/browsers.md

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,23 @@
11
# Managing browser binaries
22

3-
Playwright comes bundled with browsers, and by default `npm i playwright` downloads
4-
all 3 browsers inside the `node_modules/` folder. This way no extra steps are needed
5-
to get playwright up and running.
3+
Each version of Playwright needs specific versions of browser binaries to operate.
64

7-
However, Playwright also has rich configuration to support various strategies
8-
for browser management.
5+
By default it downloads Chromium, WebKit and Firefox browsers into the `node_modules/` folder. This way no extra steps are needed to get playwright up and running:
6+
7+
```sh
8+
npm i playwright
9+
```
10+
11+
These browsers will take hundreds of megabytes of the disk space when installed:
12+
13+
```sh
14+
du -hs ./node_modules/.local-browsers/*
15+
281M .local-browsers/chromium-XXXXXX
16+
187M .local-browsers/firefox-XXXX
17+
180M .local-browsers/webkit-XXXX
18+
```
19+
20+
To mitigate that, Playwright has a rich set of options to control browser management.
921

1022
## Download from artifact repository
1123

@@ -21,10 +33,10 @@ $ PLAYWRIGHT_DOWNLOAD_HOST=192.168.1.78 npm i playwright
2133

2234
## Share browser binaries across projects
2335

24-
Sometimes developers work with multiple NPM projects that all use Playwright.
36+
Often developers work with multiple NPM projects that all use Playwright.
2537
By default, every project will have browser binaries in its own `node_modules/` folder.
26-
To save some HDD space and to speedup installation, Playwright can re-use
27-
browser binaries.
38+
To save the disk space and to speedup installation, Playwright can re-use
39+
these binaries.
2840

2941
Sharing browser binaries is a two-step process:
3042

0 commit comments

Comments
 (0)