noUselessUndefinedInitialization

JavaScript (and super languages)

Summary

Rule available since: v1.7.2
Diagnostic Category: lint/complexity/noUselessUndefinedInitialization
This rule is recommended, which means is enabled by default.
This rule has a safe fix.
The default severity of this rule is information.
Sources:
- Same as no-undef-init

How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "complexity": {
5
        "noUselessUndefinedInitialization": "error"
6
      }
7
    }
8
  }
9
}

Description

Disallow initializing variables to undefined.

A variable that is declared and not initialized to any value automatically gets the value of undefined. It’s considered a best practice to avoid initializing variables to undefined.

Please note that any inline comments attached to the initialization value or variable will be moved at the end of the variable declaration on auto-fix. Please be also aware that this differs from Eslint’s behaviour.

Examples

Invalid

1
var a = undefined;

code-block.js:1:7 lint/complexity/noUselessUndefinedInitialization  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━

  ℹ It’s not necessary to initialize a to undefined.
  
  > 1 │ var a = undefined;
      │       ^^^^^^^^^^^
    2 │ 
  
  ℹ A variable that is declared and not initialized to any value automatically gets the value of undefined.
  
  ℹ Safe fix: Remove undefined initialization.
  
    1 │ var·a·=·undefined;
      │       -----------

1
let b = undefined, c = 1, d = 2;

code-block.js:1:7 lint/complexity/noUselessUndefinedInitialization  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━

  ℹ It’s not necessary to initialize b to undefined.
  
  > 1 │ let b = undefined, c = 1, d = 2;
      │       ^^^^^^^^^^^
    2 │ 
  
  ℹ A variable that is declared and not initialized to any value automatically gets the value of undefined.
  
  ℹ Safe fix: Remove undefined initialization.
  
    1 │ let·b·=·undefined,·c·=·1,·d·=·2;
      │       -----------

1
for (let i = 0; i < 100; i++) {
2
  let i = undefined;
3
}

code-block.js:2:8 lint/complexity/noUselessUndefinedInitialization  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━

  ℹ It’s not necessary to initialize i to undefined.
  
    1 │ for (let i = 0; i < 100; i++) {
  > 2 │ 	let i = undefined;
      │ 	      ^^^^^^^^^^^
    3 │ }
    4 │ 
  
  ℹ A variable that is declared and not initialized to any value automatically gets the value of undefined.
  
  ℹ Safe fix: Remove undefined initialization.
  
    2 │ → let·i·=·undefined;
      │         -----------

1
let f = /**/undefined/**/ ;

code-block.js:1:7 lint/complexity/noUselessUndefinedInitialization  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━

  ℹ It’s not necessary to initialize f to undefined.
  
  > 1 │ let f = /**/undefined/**/ ;
      │       ^^^^^^^^^^^^^^^
    2 │ 
  
  ℹ A variable that is declared and not initialized to any value automatically gets the value of undefined.
  
  ℹ Safe fix: Remove undefined initialization.
  
    1   │ - let·f·=·/**/undefined/**/·;
      1 │ + let·f·;/**//**/
    2 2 │

Valid

1
var a = 1;

1
class Foo {
2
  bar = undefined;
3
}