2020-08-26 01:57:08 +02:00
|
|
|
"use strict";
|
|
|
|
|
|
|
|
Object.defineProperty(exports, "__esModule", {
|
|
|
|
value: true
|
|
|
|
});
|
|
|
|
exports.default = void 0;
|
|
|
|
var _utils = require("./utils");
|
2022-11-10 11:43:16 +01:00
|
|
|
const messages = {
|
|
|
|
tooManyDescribes: 'There should not be more than {{ max }} describe{{ s }} at the top level',
|
|
|
|
unexpectedTestCase: 'All test cases must be wrapped in a describe block.',
|
|
|
|
unexpectedHook: 'All hooks must be wrapped in a describe block.'
|
|
|
|
};
|
2020-08-26 01:57:08 +02:00
|
|
|
var _default = (0, _utils.createRule)({
|
|
|
|
name: __filename,
|
|
|
|
meta: {
|
|
|
|
docs: {
|
|
|
|
category: 'Best Practices',
|
|
|
|
description: 'Require test cases and hooks to be inside a `describe` block',
|
|
|
|
recommended: false
|
|
|
|
},
|
2022-11-10 11:43:16 +01:00
|
|
|
messages,
|
2020-08-26 01:57:08 +02:00
|
|
|
type: 'suggestion',
|
2022-11-10 11:43:16 +01:00
|
|
|
schema: [{
|
|
|
|
type: 'object',
|
|
|
|
properties: {
|
|
|
|
maxNumberOfTopLevelDescribes: {
|
|
|
|
type: 'number',
|
|
|
|
minimum: 1
|
|
|
|
}
|
|
|
|
},
|
|
|
|
additionalProperties: false
|
|
|
|
}]
|
2020-08-26 01:57:08 +02:00
|
|
|
},
|
2022-11-10 11:43:16 +01:00
|
|
|
defaultOptions: [{}],
|
2020-08-26 01:57:08 +02:00
|
|
|
create(context) {
|
2022-11-10 11:43:16 +01:00
|
|
|
const {
|
|
|
|
maxNumberOfTopLevelDescribes = Infinity
|
|
|
|
} = context.options[0] ?? {};
|
|
|
|
let numberOfTopLevelDescribeBlocks = 0;
|
2020-08-26 01:57:08 +02:00
|
|
|
let numberOfDescribeBlocks = 0;
|
|
|
|
return {
|
|
|
|
CallExpression(node) {
|
2022-11-10 11:43:16 +01:00
|
|
|
const jestFnCall = (0, _utils.parseJestFnCall)(node, context);
|
|
|
|
if (!jestFnCall) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
if (jestFnCall.type === 'describe') {
|
2020-08-26 01:57:08 +02:00
|
|
|
numberOfDescribeBlocks++;
|
2022-11-10 11:43:16 +01:00
|
|
|
if (numberOfDescribeBlocks === 1) {
|
|
|
|
numberOfTopLevelDescribeBlocks++;
|
|
|
|
if (numberOfTopLevelDescribeBlocks > maxNumberOfTopLevelDescribes) {
|
|
|
|
context.report({
|
|
|
|
node,
|
|
|
|
messageId: 'tooManyDescribes',
|
|
|
|
data: {
|
|
|
|
max: maxNumberOfTopLevelDescribes,
|
|
|
|
s: maxNumberOfTopLevelDescribes === 1 ? '' : 's'
|
|
|
|
}
|
|
|
|
});
|
|
|
|
}
|
|
|
|
}
|
2020-08-26 01:57:08 +02:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
if (numberOfDescribeBlocks === 0) {
|
2022-11-10 11:43:16 +01:00
|
|
|
if (jestFnCall.type === 'test') {
|
2020-08-26 01:57:08 +02:00
|
|
|
context.report({
|
|
|
|
node,
|
|
|
|
messageId: 'unexpectedTestCase'
|
|
|
|
});
|
|
|
|
return;
|
|
|
|
}
|
2022-11-10 11:43:16 +01:00
|
|
|
if (jestFnCall.type === 'hook') {
|
2020-08-26 01:57:08 +02:00
|
|
|
context.report({
|
|
|
|
node,
|
|
|
|
messageId: 'unexpectedHook'
|
|
|
|
});
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
},
|
|
|
|
'CallExpression:exit'(node) {
|
2022-11-10 11:43:16 +01:00
|
|
|
if ((0, _utils.isTypeOfJestFnCall)(node, context, ['describe'])) {
|
2020-08-26 01:57:08 +02:00
|
|
|
numberOfDescribeBlocks--;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
}
|
|
|
|
});
|
|
|
|
exports.default = _default;
|