index.js

var tape = require('tape');
var path = require('path');
var isNode = require("is-node");
var refine = require("./lib/refine");
var command = require('./lib/command');
var isProvaFrame = !isNode && document;
var nodeRequire = require;
var view, tests;

empty.skip = empty;
empty.only = empty;

if (command.launch === true && isNode) {
  nodeRequire('./lib/cli').launch();
  module.exports = empty;
  return;
}

if (command.examples && isNode) {
  nodeRequire('./lib/cli').examples();
  module.exports = empty;
  return;
}

if (command.browser && isNode) {
  nodeRequire('./lib/cli').launch();
  nodeRequire('./lib/browser')([require.main.filename], command);
} else if (isNode && !command.tap) {
  view = nodeRequire('./lib/node-reporter');
  tape.createStream({ objectMode: true }).pipe(refine()).pipe(view());
} else if (isProvaFrame) {
  htape = tape.createHarness();
  htape.skip = tape.skip;
  tape = htape;
  view = require('./lib/browser-reporter');
  tape.createStream({ objectMode: true }).pipe(refine()).pipe(view(tape._results._stream));
}

if (isNode) {
  tests = require('./lib/tests');
}

module.exports = prova;
module.exports.skip = skip;
module.exports.only = only;
module.exports.timeout = timeout;

function prova (title, fn, only) {
  if (command.grep && title.indexOf(command.grep) == -1) return skip(title, fn);
  title = formatTitle(title);
  var t = only ? tape.only : tape;
  return t(title, function (t) {
    t.test = function() {
      // many reasons for this including:
      // -tap output does not really support grouping.
      // -prova overrides test() with prova() but t.test createsa test() internally which is not the Prova version so thing like grep wont work
      // -breaks .only()
      throw 'Nested tests are not supported.';
    };
    t.timeout = function(ms) {
      t._timeout = ms;
    };

    if(global._prova_stopOnFirstFailure) {
      t.once('end', function() {
        if(!t._ok) {
          throw "Stopping on first failed test because stopOnFirstFailure flag is set";
        }
      });
      fn.call(this, t);
    } else {
      try {
        fn.call(this, t);
      } catch (err) {
        t.error(err);
        t.end();
        return;
      }
    }

    _setupTestTimeout(t);

  });
}

function formatTitle(title) {
  if (global._prova_includeFilenameAsPackage && global._prova_filename) {
    var filepath = global._prova_filename;
    title = formatUnicodeDot(title);
    title = '[' + filepath + '].' + title;
  }
  return title;
};

function formatUnicodeDot(s) {
  var unicodeDot = '\uFF0E'; //full width unicode dot
  return s.replace(/\./g, unicodeDot);
}

function skip (title, fn) {
  title = formatTitle(title);
  tape(title + ' - skipped ', function(t) {
    t.skip(title);
    t.end();
  });
  return tape.skip(title, fn);
}

function only (title, fn) {
  return prova(title, fn, true);
}

var globalTimeout = 20000;
function timeout(ms) {
  globalTimeout = ms;
}

function empty () {}

function _setupTestTimeout(t) {
  var timeout = t._timeout || globalTimeout;
  if (timeout && !t.ended) {
    t.once('end', function removeTimoutHandler() {
      clearTimeout(t.timeoutHandler);
    });
    t.timeoutHandler = setTimeout(function failTestWhenTimedout() {
      if (t.ended) {
        return;
      }
      t.end('Timeout, test did not finish in ' + timeout + 'ms');
      // prevents "end was called twice errors"
      t.end = function() {}
    }, timeout);
  }
}