child_process: add env contents types in JSDoc

Use JSDoc to indicate that the `env` object keys and values must be
strings.

Refs: https://github.com/nodejs/node/pull/42489#discussion_r835867932

PR-URL: https://github.com/nodejs/node/pull/42494
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
This commit is contained in:
Rich Trott 2022-03-30 07:03:48 -07:00 committed by GitHub
parent d320d459d2
commit f8ca5dfea4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -98,7 +98,7 @@ const MAX_BUFFER = 1024 * 1024;
* @param {{
* cwd?: string;
* detached?: boolean;
* env?: object;
* env?: Record<string, string>;
* execPath?: string;
* execArgv?: string[];
* gid?: number;
@ -199,7 +199,7 @@ function normalizeExecArgs(command, options, callback) {
* @param {string} command
* @param {{
* cmd?: string;
* env?: object;
* env?: Record<string, string>;
* encoding?: string;
* shell?: string;
* signal?: AbortSignal;
@ -253,7 +253,7 @@ ObjectDefineProperty(exec, promisify.custom, {
* @param {string[]} [args]
* @param {{
* cwd?: string;
* env?: object;
* env?: Record<string, string>;
* encoding?: string;
* timeout?: number;
* maxBuffer?: number;
@ -662,7 +662,7 @@ function abortChildProcess(child, killSignal) {
* @param {string[]} [args]
* @param {{
* cwd?: string;
* env?: object;
* env?: Record<string, string>;
* argv0?: string;
* stdio?: Array | string;
* detached?: boolean;
@ -735,7 +735,7 @@ function spawn(file, args, options) {
* input?: string | Buffer | TypedArray | DataView;
* argv0?: string;
* stdio?: string | Array;
* env?: object;
* env?: Record<string, string>;
* uid?: number;
* gid?: number;
* timeout?: number;
@ -827,7 +827,7 @@ function checkExecSyncError(ret, args, cmd) {
* cwd?: string;
* input?: string | Buffer | TypedArray | DataView;
* stdio?: string | Array;
* env?: object;
* env?: Record<string, string>;
* uid?: number;
* gid?: number;
* timeout?: number;
@ -864,7 +864,7 @@ function execFileSync(command, args, options) {
* cwd?: string;
* input?: string | Buffer | TypedArray | DataView;
* stdio?: string | Array;
* env?: object;
* env?: Record<string, string>;
* shell?: string;
* uid?: number;
* gid?: number;