Function mergeArgsAsync

Returns an updated version of defaults merged with the contents of inputs.

Useful for parsing objects passed to functions with extra, optional options. Preserves all input properties.

Overloaded for better typing dependent on recursion.

Since

0.1.0

mergeArgsAsync<D extends object>(
    defaults: D,
    inputs?: undefined,
    recursive?: boolean,
    mergeArrays?: boolean,
): Promise<D>
Inputs can be undefined, and if so, the default is returned.
Type Parameters
- D extends object
  Default object type.
Parameters
- defaults: D
  Default values (if not specified in inputs).
- Optionalinputs: undefined
  Overriding values (changes to make).
- Optionalrecursive: boolean
  Optional. Whether to merge the object recursively. Default false.
- OptionalmergeArrays: boolean
Returns Promise<D>
Resulting object with all the defaults and inputs keys with either default values or input values, as appropriate.
- Defined in functions/objects/mergeArgsAsync.ts:30
mergeArgsAsync<D extends object, I extends Partial<D>>(
    defaults: D,
    inputs: I,
    recursive?: false,
    mergeArrays?: boolean,
): Promise<D & I>
Passing recursive as false means that the input type must be a Partial (not RecursivePartial).
Type Parameters
- D extends object
- I extends Partial<D>
Parameters
- defaults: D
- inputs: I
- Optionalrecursive: false
- OptionalmergeArrays: boolean
Returns Promise<D & I>
- Defined in functions/objects/mergeArgsAsync.ts:43
mergeArgsAsync<D extends object, I extends Partial<D> | RecursivePartial<D>>(
    defaults: D,
    inputs: I,
    recursive: true,
    mergeArrays?: boolean,
): Promise<D & I>
Passing recursive as true means that the input type may actually be a RecursivePartial.
Type Parameters
- D extends object
- I extends Partial<D> | RecursivePartial<D>
Parameters
- defaults: D
- inputs: I
- recursive: true
- OptionalmergeArrays: boolean
Returns Promise<D & I>
- Defined in functions/objects/mergeArgsAsync.ts:57
mergeArgsAsync<D extends object, I extends Partial<D> | RecursivePartial<D>>(
    defaults: D,
    inputs?: I,
    recursive?: boolean,
    mergeArrays?: boolean,
): Promise<D | D & I>
Universal overload.
Type Parameters
- D extends object
- I extends Partial<D> | RecursivePartial<D>
Parameters
- defaults: D
- Optionalinputs: I
- Optionalrecursive: boolean
- OptionalmergeArrays: boolean
Returns Promise<D | D & I>
- Defined in functions/objects/mergeArgsAsync.ts:70

Function mergeArgsAsync

Since

Type Parameters

Parameters

Returns Promise<D>

Type Parameters

Parameters

Returns Promise<D & I>

Type Parameters

Parameters

Returns Promise<D & I>

Type Parameters

Parameters

Returns Promise<D | D & I>

Settings