mocaccino

Mocha test runner as a Browserify plugin.

Install

npm install mocaccino --save-dev

Real browser testing

This module is developed as part of Mochify which allows you to run tests with a headless browser, on a Selenium grid, in the cloud with SauceLabs or generates a standalone HTML page to run the tests. The underlying modules can also be used as Browserify plugins.

• min-webdriver for Selenium and SauceLabs support
• Consolify to generate a standalone HTML page

Code coverage with node

Use the Coverify transform and node:

$ browserify --bare -p [ mocaccino --node ] -t coverify test.js | node | coverify

Usage

Mocaccino is a browserify plugin:

browserify -p [ mocaccino OPTIONS ]

where OPTIONS are:

  --reporter, -R  Mocha reporter to use, defaults to "tap"
  --grep          Mocha grep option
  --fgrep         Mocha fgrep option
  --invert        Mocha invert option
  --timeout, -t   Mocha timeout in milliseconds to use, defaults to 2000
  --ui, -U        Mocha user interface to use, defaults to "bdd"
  --yields, -y    Yield every N milliseconds, defaults to 250
  --node          If result is used in node instead of a browser
  --windowWidth   Overrides the window width, defaults to the current shells
                  window width or fall back to 80
  --no-colors     Disable colors (overrides color support detection)
  --colors        Enable colors (overrides color support detection)
  --mochaPath     Path to custom Mocha module

The yields option causes a tiny delay every N milliseconds to allow pending I/O to happen. It's ignored if --node is given.

Compatibility

• Node 12 or later
• Browserify 5.9 or later (since version 1.0.0)
• Browserify 4.x (before 1.0.0)

License

MIT

Changes

6.1.0

