Skip to main content

Disallow the void operator except when used to discard a value (no-meaningless-void-operator)

Disallow the void operator when its argument is already of type void or undefined.

Rule Details

The void operator is a useful tool to convey the programmer's intent to discard a value. For example, it is recommended as one way of suppressing @typescript-eslint/no-floating-promises instead of adding .catch() to a promise.

This rule helps an author catch API changes where previously a value was being discarded at a call site, but the callee changed so it no longer returns a value. When combined with no-unused-expressions, it also helps readers of the code by ensuring consistency: a statement that looks like void foo(); is always discarding a return value, and a statement that looks like foo(); is never discarding a return value.

Examples of code for this rule:

void (() => {})();

function foo() {}
void foo();


This rule accepts a single object option with the following default configuration:

"@typescript-eslint/no-meaningless-void-operator": [
"checkNever": false
  • checkNever: true will suggest removing void when the argument has type never.


  • โœ… Recommended
  • ๐Ÿ”ง Fixable
  • ๐Ÿ’ญ Requires type information