useAwait

此内容尚不支持你的语言。

JavaScript (and super languages)

Summary

Rule available since: v1.4.0
Diagnostic Category: lint/suspicious/useAwait
This rule doesn’t have a fix.
The default severity of this rule is warning.
Sources:
- Same as require-await
- Same as @typescript-eslint/require-await

How to configure

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

Description

Ensure async functions utilize await.

This rule reports async functions that lack an await expression. As async functions return a promise, the use of await is often necessary to capture the resolved value and handle the asynchronous operation appropriately. Without await, the function operates synchronously and might not leverage the advantages of async functions.

Examples

Invalid

1
async function fetchData() {
2
// Missing `await` for the promise returned by `fetch`
3
  return fetch('/data');
4
}

code-block.js:1:1 lint/suspicious/useAwait ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ⚠ This async function lacks an await expression.
  
  > 1 │ async function fetchData() {
      │ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  > 2 │ // Missing `await` for the promise returned by `fetch`
  > 3 │   return fetch(‘/data’);
  > 4 │ }
      │ ^
    5 │ 
  
  ℹ Remove this async modifier, or add an await expression in the function.
  
  > 1 │ async function fetchData() {
      │ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  > 2 │ // Missing `await` for the promise returned by `fetch`
  > 3 │   return fetch(‘/data’);
  > 4 │ }
      │ ^
    5 │ 
  
  ℹ Async functions without await expressions may not need to be declared async.

Valid

1
async function fetchData() {
2
  const response = await fetch('/data');
3
  const data = await response.json();
4
  return data;
5
}
6

7
// This rule does not warn about non-async functions
8
function processData() {
9
  return compute(data);
10
}
11

12
// Nor does it warn about empty `async` functions
13
async function noop() { }