aboutsummaryrefslogtreecommitdiff
path: root/node_modules/ava/lib/validate-test.js
blob: 8258a5990a48b3aabdd43e98dc39a99ae1aca417 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
'use strict';

function validate(title, fn, metadata) {
	if (metadata.type !== 'test') {
		if (metadata.exclusive) {
			return '`only` is only for tests and cannot be used with hooks';
		}

		if (metadata.failing) {
			return '`failing` is only for tests and cannot be used with hooks';
		}

		if (metadata.todo) {
			return '`todo` is only for documentation of future tests and cannot be used with hooks';
		}
	}

	if (metadata.todo) {
		if (typeof fn === 'function') {
			return '`todo` tests are not allowed to have an implementation. Use ' +
			'`test.skip()` for tests with an implementation.';
		}

		if (typeof title !== 'string') {
			return '`todo` tests require a title';
		}

		if (metadata.skipped || metadata.failing || metadata.exclusive) {
			return '`todo` tests are just for documentation and cannot be used with `skip`, `only`, or `failing`';
		}
	} else if (typeof fn !== 'function') {
		return 'Expected an implementation. Use `test.todo()` for tests without an implementation.';
	}

	if (metadata.always) {
		if (!(metadata.type === 'after' || metadata.type === 'afterEach')) {
			return '`always` can only be used with `after` and `afterEach`';
		}
	}

	if (metadata.skipped && metadata.exclusive) {
		return '`only` tests cannot be skipped';
	}

	return null;
}

module.exports = validate;