identity

Returns the given value unchanged

Useful as a default transform, in function composition, or as a placeholder mapper.

Available since v2.0.0

Import

import { identity } from '@helpers4/function';
// or, from the all-in-one package (same code, one install):
import { identity } from 'helpers4/function';

Signature

identity<T>(value: T): T

Parameters

Parameter	Type	Description
value	T	The value to return

Returns

T — The same value

Examples

Return a primitive unchanged

The value is returned as-is with its type preserved.

identity(42);       // 42
identity('hello');  // 'hello'
identity(true);     // true

Use as a default mapper

Pass identity where a transform function is required but no transformation is needed.

[1, 2, 3].map(identity); // [1, 2, 3]

Source

View source on GitHub