How to set execution order of mocha test cases in multiple files

Question

I have two javascript files which contain mocha test cases.

//----------abc.js -------------

describe("abc file", function(){
  it("test 1" , function(){
    assert.equal(20 , 20); 
  });
}); 

//---------xyz.js--------------
describe("xyz file", function(){
      it("test 1" , function(){
        assert.equal(10 , 10); 
      });
    });

I have put them in a folder called test and when I execute the mocha command the first file(abc.js) is always executed before xyz.js. I thought this might be due to alphabetical ordering and renamed the files as

abc.js => xyz.js
xyz.js => abc.js

but still, the content of the xyz.js (previously abc.js) is executed first. How can I change the execution order of these test files?

Solution 1

Mocha has a --sort (short -S) option that sorts test files:

$ mocha --help

[...]
    -S, --sort                              sort test files
[...]

Solution 2

In the second file, require the first one:

--- two.js ---
require("./one")

Mocha will run the tests in the order the describe calls execute.

Solution 3

I follow a totally seperate solution for this.

Put all your tests in a folder named test/ and Create a file tests.js in the root directory in the order of execution

--- tests.js ---
require('./test/one.js')
require('./test/two.js')
require('./test/three.js')

And in the tests files one.js, two.js and so on write your simple mocha tests

this way if you want to run them in the order you have defined then just run mocha tests.js

Solution 4

Since mocha sorts files in alphabetical order, I usually prefix my test files names with numbers, like:

• 0 - util.js
• 1 - something low level.js
• 2 - something more interesting.js

etc.

In addition to being really easy to maintain (no gulp grunt or any of that nonsense, no editing your package.json...), it provides the benefit that:

• people reading your source code get an idea of the structure of your program, starting from the less interesting parts and moving up to the business layer
• when a test fails, you have some indication of causality (if something failed in 1 - something.js but there are no failures in 0 - base.js then it's probably the fault of the layer covered by 1 - something.js

If you're doing real unit tests of course order should not matter, but I'm rarely able to go with unit tests all the way.

Solution 5

If you prefer a particular order, you can list the files (in order) as command-line arguments to mocha, e.g.:

$ mocha test/test-file-1.js test/test-file-2.js

To avoid a lot of typing every time you want to run it, you could turn this into an npm script in your package.json:

{
  // ...
  "scripts": {
    "test": "mocha test/test-file-1.js test/test-file-2.js"
  }
  // ...
}

Then run your suite from the command line:

$ npm test

Or if you're using Gulp, you could create a task in your gulpfile.js:

var gulp = require('gulp');
var mocha = require("gulp-mocha");

gulp.task("test", function() {
  return gulp.src([
      "./test/test-file-1.js",
      "./test/test-file-2.js"
    ])
    .pipe(mocha());
});

Then run $ gulp test.

View more solutions