no-return-await
禁止不必要的 return await
💡 hasSuggestions
此规则报告的一些问题可以通过编辑器 建议 手动修复
此规则在 ESLint v8.46.0 中被弃用，没有替换。此规则的最初目的是阻止使用 return await，以避免额外的微任务。但是，由于 JavaScript 现在以不同的方式处理原生 Promise，因此不再有额外的微任务。更多技术信息可以在 此 V8 博客条目 中找到。
在 async function 内使用 return await 会使当前函数保留在调用堆栈中，直到被等待的 Promise 解析，代价是在解析外部 Promise 之前产生额外的微任务。return await 也可以在 try/catch 语句中使用，以捕获从返回 Promise 的另一个函数抛出的错误。
您可以通过不等待返回值来避免额外的微任务，代价是如果从被返回的 Promise 异步抛出错误，则函数不再是堆栈跟踪的一部分。这可能会使调试更加困难。
规则详细信息
此规则旨在防止由于缺乏对 async function 语义的理解而可能发生的常见性能问题。
此规则的不正确代码示例
在游乐场中打开
/*eslint no-return-await: "error"*/
async function foo() {
return ;
}
此规则的正确代码示例
在游乐场中打开
/*eslint no-return-await: "error"*/
async function foo1() {
return bar();
}
async function foo2() {
await bar();
return;
}
// This is essentially the same as `return await bar();`, but the rule checks only `await` in `return` statements
async function foo3() {
const x = await bar();
return x;
}
// In this example the `await` is necessary to be able to catch errors thrown from `bar()`
async function foo4() {
try {
return await bar();
} catch (error) {}
}
何时不使用它
您可能想要关闭此规则的几个原因
- 如果您想使用
await来表示可 then 的值 - 如果您不想避免
return await的性能优势 - 如果您想让函数显示在堆栈跟踪中（这对调试目的很有用）
版本
此规则是在 ESLint v3.10.0 中引入的。
进一步阅读
