noUselessCatchBinding (JavaScript)

Language JavaScript (and super languages)

Summary

Rule available since: v2.2.3
Diagnostic Category: lint/complexity/noUselessCatchBinding
This rule isn’t recommended, so you need to enable it.
This rule has an unsafe fix.
The default severity of this rule is information.

How to configure

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

Description

Disallow unused catch bindings.

This rule disallows unnecessary catch bindings in accordance with ECMAScript 2019. See also: the ECMAScript 2019 “optional catch binding” feature in the language specification.

Examples

Invalid

1
try {
2
    // Do something
3
} catch (unused) {}

code-block.js:3:9 lint/complexity/noUselessCatchBinding  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ This catch binding is unused.
  
    1 │ try {
    2 │     // Do something
  > 3 │ } catch (unused) {}
      │         ^^^^^^^^
    4 │ 
  
  ℹ Since ECMAScript 2019, catch bindings are optional; you can omit the catch binding if you don't need it.
  
  ℹ Unsafe fix: Remove the catch binding.
  
    3 │ }·catch·(unused)·{}
      │         ---------

1
try {
2
    // Do something
3
} catch ({ unused }) {}

code-block.js:3:9 lint/complexity/noUselessCatchBinding  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ This catch binding is unused.
  
    1 │ try {
    2 │     // Do something
  > 3 │ } catch ({ unused }) {}
      │         ^^^^^^^^^^^^
    4 │ 
  
  ℹ Since ECMAScript 2019, catch bindings are optional; you can omit the catch binding if you don't need it.
  
  ℹ Unsafe fix: Remove the catch binding.
  
    3 │ }·catch·({·unused·})·{}
      │         -------------

1
try {
2
    // Do something
3
} catch ({ unused1, unused2 }) {}

code-block.js:3:9 lint/complexity/noUselessCatchBinding  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ This catch binding is unused.
  
    1 │ try {
    2 │     // Do something
  > 3 │ } catch ({ unused1, unused2 }) {}
      │         ^^^^^^^^^^^^^^^^^^^^^^
    4 │ 
  
  ℹ Since ECMAScript 2019, catch bindings are optional; you can omit the catch binding if you don't need it.
  
  ℹ Unsafe fix: Remove the catch binding.
  
    3 │ }·catch·({·unused1,·unused2·})·{}
      │         -----------------------

Valid

1
try {
2
    // Do something
3
} catch (used) {
4
    console.error(used);
5
}

1
try {
2
    // Do something
3
} catch ({ used }) {
4
    console.error(used);
5
}

1
try {
2
    // Do something
3
} catch ({ used, unused }) {
4
    console.error(used);
5
}

1
try {
2
    // Do something
3
} catch {}