docs(troubleshooting.md): run non-headless on CI (#3353)

Fixes #3303.
2018-10-09 23:25:55 +02:00 · 2018-10-09 23:25:55 +02:00 · a04dedcaf8
commit a04dedcaf8
parent 0bb462c8f5
1 changed files with 9 additions and 1 deletions
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@ -101,6 +101,14 @@ To run headless Chrome on Travis, you *must* call `launch()` with flags to disab
 const browser = await puppeteer.launch({args: ['--no-sandbox']});
 ```

+Some Puppeteer functionality (like Chrome extensions) requires non-headless mode. Running Puppeteer in non-headless mode on Travis CI can be done using an [Xvfb](https://en.wikipedia.org/wiki/Xvfb) server:
+
+```yml
+before_install:
+  - export DISPLAY=:99.0
+  - sh -e /etc/init.d/xvfb start
+```
+
 ## Running Puppeteer in Docker

 Getting headless Chrome up and running in Docker can be tricky.