repl: document top level await limitation with const/let

Fixes: #17669 Signed-off-by: James M Snell <[email protected]> PR-URL: #38449 Reviewed-By: Jiawen Geng <[email protected]> Reviewed-By: Benjamin Gruenbaum <[email protected]> Reviewed-By: Darshan Sen <[email protected]> Reviewed-By: Yongsheng Zhang <[email protected]>
nodejs · Jun 11, 2021 · cd98180 · cd98180
1 parent aec4b29
commit cd98180
Showing 1 changed file with 17 additions and 0 deletions.
diff --git a/doc/api/repl.md b/doc/api/repl.md
@@ -233,6 +233,23 @@ undefined
 undefined
 ```
 
+One known limitation of using the `await` keyword in the REPL is that
+it will invalidate the lexical scoping of the `const` and `let`
+keywords.
+
+For example:
+
+```console
+> const m = await Promise.resolve(123)
+undefined
+> m
+123
+> const m = await Promise.resolve(234)
+undefined
+> m
+234
+```
+
 ### Reverse-i-search
 <!-- YAML
 added: v13.6.0