Using complete words results in more readable code. Not everyone knows all your abbreviations. Code is written only once, but read many times.
This rule can also be used to replace terms, disallow words, etc. See the replacements
and extendDefaultReplacements
options.
You can find the default replacements here.
This rule is fixable only for variable names with exactly one replacement defined.
const e = new Error();
const e = document.createEvent('Event');
class Btn {}
const error = new Error();
const event = document.createEvent('Event');
const levels = {
error: 0
};
this.event = 'click';
class Button {}
// Property is not checked by default
const levels = {
err: 0
};
// Property is not checked by default
this.evt = 'click';
Type: object
Type: object
You can extend default replacements by passing the replacements
option.
Lowercase replacements will match both camelcase and pascalcase identifiers. For example, err
will match both err
and Err
. errCb
will match both errCb
and ErrCb
.
Lowercase replacements will match both complete identifiers and separate words inside identifiers. For example, cmd
will match all of cmd
, createCmd
and CmdFactory
.
Camelcase replacements will only match complete identifiers. For example errCb
will only match errCb
and ErrCb
. It will not match fooErrCb
or errCbFoo
.
The example below:
- disables the default
e
→event
replacement (leavinge
→error
enabled), - disables
res
replacement completely (bothres
→response
andres
→result
from defaults are disabled), - adds a custom
cmd
→command
replacement, - adds a custom
errCb
→handleError
replacement.
"unicorn/prevent-abbreviations": [
"error",
{
"replacements": {
"e": {
"event": false
},
"res": false,
"cmd": {
"command": true
},
"errCb": {
"handleError": true
}
}
}
]
Type: boolean
Default: true
Pass "extendDefaultReplacements": false
to override the default replacements
completely.
The example below disables all the default replacements and enables a custom cmd
→ command
one.
"unicorn/prevent-abbreviations": [
"error",
{
"extendDefaultReplacements": false,
"replacements": {
"cmd": {
"command": true
}
}
}
]
Type: object
You can extend the default whitelist by passing the whitelist
option.
Unlike the replacements
option, whitelist
matches full identifier names case-sensitively.
For example, if you want to report props
→ properties
(enabled by default), but allow getInitialProps
, you could use the following configuration.
"unicorn/prevent-abbreviations": [
"error",
{
"whitelist": {
"getInitialProps": true
}
}
]
Type: boolean
Default: true
Pass "extendDefaultWhitelist": false
to override the default whitelist
completely.
Type: 'internal' | boolean
Default: 'internal'
'internal'
- Check variables declared in default or namespace import, but only for internal modules.true
- Check variables declared in default or namespace import.false
- Don't check variables declared in default or namespace import.
By default, the following code will be reported:
import * as err from './err';
import err from '/err';
With this set to true
, the following code will be reported:
import tempWrite from 'temp-write';
import * as err from 'err';
const err = require('err');
Type: 'internal'
| boolean
Default: 'internal'
'internal'
- Check variables declared in shorthand import, but only for internal modules.true
- Check variables declared in shorthand import.false
- Don't check variables declared in default shorthand import.
By default, the following code will be reported:
import {prop} from './foo';
With this set to true
, the following code will be reported:
import {prop} from 'ramda';
Type: boolean
Default: false
Pass "checkShorthandProperties": true
to check variables declared as shorhand properties in object destructuring.
With this set to true
the following code will be reported.
const {prop} = require('ramda');
const {err} = foo;
function f({err}) {}
Type: boolean
Default: false
Pass "checkProperties": true
to enable checking property names.
Type: boolean
Default: true
Pass "checkVariables": false
to disable checking variable names.
Type: boolean
Default: true
Pass "checkFilenames": false
to disable checking file names.