"lint/nursery/noDuplicatedSpreadProps": "https://biomejs.dev/linter/rules/no-duplicated-spread-props",

"lint/nursery/noVueVIfWithVFor": "https://biomejs.dev/linter/rules/no-vue-v-if-with-v-for",

"lint/nursery/useAwaitThenable": "https://biomejs.dev/linter/rules/use-await-thenable",

"lint/nursery/useRequiredScripts": "https://biomejs.dev/linter/rules/use-required-scripts",

pub mod use_await_thenable;

declare_lint_group! { pub Nursery { name : "nursery" , rules : [self :: no_continue :: NoContinue , self :: no_deprecated_imports :: NoDeprecatedImports , self :: no_duplicated_spread_props :: NoDuplicatedSpreadProps , self :: no_empty_source :: NoEmptySource , self :: no_equals_to_null :: NoEqualsToNull , self :: no_floating_promises :: NoFloatingPromises , self :: no_for_in :: NoForIn , self :: no_import_cycles :: NoImportCycles , self :: no_increment_decrement :: NoIncrementDecrement , self :: no_jsx_literals :: NoJsxLiterals , self :: no_leaked_render :: NoLeakedRender , self :: no_misused_promises :: NoMisusedPromises , self :: no_multi_str :: NoMultiStr , self :: no_next_async_client_component :: NoNextAsyncClientComponent , self :: no_parameters_only_used_in_recursion :: NoParametersOnlyUsedInRecursion , self :: no_proto :: NoProto , self :: no_react_forward_ref :: NoReactForwardRef , self :: no_shadow :: NoShadow , self :: no_sync_scripts :: NoSyncScripts , self :: no_ternary :: NoTernary , self :: no_unknown_attribute :: NoUnknownAttribute , self :: no_unnecessary_conditions :: NoUnnecessaryConditions , self :: no_unresolved_imports :: NoUnresolvedImports , self :: no_unused_expressions :: NoUnusedExpressions , self :: no_useless_catch_binding :: NoUselessCatchBinding , self :: no_useless_undefined :: NoUselessUndefined , self :: no_vue_data_object_declaration :: NoVueDataObjectDeclaration , self :: no_vue_duplicate_keys :: NoVueDuplicateKeys , self :: no_vue_reserved_keys :: NoVueReservedKeys , self :: no_vue_reserved_props :: NoVueReservedProps , self :: no_vue_setup_props_reactivity_loss :: NoVueSetupPropsReactivityLoss , self :: use_array_sort_compare :: UseArraySortCompare , self :: use_await_thenable :: UseAwaitThenable , self :: use_consistent_arrow_return :: UseConsistentArrowReturn , self :: use_exhaustive_switch_cases :: UseExhaustiveSwitchCases , self :: use_explicit_type :: UseExplicitType , self :: use_find :: UseFind , self :: use_max_params :: UseMaxParams , self :: use_qwik_method_usage :: UseQwikMethodUsage , self :: use_qwik_valid_lexical_scope :: UseQwikValidLexicalScope , self :: use_regexp_exec :: UseRegexpExec , self :: use_sorted_classes :: UseSortedClasses , self :: use_spread :: UseSpread , self :: use_vue_define_macros_order :: UseVueDefineMacrosOrder , self :: use_vue_multi_word_component_names :: UseVueMultiWordComponentNames ,] } }

use biome_analyze::{

Rule, RuleDiagnostic, RuleDomain, RuleSource, context::RuleContext, declare_lint_rule,

use biome_console::markup;

use biome_js_syntax::JsAwaitExpression;

use biome_rowan::AstNode;

use biome_rule_options::use_await_thenable::UseAwaitThenableOptions;

use crate::services::typed::Typed;

declare_lint_rule! {

/// Enforce that `await` is _only_ used on `Promise` values.

///

/// :::caution

/// At the moment, this rule only checks for instances of the global

/// `Promise` class. This is a major shortcoming compared to the ESLint

/// rule if you are using custom `Promise`-like implementations such as

/// [Bluebird](http://bluebirdjs.com/) or in-house solutions.

/// :::

///

/// ## Examples

///

/// ### Invalid

///

/// ```js,expect_diagnostic,file=invalid-primitive.js

/// await 'value';

/// ```

///

/// ```js,expect_diagnostic,file=invalid-function-call.js

/// const createValue = () => 'value';

/// await createValue();

/// ```

///

/// ### Valid

///

/// ```js,file=valid-examples.js

/// await Promise.resolve('value');

///

/// const createValue = async () => 'value';

/// await createValue();

/// ```

///

pub UseAwaitThenable {

version: "next",

name: "useAwaitThenable",

language: "js",

recommended: false,

sources: &[RuleSource::EslintTypeScript("use-await-thenable").inspired()],

domains: &[RuleDomain::Project],

}

impl Rule for UseAwaitThenable {

type Query = Typed<JsAwaitExpression>;

type State = ();

type Signals = Option<Self::State>;

type Options = UseAwaitThenableOptions;

fn run(ctx: &RuleContext<Self>) -> Self::Signals {

let node = ctx.query();

let expression = node.argument().ok()?;

let ty = ctx.type_of_expression(&expression);

// Uncomment the following line for debugging convenience:

//let printed = format!("type of {expression:?} = {ty:?}");

(ty.is_inferred() && !ty.is_promise_instance()).then_some(())

}

fn diagnostic(ctx: &RuleContext<Self>, _state: &Self::State) -> Option<RuleDiagnostic> {

let node = ctx.query();

Some(

RuleDiagnostic::new(

rule_category!(),

node.range(),

markup! {

"`await` used on a non-Promise value."

},

)

.note(markup! {

"This may happen if you accidentally used `await` on a synchronous value."

})

.note(markup! {

"Please ensure the value is not a custom \"thenable\" implementation before removing the `await`: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise#thenables"

}),

)

}

await 'value';

const createValue = () => 'value';

await createValue();

source: crates/biome_js_analyze/tests/spec_tests.rs

expression: invalid.js

# Input

# Diagnostics

await Promise.resolve('value');

const createValue = async () => 'value';

await createValue();