# `mix playwright.install`
[🔗](https://github.com/ftes/playwright_ex/blob/v1.65.0-rc.3/lib/mix/tasks/playwright.install.ex#L1)

Usage: `mix playwright.install [ARGS...]` (browsers and flags, in any order)

Installs the driver, then runs its `playwright install` with the args, as
`npx playwright install` would (none: its default browsers), e.g.
`mix playwright.install chromium firefox --with-deps`. Two flags, in any position, are the
task's own:

  * `--no-browsers` - installs only the driver, for a browser launched with `:executable_path`
    or `:channel`. It takes no other args but `--force`.
  * `--force` - reinstalls the driver, and is forwarded, so it reinstalls the browsers too. To
    reinstall only a browser, run `mix playwright.cli install --force <browser>`.

Every other arg is forwarded in order.

The task doesn't see the options of `Playwright.Supervisor`; it reads their defaults,
`config :playwright, :driver` (see `Playwright.Driver`). It doesn't compile the project, so it
sees `config/config.exs` and the files it imports, not `config/runtime.exs`:

  * `:cache_dir` - where the driver is installed.
  * `:executable`, `:node` - the CLI, or the Node binary, that installs the browsers. The pinned
    driver is downloaded all the same.

`HTTPS_PROXY` (else `https_proxy`) sets the proxy for the driver download.

The Playwright CLI reads its own: `PLAYWRIGHT_BROWSERS_PATH` (where browsers go),
`PLAYWRIGHT_DOWNLOAD_HOST`, `HTTPS_PROXY`, ...

---

*Consult [api-reference.md](api-reference.md) for complete listing*
