Skip to content

Better error and quick fix for missing await #30646

Closed
@bterlson

Description

@bterlson

Search Terms

missing await error refactoring

Suggestion

Missing an await can cause some confusion especially for people who haven't used async/await before. A helpful error message when you have a Promise<T> instead of T that suggests maybe an await is missing might help address this. There are at least a few common cases this comes up:

  • Using operators, and T is a primitive type. If T were say an object type, it seems more likely something else is wrong with the code to me.
  • Passing to a function, and T is a valid parameter at that position.
  • for-of and T is some array type
  • The target of a member expression and T has the member (or maybe the property name is not in Promise).

A quick fix could also be considered. When in an async function and an error such as above appears, a quick fix that adds an await before the source of the promise within that function.

Use Cases

It helps people realize when they need an await.

Checklist

My suggestion meets these guidelines:

  • This wouldn't be a breaking change in existing TypeScript/JavaScript code
    This wouldn't change the runtime behavior of existing JavaScript code
    This could be implemented without emitting different JS based on the types of the expressions
    This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, etc.)
    This feature would agree with the rest of TypeScript's Design Goals.

Activity

changed the title [-]Better error and quick fix[/-] [+]Better error and quick fix for missing await[/+] on Mar 29, 2019
bterlson

bterlson commented on Apr 1, 2019

@bterlson
MemberAuthor

Ugh, realized html ate a <T> above. The request should hopefully be more clear now.

DanielRosenwasser

DanielRosenwasser commented on Apr 2, 2019

@DanielRosenwasser
Member

It's funny because I filed #22923 but not this I guess?

voliva

voliva commented on Jun 4, 2019

@voliva

Another suggestion related to this one is the opposite: When there's "await" on things that are not Promises.

const calculateSum = (a: number, b: number) => a + b;

async function someAsyncFn() {
     // ...
    const result = await calculateSum(a, b);
    // ...
}

Those are definitely not errors, but I think it helps on readability if synchronous stuff is kept in a synchronous way.
Keep in mind that in case calculateSum returns number | Promise<number> then this warning shouldn't show up.

I'm really not sure if this can/should be added into this issue - For one part it feels closely related (using or not using await on promises) but on the other hand the original issue is tackling something that can potentially lead to errors whereas this one is just.... style.

Yes, now I'm more convinced this shouldn't be here.

movedoa

movedoa commented on Jun 17, 2019

@movedoa

@voliva Since most of the legwork should already be done at that point i see no reson to not add this.

ghiscoding

ghiscoding commented on Jun 23, 2019

@ghiscoding

Another suggestion related to this one is the opposite: When there's "await" on things that are not Promises.

const calculateSum = (a: number, b: number) => a + b;

async function someAsyncFn() {
     // ...
    const result = await calculateSum(a, b);
    // ...
}

Personally I would prefer to see a warning (or an error) on the const result = await calculateSum(a, b); telling the user that the await is unnecessary since TypeScript already knows, by inference, that the outcome of that call is synchronous and there is nothing to await. That would push the user to cleanup his code and remove the unnecessary async/await all together.

8 remaining items

Loading
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Relationships

None yet

    Development

    Participants

    @bterlson@aslatter@ghiscoding@DanielRosenwasser@andrewbranch

    Issue actions

      Better error and quick fix for missing await · Issue #30646 · microsoft/TypeScript