defaultTo

INFO

This function is only available in es-toolkit/compat for compatibility reasons. It either has alternative native JavaScript APIs or isn’t fully optimized yet.

When imported from es-toolkit/compat, it behaves exactly like lodash and provides the same functionalities, as detailed here.

Returns the default value for null, undefined, and NaN.

Signature

function defaultTo<T>(value: T | null | undefined, defaultValue?: T): T;
function defaultTo(value?: unknown, defaultValue?: unknown): any;

Parameters

• value (unknown): The value to check.
• defaultValue (unknown): The default value to return if the value is null, undefined, or NaN.

Returns

(unknown): Returns either the first value or the default value.

Examples

defaultTo(null, 'default'); // returns 'default'
defaultTo(undefined, 42); // returns 42
defaultTo(NaN, 0); // returns 0
defaultTo('actual', 'default'); // returns 'actual'
defaultTo(123, 0); // returns 123