doc: update example of using await in REPL

Lexical scope of `const` is only invalidated when using top-level `await` in REPL. Fixes: #45918
nodejs · Dec 23, 2022 · 31508ee · 31508ee
1 parent 0f4446c
commit 31508ee
Showing 1 changed file with 15 additions and 0 deletions.
diff --git a/doc/api/repl.md b/doc/api/repl.md
@@ -234,6 +234,21 @@ undefined
 undefined
 ```
 
+One known limitation of using the `await` keyword in the REPL is that
+it will invalidate the lexical scoping of the `const`
+keywords.
+
+For example:
+
+```console
+> const m = await Promise.resolve(123)
+undefined
+> m
+123
+> m = await Promise.resolve(234)
+234
+```
+
 [`--no-experimental-repl-await`][] shall disable top-level await in REPL.
 
 ### Reverse-i-search