Commit ce03a18
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: #35594
Reviewed-By: James M Snell <jasnell@gmail.com>1 parent 7afe3af commit ce03a18
1 file changed
Lines changed: 8 additions & 8 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -87,8 +87,8 @@ changes: | |||
| 87 | 87 | * `importModuleDynamically` {Function} Called during evaluation of this module | |
| 88 | 88 | when `import()` is called. If this option is not specified, calls to | |
| 89 | 89 | `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. | ||
| 92 | 92 | * `specifier` {string} specifier passed to `import()` | |
| 93 | 93 | * `script` {vm.Script} | |
| 94 | 94 | * Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is | |
@@ -981,8 +981,8 @@ changes: | |||
| 981 | 981 | * `importModuleDynamically` {Function} Called during evaluation of this module | |
| 982 | 982 | when `import()` is called. If this option is not specified, calls to | |
| 983 | 983 | `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. | ||
| 986 | 986 | * `specifier` {string} specifier passed to `import()` | |
| 987 | 987 | * `script` {vm.Script} | |
| 988 | 988 | * Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is | |
@@ -1079,8 +1079,8 @@ changes: | |||
| 1079 | 1079 | * `importModuleDynamically` {Function} Called during evaluation of this module | |
| 1080 | 1080 | when `import()` is called. If this option is not specified, calls to | |
| 1081 | 1081 | `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. | ||
| 1084 | 1084 | * `specifier` {string} specifier passed to `import()` | |
| 1085 | 1085 | * `script` {vm.Script} | |
| 1086 | 1086 | * Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is | |
@@ -1158,8 +1158,8 @@ changes: | |||
| 1158 | 1158 | * `importModuleDynamically` {Function} Called during evaluation of this module | |
| 1159 | 1159 | when `import()` is called. If this option is not specified, calls to | |
| 1160 | 1160 | `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. | ||
| 1163 | 1163 | * `specifier` {string} specifier passed to `import()` | |
| 1164 | 1164 | * `script` {vm.Script} | |
| 1165 | 1165 | * Returns: {Module Namespace Object|vm.Module} Returning a `vm.Module` is | |
0 commit comments