repl: document top level await limitation with const/let

Fixes: nodejs#17669 Signed-off-by: James M Snell <jasnell@gmail.com>
jasnell · Apr 28, 2021 · d846610 · d846610
1 parent 3240435
commit d846610
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: