Skip to content

Commit

Permalink
Update doc regarding exp. features on Chrome
Browse files Browse the repository at this point in the history
Following web-platform-tests#13011, `wpt`
automatically turns on experimental web platform features on Chrome if
the channel is "dev". Update the doc to reflect this change.
  • Loading branch information
Hexcles committed Sep 20, 2018
1 parent b1e8aea commit b0ea108
Showing 1 changed file with 13 additions and 18 deletions.
31 changes: 13 additions & 18 deletions docs/_running-tests/chrome.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,32 +2,27 @@
layout: page
title: Chrome
---
When running Chrome, there are some additional useful command line arguments.
When running Chrome, there are some useful command line arguments.

As with most products, you can use a different binary with `--binary`, e.g., to
run Chrome Dev on Linux:
You can inform `wpt` of the release channel of Chrome using `--channel`.
However, `wpt` currently does not support installing Chrome or finding the
Chrome binary of a specific channel, so you would also need to specify the path
to the Chrome binary with `--binary`. For example, to run Chrome Dev on Linux:

```
./wpt run --binary `which google-chrome-unstable` chrome
./wpt run --channel dev --binary `which google-chrome-unstable` chrome
```

Extra arguments to Chrome can be passed with `--binary-args`.
Note: when the channel is "dev", `wpt` will *automatically* enable all
[experimental web platform features][1]
(chrome://flags/#enable-experimental-web-platform-features) by passing
`--enable-experimental-web-platform-features` to Chrome.

To enable all [experimental web platform features](https://www.chromium.org/blink/runtime-enabled-features) (chrome://flags/#enable-experimental-web-platform-features):

```
./wpt run --binary-arg=--enable-experimental-web-platform-features chrome fullscreen/
```

To enable a specific [runtime enabled feature](http://dev.chromium.org/blink/runtime-enabled-features):
If you want to enable a specific [runtime enabled feature][1], use
`--binary-arg` to specify the flag(s) that you want to pass to Chrome:

```
./wpt run --binary-arg=--enable-blink-features=AsyncClipboard chrome clipboard-apis/
```

Some of the above are most useful in combination, e.g., to run all tests in
Chrome Dev with experimental web platform features enabled:

```
./wpt run --binary `which google-chrome-unstable` --binary-arg=--enable-experimental-web-platform-features chrome
```
[1]: https://www.chromium.org/blink/runtime-enabled-features

0 comments on commit b0ea108

Please sign in to comment.