no-nested-tests

Description#

Test cases in mocha can be either global or within a suite, but they can’t be nested within other tests. Unfortunately there is nothing stopping you from creating a test case within another test case but mocha will simply ignore those tests.

it('something', function () {
    it('should work', function () {
        assert(fasle);
    });
});

Something like this could be easily happen by accident where the outer test case was actually meant to be a suite instead of a test. This rule reports such nested test cases in order to prevent problems where those nested tests are skipped silently.

Rule Details#

This rule looks for all test cases (it, specify and test) or suites (describe, context and suite) which are nested within another test case.

Incorrect#

it('something', function () {
    it('should work', function () {});
});

test('something', function () {
    specify('should work', function () {});
});

it('something', function () {
    describe('other thing', function () {
        // …
    });
});

Correct#

it('should work', function () {});
it('should work too', function () {});

describe('something', function () {
    it('should work', function () {});
});