.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: CI
+on:
+  - push
+  - pull_request
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node: ['14', '16', '18']
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: ${{ matrix.node }}
+      - run: npm ci
+      - run: xvfb-run npm test
+        timeout-minutes: 5

.gitignore

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

.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

@@ -5,7 +5,7 @@ A [tape](https://github.com/substack/tape) test runner that runs your tests in
 a (headless) browser and returns 0/1 as exit code, so you can use it as your
 `npm test` script.
 
-[![build status](https://secure.travis-ci.org/juliangruber/tape-run.svg)](http://travis-ci.org/juliangruber/tape-run)
+[![CI](https://github.com/juliangruber/tape-run/actions/workflows/ci.yml/badge.svg)](https://github.com/juliangruber/tape-run/actions/workflows/ci.yml)
 [![downloads](https://img.shields.io/npm/dm/tape-run.svg)](https://www.npmjs.org/package/tape-run)
 
 ## Usage
@@ -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.
 
-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:
+### GitHub Actions
+
+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,18 @@ $ 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)!
+
+## Security contact information
+
+To report a security vulnerability, please use the
+[Tidelift security contact](https://tidelift.com/security).
+Tidelift will coordinate the fix and disclosure.
+
 ## License
 
 (MIT)

bin/run.js

@@ -1,49 +1,60 @@
 #!/usr/bin/env node
 
 var run = require('..');
-var optimist = require('optimist');
+var yargs = require('yargs/yargs');
+var { hideBin } = require('yargs/helpers');
 var spawn = require('child_process').spawn;
 
-var argv = optimist
+var argv = yargs(hideBin(process.argv))
   .usage('Pipe a browserify stream into this.\nbrowserify [opts] [files] | $0 [opts]')
 
-  .describe('wait', 'Timeout for tap-finished')
-  .alias('w', 'wait')
-
-  .describe('port', 'Wait to be opened by a browser on that port')
-  .alias('p', 'port')
-
-  .describe('static', 'Serve static files from this directory')
-  .alias('s', 'static')
-
-  .describe('browser', 'Browser to use. ' +
-      'Always available: electron. ' +
-      'Available if installed: chrome, firefox, ie, phantom, safari')
-  .alias('b', 'browser')
-  .default('browser', 'electron')
-
-  .describe('render', 'Command to pipe tap output to for custom rendering')
-  .alias('r', 'render')
-
-  .describe('keep-open', 'Leave the browser open for debugging after running tests')
-  .alias('k', 'keep-open')
-  .alias('keepOpen', 'keep-open')
-
-  .describe('node', 'Enable nodejs integration for electron')
-  .alias('n', 'integration')
-  .alias('node-integration', 'node')
-  .alias('nodeIntegration', 'node')
-
-  .describe('basedir', 'Set this if you need to require node modules in node mode')
-
-  .describe('help', 'Print usage instructions')
-  .alias('h', 'help')
-
-  .argv;
-
-if (argv.help) {
-  return optimist.showHelp();
-}
+  .option('wait', {
+    alias: 'w',
+    type: 'number',
+    description: 'Timeout for tap-finished'
+  })
+  .option('port', {
+    alias: 'p',
+    type: 'number',
+    description: 'Wait to be opened by a browser on that port'
+  })
+  .option('static', {
+    alias: 's',
+    type: 'string',
+    description: 'Serve static files from this directory'
+  })
+  .option('browser', {
+    alias: 'b',
+    type: 'string',
+    default: 'electron',
+    description: 'Browser to use. ' +
+    'Always available: electron. ' +
+    'Available if installed: chrome, firefox, ie, phantom, safari'
+  })
+  .option('render', {
+    alias: 'r',
+    type: 'string',
+    description: 'Command to pipe tap output to for custom rendering'
+  })
+  .option('keep-open', {
+    alias: ['k', 'keepOpen'],
+    type: 'boolean',
+    description: 'Leave the browser open for debugging after running tests'
+  })
+  .option('node', {
+    alias: ['n', 'node-integration', 'nodeIntegration'],
+    type: 'boolean',
+    description: 'Enable nodejs integration for electron'
+  })
+  .option('sandbox', {
+    type: 'boolean',
+    default: true,
+    description: 'Enable electron sandbox'
+  })
+  .option('basedir', {
+    description: 'Set this if you need to require node modules in node mode'
+  })
+  .parse();
 
 var runner = run(argv);
 

package.json

@@ -1,7 +1,7 @@
 {
   "name": "tape-run",
   "description": "Headless tape test runner",
-  "version": "2.4.1",
+  "version": "11.0.0",
   "repository": {
     "type": "git",
     "url": "git://github.com/juliangruber/tape-run.git"
@@ -16,10 +16,10 @@
   },
   "dependencies": {
     "@juliangruber/tap-finished": "0.0.2",
-    "browser-run": "^3.6.0",
-    "optimist": "~0.6.1",
-    "through": "~2.3.4",
-    "throughout": "0.0.0"
+    "browser-run": "^12.0.0",
+    "through": "^2.3.8",
+    "throughout": "0.0.0",
+    "yargs": "^17.4.1"
   },
   "devDependencies": {
     "browserify": "^14.0.0",
@@ -39,5 +39,8 @@
     "email": "mail@juliangruber.com",
     "url": "http://juliangruber.com"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  }
 }