A tool which runs unit tests if a file has changed on the server in a browser
Last updated 7 years ago by peerigon .
Repository · Original npm · Tarball · package.json
$ cnpm install nof5 
SYNC missed versions from official npm registry.


is a server that runs Unit Tests with the help of test-suites like

on any number of mobile or desktop browsers simultaneously and automatically. nof5 is independent of these test suites and can be used with any suite. Therefore is should be simple to integrate nof5 with existing tests. nof5 is based on

It also supports Web-Bundlers such as

and can be customized to one's own needs with the help of Hooks as

  • before
  • beforeEach

Additionally nof5 supports the xUnit format and can therefore be integrated in Continuous Integration servers such as


We originally built nof5 for our client-and server-side framework [alamid.js] ( [alamid.js] ( makes it possible that the client code can be written exactly as for the server. We use for the classes of [alamid.js] ( our JavaScript compiler [nodeclass] ( and the client-side code will be bundled with the help of [WebPack] ( We also develop alamid.js using Contiuous integration and Jenkins. There was no tool that combines all these technologies.


npm install -g nof5


Usage: nof5 [options]

-h, --help            output usage information
-V, --version         output the version number
-d, --debug           outputs some additional debug output, such as a list of watched folders
-s, --silent          run without console logging
--list                lists all bundler names
-p, --port <n>        server port. Default: 11234
-t, --test <dir>      path to test folder. Default: process.cwd()
-l, --lib <dir>       path to lib folder
-a, --assets <dir>    path to folder where additionally files should be also served as statics
-b, --bundler <name>  defines the bundler which should be used. Default: 'Webpack'
-H, --hooks <file>    path to file with hooks
-W, --wphooks <file>  path to file with hooks for webpack-bundler
-B, --bhooks <file>   path to file with hooks for browserify-bundler
-x, --xunit <dir>     path to store xunit.xml file.
-c, --clients <file>  use given client hook

How to use

start nof5

Just execute on command line from test's root folder nof5 or from anywhere nof5 -t path/to/test/folder


define general hooks (optional)

Define a file named nof5.hooks.js under test's root folder or pass the path to the hooks-file nof5 -H path/to/hooks/file

The hooks-file should look like this:

    exports.before = function beforeHook() {
       //will be executed once

    exports.beforeEach = function() {
       //will be executed each time

define webpack hooks (optional)

Define a file named nof5.webpack.hooks.js under test's root folder or or pass the path to the webpack-hooks-file nof5 -W path/to/webpack/hooks/file

The webpack-hooks.file should look like this:

    exports.use = function () {

        return {
            // webpack-options @see


define browserify hooks (optional)

Define a file named nof5.browserify.hooks.js under test's root folder or or pass the path to the browserify-hooks-file nof5 -B path/to/browserify/hooks/file

The webpack-hooks.file should look like this:

    exports.use = function () {

        "middlewareA": function () {

        "middlewareB": function () {
            // ...

Create a Test-Runner

All files under root-folder are served as static files by nof5, so you can use any assets you like, e.g. jQuery, QUnit or Mocha.

     <!-- include to notify the client that a change on files has occured -->
     <script type="text/javascript" src="/"></script>

     <!-- include nof5 which will create a socket and configure it -->
     <script type="text/javascript" src="/nof5.js"></script>

     <!-- load the tests. NOTE: You must execute the tests manually with nof5.enableTests()-->
     <script type="text/javascript" src="tests.js"></script>

     <script>//configure your test-runner</script>


See also the example implementation of a Test-Runner.

Use with Jenkins


Current Tags

  • 0.4.0                                ...           latest (7 years ago)

7 Versions

  • 0.4.0                                ...           7 years ago
  • 0.3.0                                ...           8 years ago
  • 0.2.6                                ...           8 years ago
  • 0.2.5                                ...           8 years ago
  • 0.2.4                                ...           8 years ago
  • 0.2.3                                ...           8 years ago
  • 0.1.1                                ...           8 years ago
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (10)
Dev Dependencies (3)
Dependents (0)

Copyright 2014 - 2016 © |