123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120 |
- 'use strict';
- const {
- not,
- methodCallSelector,
- callExpressionSelector,
- } = require('./selectors/index.js');
- const ERROR_MESSAGE_ID = 'error';
- const SUGGESTION_REPLACE_MESSAGE_ID = 'replace';
- const SUGGESTION_REMOVE_MESSAGE_ID = 'remove';
- const messages = {
- [ERROR_MESSAGE_ID]: 'Use `undefined` instead of `null`.',
- [SUGGESTION_REPLACE_MESSAGE_ID]: 'Replace `null` with `undefined`.',
- [SUGGESTION_REMOVE_MESSAGE_ID]: 'Remove `null`.',
- };
- const selector = [
- 'Literal',
- '[raw="null"]',
- not([
- // `Object.create(null)`, `Object.create(null, foo)`
- `${methodCallSelector({object: 'Object', method: 'create', minimumArguments: 1, maximumArguments: 2})} > .arguments:first-child`,
- // `useRef(null)`
- `${callExpressionSelector({name: 'useRef', argumentsLength: 1})} > .arguments:first-child`,
- // `React.useRef(null)`
- `${methodCallSelector({object: 'React', method: 'useRef', argumentsLength: 1})} > .arguments:first-child`,
- // `foo.insertBefore(bar, null)`
- `${methodCallSelector({method: 'insertBefore', argumentsLength: 2})}[arguments.0.type!="SpreadElement"] > .arguments:nth-child(2)`,
- ]),
- ].join('');
- const isLooseEqual = node => node.type === 'BinaryExpression' && ['==', '!='].includes(node.operator);
- const isStrictEqual = node => node.type === 'BinaryExpression' && ['===', '!=='].includes(node.operator);
- /** @param {import('eslint').Rule.RuleContext} context */
- const create = context => {
- const {checkStrictEquality} = {
- checkStrictEquality: false,
- ...context.options[0],
- };
- return {
- [selector](node) {
- const {parent} = node;
- if (!checkStrictEquality && isStrictEqual(parent)) {
- return;
- }
- const problem = {
- node,
- messageId: ERROR_MESSAGE_ID,
- };
- const useUndefinedFix = fixer => fixer.replaceText(node, 'undefined');
- if (isLooseEqual(parent)) {
- problem.fix = useUndefinedFix;
- return problem;
- }
- const useUndefinedSuggestion = {
- messageId: SUGGESTION_REPLACE_MESSAGE_ID,
- fix: useUndefinedFix,
- };
- if (parent.type === 'ReturnStatement' && parent.argument === node) {
- problem.suggest = [
- {
- messageId: SUGGESTION_REMOVE_MESSAGE_ID,
- fix: fixer => fixer.remove(node),
- },
- useUndefinedSuggestion,
- ];
- return problem;
- }
- if (parent.type === 'VariableDeclarator' && parent.init === node && parent.parent.kind !== 'const') {
- problem.suggest = [
- {
- messageId: SUGGESTION_REMOVE_MESSAGE_ID,
- fix: fixer => fixer.removeRange([parent.id.range[1], node.range[1]]),
- },
- useUndefinedSuggestion,
- ];
- return problem;
- }
- problem.suggest = [useUndefinedSuggestion];
- return problem;
- },
- };
- };
- const schema = [
- {
- type: 'object',
- additionalProperties: false,
- properties: {
- checkStrictEquality: {
- type: 'boolean',
- default: false,
- },
- },
- },
- ];
- /** @type {import('eslint').Rule.RuleModule} */
- module.exports = {
- create,
- meta: {
- type: 'suggestion',
- docs: {
- description: 'Disallow the use of the `null` literal.',
- },
- fixable: 'code',
- hasSuggestions: true,
- schema,
- messages,
- },
- };
|