@@ -3990,6 +3990,29 @@ Instantiating classes without the `new` qualifier exported by the `node:http` mo
3990
3990
It is recommended to use the ` new ` qualifier instead. This applies to all http classes, such as
3991
3991
` OutgoingMessage ` , ` IncomingMessage ` , ` ServerResponse ` and ` ClientRequest ` .
3992
3992
3993
+ ### DEP0196: Calling ` node:child_process ` functions with ` options.shell ` as an empty string
3994
+
3995
+ <!-- YAML
3996
+ changes:
3997
+ - version: REPLACEME
3998
+ pr-url: https://github.com/nodejs/node/pull/58564
3999
+ description: Documentation-only deprecation.
4000
+ -->
4001
+
4002
+ Type: Documentation-only
4003
+
4004
+ Calling the process-spawning functions with ` { shell: '' } ` is almost certainly
4005
+ unintentional, and can cause aberrant behavior.
4006
+
4007
+ To make [ ` child_process.execFile ` ] [ ] or [ ` child_process.spawn ` ] [ ] invoke the
4008
+ default shell, use ` { shell: true } ` . If the intention is not to invoke a shell
4009
+ (default behavior), either omit the ` shell ` option, or set it to ` false ` or a
4010
+ nullish value.
4011
+
4012
+ To make [ ` child_process.exec ` ] [ ] invoke the default shell, either omit the
4013
+ ` shell ` option, or set it to a nullish value. If the intention is not to invoke
4014
+ a shell, use [ ` child_process.execFile ` ] [ ] instead.
4015
+
3993
4016
[ DEP0142 ] : #dep0142-repl_builtinlibs
3994
4017
[ NIST SP 800-38D ] : https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
3995
4018
[ RFC 6066 ] : https://tools.ietf.org/html/rfc6066#section-3
@@ -4018,6 +4041,7 @@ It is recommended to use the `new` qualifier instead. This applies to all http c
4018
4041
[ `asyncResource.runInAsyncScope()` ] : async_context.md#asyncresourceruninasyncscopefn-thisarg-args
4019
4042
[ `buffer.subarray` ] : buffer.md#bufsubarraystart-end
4020
4043
[ `child_process.execFile` ] : child_process.md#child_processexecfilefile-args-options-callback
4044
+ [ `child_process.exec` ] : child_process.md#child_processexeccommand-options-callback
4021
4045
[ `child_process.spawn` ] : child_process.md#child_processspawncommand-args-options
4022
4046
[ `child_process` ] : child_process.md
4023
4047
[ `clearInterval()` ] : timers.md#clearintervaltimeout
0 commit comments