.gitignore

@@ -1 +1,2 @@
 node_modules
+yarn.lock

.npmrc

@@ -0,0 +1 @@
+package-lock=false

.travis.yml

@@ -1,11 +1,7 @@
-sudo: false
 language: node_js
 node_js:
-  - "0.12"
-  - 4
-  - 5
-  - 6
-  - node
+  - 12
+  - 14
 addons:
   apt:
     packages:

README.md

@@ -42,6 +42,35 @@ $ echo $?
 0
 ```
 
+## rollup
+
+In simple cases you can run `rollup` and `tape-run` right from command line:
+```bash
+$ rollup test/test.js -f iife  | tape-run
+```
+If you want to use a configuration file, here's an example for `rollup -c | tape-run`:
+```js
+import resolve from 'rollup-plugin-node-resolve';
+import commonjs from 'rollup-plugin-commonjs';
+import builtins from 'rollup-plugin-node-builtins';
+import istanbul from 'rollup-plugin-istanbul';
+
+export default {
+  input: 'test/test.js',
+  output: { format: 'iife', sourcemap: 'inline' },
+  plugins: [
+    resolve(),
+    commonjs(),
+    builtins(),
+    istanbul({ exclude: ['dist'] })
+  ]
+}
+```
+
+## With webpack
+
+To use with [webpack](https://webpack.github.io/), set up a `webpack.test.config.js` to bundle your tape tests. Then, include [webpack-tape-run](https://github.com/syarul/webpack-tape-run) plugin in it. As a result, `$ webpack --config webpack.test.config.js` builds your tests with webpack, runs them in a headless browser, and outputs tap into console with correct exit code. Neat!
+
 ## API
 
 You can use tape-run from JavaScript too:
@@ -93,9 +122,10 @@ on `http://localhost:<port>` and tests will be run there.
   * `ie`
   * `phantom`
   * `safari`
-* `keepOpen` (Boolean): Leave the browser open for debugging after running tests.
-* `node` (Boolean): Enable nodejs integration for electron.
-* `basedir` (String): Set this if you need to require node modules in `node` mode
+* `keepOpen (Boolean)`: Leave the browser open for debugging after running tests.
+* `node (Boolean)` Enable nodejs integration for electron.
+* `sandbox (Boolean) [Default: true]`: Enable electron sandbox.
+* `basedir` (String): Set this if you need to require node modules in `node` mode.
 
 The **CLI** takes the same arguments, plus `--render` (see blow):
 
@@ -105,15 +135,16 @@ Pipe a browserify stream into this.
 browserify [opts] [files] | tape-run [opts]
 
 Options:
-  --wait       Timeout for tap-finished                                                                                
-  --port       Wait to be opened by a browser on that port                                                             
-  --static     Serve static files from this directory                                                                  
+  --wait       Timeout for tap-finished
+  --port       Wait to be opened by a browser on that port
+  --static     Serve static files from this directory
   --browser    Browser to use. Always available: electron. Available if installed: chrome, firefox, ie, phantom, safari  [default: "electron"]
-  --render     Command to pipe tap output to for custom rendering                                                      
-  --keep-open  Leave the browser open for debugging after running tests                                                
-  --node       Enable nodejs integration for electron                                                                  
-  --basedir    Set this if you need to require node modules in node mode                                               
-  --help       Print usage instructions  
+  --render     Command to pipe tap output to for custom rendering
+  --keep-open  Leave the browser open for debugging after running tests
+  --node       Enable nodejs integration for electron
+  --sandbox    Enable electron sandbox                                                                                   [default: true]
+  --basedir    Set this if you need to require node modules in node mode
+  --help       Print usage instructions
 ```
 
 ...or any of the [other options you can pass to browser-run](https://github.com/juliangruber/browser-run#runopts).
@@ -131,9 +162,33 @@ $ browserify test.js | tape-run --render="tap-spec"
 
 ```
 
-## Headless testing / Travis
+## Headless testing
+
+In environments without a screen, you can use `Xvfb` to simulate one. We recommend using the default electron browser, 
+which however requires you to add additional parts to your headless configurations.
+
+### GitHub Actions
 
-To use tape-run with travis, we recommend using the default electron browser, which however requires you to add this part to your travis.yml:
+This is a full example to run `npm test`. Refer to the last 2 lines in the YAML config:
+
+```yml
+on:
+  - pull_request
+  - push
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - run: npm install
+    - run: sudo apt-get install xvfb
+    - run: xvfb-run --auto-servernum npm test
+```
+
+### Travis
+
+Add this to your travis.yml:
 
 ```yml
 addons:
@@ -146,9 +201,9 @@ install:
   - npm install
 ```
 
-[Source](https://github.com/rhysd/Shiba/blob/055a11a0a2b4f727577fe61371a88d8db9277de5/.travis.yml).
+[Full example](https://github.com/rhysd/Shiba/blob/055a11a0a2b4f727577fe61371a88d8db9277de5/.travis.yml).
 
-For gnu/linux installations without a graphical environment:
+### Any gnu/linux box
 
 ```bash
 $ sudo apt-get install xvfb # or equivalent
@@ -157,7 +212,9 @@ $ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
 $ browser-run ...
 ```
 
-There is also an example docker machine [here](https://github.com/fraserxu/docker-tape-run).
+### Docker
+
+There is also an example [Docker image](https://hub.docker.com/r/kipparker/docker-tape-run). [Source](https://github.com/fraserxu/docker-tape-run)
 
 ## Installation
 
@@ -168,6 +225,12 @@ $ npm install tape-run -g # for cli
 $ npm install tape-run    # for api
 ```
 
+## Sponsors
+
+This module is proudly supported by my [Sponsors](https://github.com/juliangruber/sponsors)!
+
+Do you want to support modules like this to improve their quality, stability and weigh in on new features? Then please consider donating to my [Patreon](https://www.patreon.com/juliangruber). Not sure how much of my modules you're using? Try [feross/thanks](https://github.com/feross/thanks)!
+
 ## License
 
 (MIT)

bin/run.js

@@ -34,6 +34,10 @@ var argv = optimist
   .alias('node-integration', 'node')
   .alias('nodeIntegration', 'node')
 
+  .describe('sandbox', 'Enable electron sandbox')
+  .boolean('sandbox')
+  .default('sandbox', true)
+
   .describe('basedir', 'Set this if you need to require node modules in node mode')
 
   .describe('help', 'Print usage instructions')

package.json

@@ -1,7 +1,7 @@
 {
   "name": "tape-run",
   "description": "Headless tape test runner",
-  "version": "2.4.1",
+  "version": "9.0.0",
   "repository": {
     "type": "git",
     "url": "git://github.com/juliangruber/tape-run.git"
@@ -16,7 +16,7 @@
   },
   "dependencies": {
     "@juliangruber/tap-finished": "0.0.2",
-    "browser-run": "^3.6.0",
+    "browser-run": "^10.1.0",
     "optimist": "~0.6.1",
     "through": "~2.3.4",
     "throughout": "0.0.0"