Top Level Await

[rwaldron]

ref: https://tc39.es/proposal-top-level-await/

@leobalter please fill in the following work lists and commence work on new test material:

• AsyncFunctionStart ( promiseCapability, asyncFunctionBody )

  • ...

• AsyncBlockStart ( promiseCapability, asyncBody, asyncContext )

  • ...

• Abstract Module Records

  • ...

• Cyclic Module Records

  • ...

• Table 3: Additional Fields of Cyclic Module Records

  • [[Async]]
    • ...
  • [[AsyncEvaluating]] true or false Whether this module is currently awaiting async fulfillment.
    • ...
  • [[TopLevelCapability]]
    • ...
  • [[AsyncParentModules]]
    • ...
  • [[PendingAsyncDependencies]]
    • ...

• Table 4: Additional Abstract Methods of Cyclic Module Records

  • ExecuteModule( [ promiseCapability ] )
    • ...

• Link ( ) Concrete Method

  • ...

• InnerModuleLinking ( module, stack, index )

  • ...

• Evaluate ( ) Concrete Method

  • ...

• InnerModuleEvaluation( module, stack, index )

  • ...

• ExecuteAsyncModule ( module )

  • ...

• GetCycleRoot ( module )

  • ...

• AsyncModuleExecutionFulfilled ( module )

  • ...

• AsyncModuleExecutionRejected ( module, error )

  • ...

• Source Text Module Records

  • ...

• ParseModule ( sourceText, realm, hostDefined )

  • ...

• ExecuteModule ( [ capability ] )

  • ...

• Runtime Semantics: TopLevelModuleEvaluationJob ( sourceText, hostDefined )

  • ...

• Modules

StatementListItem[~Yield, +Await, ~Return]

• Async Function Definitions (Syntax)
  • ...
• Imports
  • ...
• Exports
  • ...

Note: There may be top level sections missings, so please keep an eye out for that.

[leobalter]

The coverage is done for this.

[mb21]

Hello! This issue mentions "Cyclic Module Records", but being unfamiliar with this testsuite, I'm unsure whether in the end any tests regarding that were added? The reason I'm asking is that it would be nice to reference a test that would be failing in Safari for web-platform-tests/interop#1105, thanks!

[ptomato]

@mb21 Sorry, none of the maintainers from 2019 are still involved with the project. At this point your best bet is to take a look at which toplevel await tests fail in JavaScriptCore and then see if one covers the case you are interested in.

You can use ESVU to install a recent JSC standalone interpreter. The incantation that will get you the JSC results for all toplevel await tests is

npx test262-harness --hostType=jsc --hostPath=$HOME/.esvu/bin/jsc -f top-level-await "test/**"

Also check the tests in #4465, #4500, #4501, #4502 which may be related to what you are looking for.

[mb21]

@ptomato thanks a lot!

For that incantation to work, I first need to npx esvu install jsc , correct? Unfortunately, I get:

Fatal error installing JavaScriptCore Error: Unsupported macOS release: sequoia

Since there doesn't seem to be a way to install older versions of an engine, seems I first have to update macOS? Well yes, let's see when I get around to that. 😅

I don't suppose this testsuite is run and listed somewhere, similar to https://wpt.fyi/results/ ?

[ptomato]

@mb21 Yes, https://test262.fyi/# - but you won't be able to select for only toplevel await tests.