Skip to content

Commit ce03a18

Browse files
committed
doc: clarify experimental API elements in vm.md
Remove redundant "should not be considered stable" (it immediately follows a clause saying that it is "experimental") and replace with a more clear (to me, at least) statement that we don't recommend using the feature in production. PR-URL: nodejs#35594 Reviewed-By: James M Snell <jasnell@gmail.com>
1 parent 7afe3af commit ce03a18

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

doc/api/vm.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -87,8 +87,8 @@ changes:
8787
* `importModuleDynamically` {Function} Called during evaluation of this module
8888
when `import()` is called. If this option is not specified, calls to
8989
`import()` will reject with [`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`][].
90-
This option is part of the experimental modules API, and should not be
91-
considered stable.
90+
This option is part of the experimental modules API. We do not recommend
91+
using it in a production environment.
9292
* `specifier` {string} specifier passed to `import()`
9393
* `script` {vm.Script}
9494
* Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is
@@ -981,8 +981,8 @@ changes:
981981
* `importModuleDynamically` {Function} Called during evaluation of this module
982982
when `import()` is called. If this option is not specified, calls to
983983
`import()` will reject with [`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`][].
984-
This option is part of the experimental modules API, and should not be
985-
considered stable.
984+
This option is part of the experimental modules API. We do not recommend
985+
using it in a production environment.
986986
* `specifier` {string} specifier passed to `import()`
987987
* `script` {vm.Script}
988988
* Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is
@@ -1079,8 +1079,8 @@ changes:
10791079
* `importModuleDynamically` {Function} Called during evaluation of this module
10801080
when `import()` is called. If this option is not specified, calls to
10811081
`import()` will reject with [`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`][].
1082-
This option is part of the experimental modules API, and should not be
1083-
considered stable.
1082+
This option is part of the experimental modules API. We do not recommend
1083+
using it in a production environment.
10841084
* `specifier` {string} specifier passed to `import()`
10851085
* `script` {vm.Script}
10861086
* Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is
@@ -1158,8 +1158,8 @@ changes:
11581158
* `importModuleDynamically` {Function} Called during evaluation of this module
11591159
when `import()` is called. If this option is not specified, calls to
11601160
`import()` will reject with [`ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`][].
1161-
This option is part of the experimental modules API, and should not be
1162-
considered stable.
1161+
This option is part of the experimental modules API. We do not recommend
1162+
using it in a production environment.
11631163
* `specifier` {string} specifier passed to `import()`
11641164
* `script` {vm.Script}
11651165
* Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is

0 commit comments

Comments
 (0)