• 🛡 fc6f1a5 Update mocha to 9.2.0 (#40) (Frederik Ring)

Released by Frederik Ring on 2022-01-24.

6.0.0

• 💥 4837604 Update mocha to 9.1.3 (#39) (Albert Wang)
• 🛡 09f1a80 Update npm dependencies (#38) (Albert Wang)
  • Update eslint dependency to 8.5.0
  • Update through2 dependency to 4.0.2
  • Update supports-color dependency to v8.1.1
  • Update puppeteer dependency to v13
• 🛡 37403dc Set up GitHub Actions (#37) (Albert Wang)
  • Set up Github Actions
  • Switch CI badge from Travis to Github Actions
  • Recreate package-lock.json
• 🛡 7e0d52d Fix test (#36) (Albert Wang)

Released by Frederik Ring on 2021-12-28.

5.0.0

• 💥 2a6c8c9 Update mocha to v8, adjust assertions (Frederik Ring)
• 🍏 a90d13a Port browser tests to use puppeteer (Frederik Ring)
• 🐛 4382056 Ensure brout is required before mocha (Frederik Ring)
• 🐛 3fa740a Pass in custom reporters in setup to work around dynamic require limitation (Frederik Ring)
• 🛡 05ee03e npm audit
• 🛡 7f1ae36 Bump lodash from 4.17.19 to 4.17.21 (dependabot[bot])
• 🛡 637cb13 Bump elliptic from 6.4.1 to 6.5.4 (dependabot[bot])
• 🛡 9a81451 Bump js-yaml from 3.12.0 to 3.14.0 (dependabot[bot])
• 🛡 2fce39a Bump lodash from 4.17.11 to 4.17.19 (dependabot[bot])
• 📚 c29813f Remove phantomic references from README and update engine requirements (Frederik Ring)
• ✨ 953e4ee Upgrade Studio Changes

Released by Maximilian Antoni on 2021-05-23.

4.1.2

• f46487a Do not assume process.nextTick exists

Released by Maximilian Antoni on 2019-10-09.

4.1.1

• fc0eb96 Fix problems with absolute custom mocha path (#25) (Christopher Hiller)

Released by Maximilian Antoni on 2019-03-12.

4.1.0

Adds the mochaPath option to specify a custom path to resolve mocha.

• aea12b7 Add support for custom path to mocha module (Christopher Hiller) (#24)
• 40e28dc Add contributor

Released by Maximilian Antoni on 2019-02-28.

4.0.0

• 1b3d32a Show build status on master branch in README
• 575abdc Run builds in Node 6, 8 and 10
• 8cfa0ba Replace jslint with eslint
• da0d287 Update all transient dependencies
• ca8e25c Update resolve and through2
• 3f3317d Upgrade Mocha to v5
• 3bea39e Upgrade supports-color to v5
• db00c21 Upgrade Browserify to v16
• 84dd99a Update @studio/changes for --commits and --footer support

Released by Maximilian Antoni on 2018-11-19.

3.0.0

• Update to Mocha 4 (Carl-Erik Kopseng)

2.0.0

• Upgrade Mocha to ^3.2 (Morgan Roderick)

• Order dependencies by using npm command (Morgan Roderick)

  This will make future changesets made with npm install read much better, as npm commands always sorts dependencies lexicographically.

• Run tests in newer node versions, and remove 0.10, 0.12 (#21) (Morgan Roderick)

• Use @studio/changes instead of make

1.9.0

• Add support for reporterOptions in API (Tomer Lahav)
• Update Mocha link (Morton Fox)

1.8.2

Revert "Nail Mocha to ~2.3.4 to workaround issues with 2.4.x" since the underlying issue was reverted in Mocha.

1.8.1

Nail Mocha to ~2.3.4 to workaround issues with 2.4.x. Follow https://github.com/mantoni/mochify.js/issues/129 for updates.

1.8.0

Streams 3: bump dependencies so that through2@2 is used everywhere.

These dependencies have been updated:

• through2: ^2.0.0
• resolve: ^1.1.6
• brout: ^1.1.0
• supports-color: ^3.1.2

Test are now using browserify@13.

1.7.0

Brad Buchanan fixed the grep behavior to align better with Mocha. See pull request #16.

Adds the ability to pass the Mocha fgrep option through, so that any users who were depending on the incorrect behavior of --grep before can easily switch over to fgrep (which is what they want).

• Treat grep option as a regular expression. (Brad Buchanan)
• Add fgrep option. (Brad Buchanan)

1.6.1

• Bump Mocha version to use at least 2.3.0 (Matheus Kautzmann)

1.6.0

• Add support for third party reporters (Matheus Kautzmann)
• Move mocha from devDependencies to dependencies

1.5.2

• Update through2 to ^1.1

1.5.1

• Improve documentation
• Add node 0.12 to travis config

1.5.0

• Add options --colors and --no-colors to explicitly enable or disable colors
• Fix setting colors

1.4.0

• Use same color feature detection as introduced in Mocha 2.2

1.3.0

• Allow to override the window width

1.2.0

• Add support for grep invert option (Daniel Davidson)

1.1.0

• Add support for mocha grep option (Daniel Davidson)

1.0.7

• Set window width and dot symbol for node as well

1.0.6

• Bump through2, resolve and phantomic
• Fix coverage for browsers

1.0.5

• Fix for calling b.bundle() multiple times

1.0.4

• Listen to Browserify 'reset' events

1.0.3

• Fix brout resolution for Windows

1.0.2

• Fix issue with multiple push calls to through2

1.0.1

• Fix brout resolving

1.0.0

• Require Browserify 5

0.8.0

• Added timeout and t options so one can test async scripts that last longer than 2000ms

0.7.0

• Added ui and U options so one can select BDD/TDD/QUnit (Mikela Clemmons)

0.6.4

• Use process.nextTick to yield instead of setTimeout

0.6.3

• Support require('mocha')

0.6.2

• Lame cygwin thing with getWindowSize

0.6.1

• Pass on terminal window width
• Use ascii dot symbol for compatibility

0.6.0

• Bump brout and verify phantomic can be used with --brout
• Fix path to setup file on windows

0.5.0

• Yield every 250 milliseconds by default to allow pending I/O to happen
• Add --yields / -y option to configure yield interval

0.4.2

• Allow to use Mocaccino output in a browser with coverify

0.4.1

• Fix describe.only and it.only (Andrey Popp)

0.4.0

• Include Mocha via Browserify (Andrey Popp)
• Remove Function.prototype.bind shim since Phantomic 0.5 always includes es5-shim (Andrey Popp)

0.3.1

Don't screw up coverify output

0.3.0

Rewrote Mocaccino as Browserify plugin

0.2.1

Resolve Mocha properly

0.2.0

Support most Mocha reporters when used with brout

• Removed mocaccino-reporter
• Using "tap" as the default reporter because it works with standard console.log statements
• Adding in browser shims for Array.forEach and Function.bind
• Using process.exit(code) on finish if available

0.1.0

Initial release