doc: mention --experimental-top-level-await flag

PR-URL: #33473 Reviewed-By: Gus Caplan <me@gus.host> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com>
nodejs · May 23, 2020 · c39467c · c39467c
1 parent 9dd7557
commit c39467c
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 1 deletion.
diff --git a/doc/api/cli.md b/doc/api/cli.md
@@ -226,6 +226,16 @@ the ability to import a directory that has an index file.
 
 Please see [customizing ESM specifier resolution][] for example usage.
 
+### `--experimental-top-level-await`
+<!-- YAML
+added: v14.3.0
+-->
+
+Enable experimental top-level `await` keyword support, available only in ES
+module scripts.
+
+(See also `--experimental-repl-await`.)
+
 ### `--experimental-vm-modules`
 <!-- YAML
 added: v9.6.0

diff --git a/doc/changelogs/CHANGELOG_V14.md b/doc/changelogs/CHANGELOG_V14.md
@@ -51,7 +51,8 @@ including the autocompleted part. Pressing `<escape>` cancels that behavior.
 
 #### Support for Top-Level Await
 
-It's now possible to use the await keyword outside of async functions.
+It's now possible to use the await keyword outside of async functions, with the
+`--experimental-top-level-await` flag.
 
 #### Other Notable Changes