mirror of
https://github.com/JamesIves/github-pages-deploy-action.git
synced 2023-12-15 20:03:39 +08:00
193 lines
3.8 KiB
Markdown
193 lines
3.8 KiB
Markdown
# describe/test titles should be valid (`valid-title`)
|
|
|
|
Checks that the title of Jest blocks are valid by ensuring that titles are:
|
|
|
|
- not empty,
|
|
- is a string,
|
|
- not prefixed with their block name,
|
|
- have no leading or trailing spaces
|
|
|
|
## Rule Details
|
|
|
|
**emptyTitle**
|
|
|
|
An empty title is not informative, and serves little purpose.
|
|
|
|
Examples of **incorrect** code for this rule:
|
|
|
|
```js
|
|
describe('', () => {});
|
|
describe('foo', () => {
|
|
it('', () => {});
|
|
});
|
|
it('', () => {});
|
|
test('', () => {});
|
|
xdescribe('', () => {});
|
|
xit('', () => {});
|
|
xtest('', () => {});
|
|
```
|
|
|
|
Examples of **correct** code for this rule:
|
|
|
|
```js
|
|
describe('foo', () => {});
|
|
describe('foo', () => {
|
|
it('bar', () => {});
|
|
});
|
|
test('foo', () => {});
|
|
it('foo', () => {});
|
|
xdescribe('foo', () => {});
|
|
xit('foo', () => {});
|
|
xtest('foo', () => {});
|
|
```
|
|
|
|
**titleMustBeString**
|
|
|
|
Titles for test blocks should always be a string literal or expression.
|
|
|
|
This is also applied to `describe` blocks by default, but can be turned off via
|
|
the `ignoreTypeOfDescribeName` option:
|
|
|
|
Examples of **incorrect** code for this rule:
|
|
|
|
```js
|
|
it(123, () => {});
|
|
describe(String(/.+/), () => {});
|
|
describe(myFunction, () => {});
|
|
xdescribe(myFunction, () => {});
|
|
describe(6, function() {});
|
|
```
|
|
|
|
Examples of **correct** code for this rule:
|
|
|
|
```js
|
|
it('is a string', () => {});
|
|
test('is a string', () => {});
|
|
xtest('is a string', () => {});
|
|
describe('is a string', () => {});
|
|
describe.skip('is a string', () => {});
|
|
fdescribe('is a string', () => {});
|
|
```
|
|
|
|
Examples of **correct** code when `ignoreTypeOfDescribeName` is `true`:
|
|
|
|
```js
|
|
it('is a string', () => {});
|
|
test('is a string', () => {});
|
|
xtest('is a string', () => {});
|
|
describe('is a string', () => {});
|
|
describe.skip('is a string', () => {});
|
|
fdescribe('is a string', () => {});
|
|
|
|
describe(String(/.+/), () => {});
|
|
describe(myFunction, () => {});
|
|
xdescribe(myFunction, () => {});
|
|
describe(6, function() {});
|
|
```
|
|
|
|
**duplicatePrefix**
|
|
|
|
A `describe` / `test` block should not start with `duplicatePrefix`
|
|
|
|
Examples of **incorrect** code for this rule
|
|
|
|
```js
|
|
test('test foo', () => {});
|
|
it('it foo', () => {});
|
|
|
|
describe('foo', () => {
|
|
test('test bar', () => {});
|
|
});
|
|
|
|
describe('describe foo', () => {
|
|
test('bar', () => {});
|
|
});
|
|
```
|
|
|
|
Examples of **correct** code for this rule
|
|
|
|
```js
|
|
test('foo', () => {});
|
|
it('foo', () => {});
|
|
|
|
describe('foo', () => {
|
|
test('bar', () => {});
|
|
});
|
|
```
|
|
|
|
**accidentalSpace**
|
|
|
|
A `describe` / `test` block should not contain accidentalSpace
|
|
|
|
Examples of **incorrect** code for this rule
|
|
|
|
```js
|
|
test(' foo', () => {});
|
|
it(' foo', () => {});
|
|
|
|
describe('foo', () => {
|
|
test(' bar', () => {});
|
|
});
|
|
|
|
describe(' foo', () => {
|
|
test('bar', () => {});
|
|
});
|
|
|
|
describe('foo ', () => {
|
|
test('bar', () => {});
|
|
});
|
|
```
|
|
|
|
Examples of **correct** code for this rule
|
|
|
|
```js
|
|
test('foo', () => {});
|
|
it('foo', () => {});
|
|
|
|
describe('foo', () => {
|
|
test('bar', () => {});
|
|
});
|
|
```
|
|
|
|
## Options
|
|
|
|
```ts
|
|
interface {
|
|
ignoreTypeOfDescribeName?: boolean;
|
|
disallowedWords?: string[];
|
|
}
|
|
```
|
|
|
|
#### `ignoreTypeOfDescribeName`
|
|
|
|
Default: `false`
|
|
|
|
When enabled, the type of the first argument to `describe` blocks won't be
|
|
checked.
|
|
|
|
#### `disallowedWords`
|
|
|
|
Default: `[]`
|
|
|
|
A string array of words that are not allowed to be used in test titles. Matching
|
|
is not case-sensitive, and looks for complete words:
|
|
|
|
Examples of **incorrect** code using `disallowedWords`:
|
|
|
|
```js
|
|
// with disallowedWords: ['correct', 'all', 'every', 'properly']
|
|
describe('the correct way to do things', () => {});
|
|
it('has ALL the things', () => {});
|
|
xdescribe('every single one of them', () => {});
|
|
test(`that the value is set properly`, () => {});
|
|
```
|
|
|
|
Examples of **correct** code when using `disallowedWords`:
|
|
|
|
```js
|
|
// with disallowedWords: ['correct', 'all', 'every', 'properly']
|
|
it('correctly sets the value', () => {});
|
|
test('that everything is as it should be', () => {});
|
|
describe('the proper way to handle things', () => {});
|
|
```
|