Utils Reference

Coverage License NPM Version Open Issues

⚒️ Lou’s Code TypeScript curried functional utils.

Usage

📦 Node

Install @lou.codes/utils as a dependency:

1
pnpm add @lou.codes/utils
2
# or
3
npm install @lou.codes/utils
4
# or
5
yarn add @lou.codes/utils

Import it and use it:

1
import { get } from "@lou.codes/utils";
2

3
get("foo")({ foo: "bar" }); // "bar"

🦕 Deno

Import @lou.codes/utils using the npm: prefix, and use it directly:

1
import { get } from "npm:@lou.codes/utils";
2

3
get("foo")({ foo: "bar" }); // "bar"

🌎 Browser

Import @lou.codes/utils using esm.sh, and use it directly:

1
<script type="module">
2
	import { get } from "https://esm.sh/@lou.codes/utils";
3

4
	get("foo")({ foo: "bar" }); // "bar"
5
</script>

Useful links

📝 Documentation: TypeDoc generated documentation.
⏳ Changelog: List of changes between versions.
✅ Tests Coverage: Coveralls page with tests coverage.

Classes

bind()

1
function bind<Context>(context: Context): <Method>(method: Method) => Method;

Bounds the given context to the given method.

Type parameters

Type parameter
`Context`

Parameters

Parameter	Type
`context`	`Context`

Returns

Function

Curried function with context in context.

Type parameters

Type parameter
`Method` extends `Function`

Parameters

Parameter	Type
`method`	`Method`

Returns

Method

Example

1
const bindConsole = bind(console);
2
const log = bindConsole(console.log);
3

4
log("Hello world!"); // Logs "Hello world!" without context errors.

construct()

1
function construct<Constructor>(
2
	constructor: Constructor,
3
): (
4
	...constructorArguments: ConstructorParameters<Constructor>
5
) => Unbound<InstanceType<Constructor>>;

Creates a new instance of the given constructor with the given arguments. This also binds all functions to the instance.

Type parameters

Type parameter
`Constructor` extends `Class`<`never`>

Parameters

Parameter	Type
`constructor`	`Constructor`

Returns

Function

Curried function with constructor in context.

Parameters

Parameter	Type
…`constructorArguments`	`ConstructorParameters`<`Constructor`>

Returns

Unbound<InstanceType<Constructor>>

Example

1
const constructDate = construct(Date);
2
const { getTime } = constructDate(); // Works because all methods are binded.

constructArray()

constructArray(length)

1
function constructArray<Item>(length: number): object;

Functional alias for new Array().

Type parameters

Type parameter
`Item`

Parameters

Parameter	Type
`length`	`number`

Returns

object

Member	Type	Description
`[unscopables]`	`object`	Is an object whose properties have the value ‘true’ when they will be absent when used in a ‘with’ statement.
`[unscopables].[unscopables]`	`boolean`	Is an object whose properties have the value ‘true’ when they will be absent when used in a ‘with’ statement.
`[unscopables].length`	`boolean`	Gets the length of the array. This is a number one higher than the highest element defined in an array.
`[unscopables].[iterator]`		-
`[unscopables].at`		-
`[unscopables].concat`		-
`[unscopables].entries`		-
`[unscopables].every`		-
`[unscopables].filter`		-
`[unscopables].find`		-
`[unscopables].findIndex`		-
`[unscopables].findLast`		-
`[unscopables].findLastIndex`		-
`[unscopables].flat`		-
`[unscopables].flatMap`		-
`[unscopables].forEach`		-
`[unscopables].includes`		-
`[unscopables].indexOf`		-
`[unscopables].join`		-
`[unscopables].keys`		-
`[unscopables].lastIndexOf`		-
`[unscopables].map`		-
`[unscopables].reduce`		-
`[unscopables].reduceRight`		-
`[unscopables].slice`		-
`[unscopables].some`		-
`[unscopables].toLocaleString`		-
`[unscopables].toReversed`		-
`[unscopables].toSorted`		-
`[unscopables].toSpliced`		-
`[unscopables].toString`		-
`[unscopables].values`		-
`[unscopables].with`		-
`length`	`number`	Gets the length of the array. This is a number one higher than the highest element defined in an array.
`[iterator]`	`IterableIterator`<`Item`>	-
`at`	`undefined` \| `Item`	-
`concat`	`Item`[]	-
`entries`	`IterableIterator`<[`number`, `Item`]>	-
`every`	`boolean`	-
`filter`	`Item`[]	-
`find`	`undefined` \| `Item`	-
`findIndex`	`number`	-
`findLast`	`undefined` \| `Item`	-
`findLastIndex`	`number`	-
`flat`	`unknown`[]	-
`flatMap`	`unknown`[]	-
`forEach`	`void`	-
`includes`	`boolean`	-
`indexOf`	`number`	-
`join`	`string`	-
`keys`	`IterableIterator`<`number`>	-
`lastIndexOf`	`number`	-
`map`	`unknown`[]	-
`reduce`	`unknown`	-
`reduceRight`	`unknown`	-
`slice`	`Item`[]	-
`some`	`boolean`	-
`toLocaleString`	`string`	-
`toReversed`	`Item`[]	-
`toSorted`	`Item`[]	-
`toSpliced`	`Item`[]	-
`toString`	`string`	-
`values`	`IterableIterator`<`Item`>	-
`with`	`Item`[]	-

constructArray(items)

1
function constructArray<Items>(...items: Items): object;

Functional alias for new Array().

Type parameters

Type parameter
`Items` extends `ReadOnlyArray`

Parameters

Parameter	Type
…`items`	`Items`

Returns

object

Member	Type	Description
`[unscopables]`	`object`	Is an object whose properties have the value ‘true’ when they will be absent when used in a ‘with’ statement.
`[unscopables].[unscopables]`	`boolean`	Is an object whose properties have the value ‘true’ when they will be absent when used in a ‘with’ statement.
`[unscopables].length`	`boolean`	Gets the length of the array. This is a number one higher than the highest element defined in an array.
`[unscopables].[iterator]`		-
`[unscopables].at`		-
`[unscopables].concat`		-
`[unscopables].entries`		-
`[unscopables].every`		-
`[unscopables].filter`		-
`[unscopables].find`		-
`[unscopables].findIndex`		-
`[unscopables].findLast`		-
`[unscopables].findLastIndex`		-
`[unscopables].flat`		-
`[unscopables].flatMap`		-
`[unscopables].forEach`		-
`[unscopables].includes`		-
`[unscopables].indexOf`		-
`[unscopables].join`		-
`[unscopables].keys`		-
`[unscopables].lastIndexOf`		-
`[unscopables].map`		-
`[unscopables].reduce`		-
`[unscopables].reduceRight`		-
`[unscopables].slice`		-
`[unscopables].some`		-
`[unscopables].toLocaleString`		-
`[unscopables].toReversed`		-
`[unscopables].toSorted`		-
`[unscopables].toSpliced`		-
`[unscopables].toString`		-
`[unscopables].values`		-
`[unscopables].with`		-
`length`	`number`	Gets the length of the array. This is a number one higher than the highest element defined in an array.
`[iterator]`	`IterableIterator`<`Items`[`number`]>	-
`at`	`undefined` \| `Items`[`number`]	-
`concat`	`Items`[`number`][]	-
`entries`	`IterableIterator`<[`number`, `Items`[`number`]]>	-
`every`	`boolean`	-
`filter`	`Items`[`number`][]	-
`find`	`undefined` \| `Items`[`number`]	-
`findIndex`	`number`	-
`findLast`	`undefined` \| `Items`[`number`]	-
`findLastIndex`	`number`	-
`flat`	`unknown`[]	-
`flatMap`	`unknown`[]	-
`forEach`	`void`	-
`includes`	`boolean`	-
`indexOf`	`number`	-
`join`	`string`	-
`keys`	`IterableIterator`<`number`>	-
`lastIndexOf`	`number`	-
`map`	`unknown`[]	-
`reduce`	`unknown`	-
`reduceRight`	`unknown`	-
`slice`	`Items`[`number`][]	-
`some`	`boolean`	-
`toLocaleString`	`string`	-
`toReversed`	`Items`[`number`][]	-
`toSorted`	`Items`[`number`][]	-
`toSpliced`	`Items`[`number`][]	-
`toString`	`string`	-
`values`	`IterableIterator`<`Items`[`number`]>	-
`with`	`Items`[`number`][]	-

constructDataView()

1
function constructDataView(
2
	...constructorArguments: [ArrayBufferLike & object, number, number]
3
): object;

Functional alias for new DataView().

Parameters

Parameter	Type
…`constructorArguments`	[`ArrayBufferLike` & `object`, `number`, `number`]

Returns

object

Member	Type
`[toStringTag]`	`string`
`buffer`	`ArrayBuffer`
`byteLength`	`number`
`byteOffset`	`number`
`getBigInt64`	`bigint`
`getBigUint64`	`bigint`
`getFloat32`	`number`
`getFloat64`	`number`
`getInt16`	`number`
`getInt32`	`number`
`getInt8`	`number`
`getUint16`	`number`
`getUint32`	`number`
`getUint8`	`number`
`setBigInt64`	`void`
`setBigUint64`	`void`
`setFloat32`	`void`
`setFloat64`	`void`
`setInt16`	`void`
`setInt32`	`void`
`setInt8`	`void`
`setUint16`	`void`
`setUint32`	`void`
`setUint8`	`void`

constructDate()

1
function constructDate(date?: string | number | Readonly<Date>): object;

Functional alias for new Date().

Parameters

Parameter	Type
`date`?	`string` \| `number` \| `Readonly`<`Date`>

Returns

object

Member	Type
`getVarDate`	(`this`: `void`, …`methodArguments`: []) => `VarDate`
`[toPrimitive]`	`string` \| `number`
`getDate`	`number`
`getDay`	`number`
`getFullYear`	`number`
`getHours`	`number`
`getMilliseconds`	`number`
`getMinutes`	`number`
`getMonth`	`number`
`getSeconds`	`number`
`getTime`	`number`
`getTimezoneOffset`	`number`
`getUTCDate`	`number`
`getUTCDay`	`number`
`getUTCFullYear`	`number`
`getUTCHours`	`number`
`getUTCMilliseconds`	`number`
`getUTCMinutes`	`number`
`getUTCMonth`	`number`
`getUTCSeconds`	`number`
`setDate`	`number`
`setFullYear`	`number`
`setHours`	`number`
`setMilliseconds`	`number`
`setMinutes`	`number`
`setMonth`	`number`
`setSeconds`	`number`
`setTime`	`number`
`setUTCDate`	`number`
`setUTCFullYear`	`number`
`setUTCHours`	`number`
`setUTCMilliseconds`	`number`
`setUTCMinutes`	`number`
`setUTCMonth`	`number`
`setUTCSeconds`	`number`
`toDateString`	`string`
`toISOString`	`string`
`toJSON`	`string`
`toLocaleDateString`	`string`
`toLocaleString`	`string`
`toLocaleTimeString`	`string`
`toString`	`string`
`toTimeString`	`string`
`toUTCString`	`string`
`valueOf`	`number`

constructError()

1
function constructError(
2
	...constructorArguments: [string, ErrorOptions]
3
): object;

Functional alias for new Error().

Parameters

Parameter	Type
…`constructorArguments`	[`string`, `ErrorOptions`]

Returns

object

Member	Type
`cause`	`unknown`
`message`	`string`
`name`	`string`
`stack`	`string`

constructIntlCollator()

1
function constructIntlCollator(
2
	...constructorArguments: [LocalesArgument, CollatorOptions]
3
): object;

Functional alias for new Intl.Collator(), which enables language-sensitive string comparison.

Parameters

Parameter	Type
…`constructorArguments`	[`LocalesArgument`, `CollatorOptions`]

Returns

object

Member	Type
`compare`	`number`
`resolvedOptions`	`ResolvedCollatorOptions`

See

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator

constructIntlDateTimeFormat()

1
function constructIntlDateTimeFormat(
2
	...constructorArguments: [LocalesArgument, DateTimeFormatOptions]
3
): object;

Functional alias for new Intl.DateTimeFormat(), which enables language-sensitive date and time formatting.

Parameters

Parameter	Type
…`constructorArguments`	[`LocalesArgument`, `DateTimeFormatOptions`]

Returns

object

Member	Type
`format`	`string`
`formatRange`	`string`
`formatRangeToParts`	`DateTimeRangeFormatPart`[]
`formatToParts`	`DateTimeFormatPart`[]
`resolvedOptions`	`ResolvedDateTimeFormatOptions`

See

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat

constructIntlLocale()

1
function constructIntlLocale(
2
	tag: Readonly<Locale | LocaleIdentifier>,
3
	options?: Readonly<LocaleOptions>,
4
): object;

Functional alias for new Intl.Locale(), which represents a Unicode locale identifier.

Parameters

Parameter	Type
`tag`	`Readonly`<`Locale` \| `LocaleIdentifier`>
`options`?	`Readonly`<`LocaleOptions`>

Returns

object

Member	Type	Description
`baseName`	`string`	A string containing the language, and the script and region if available.
`calendar`	`string`	The part of the Locale that indicates the locale’s calendar era.
`caseFirst`	`LocaleCollationCaseFirst`	Flag that defines whether case is taken into account for the locale’s collation rules.
`collation`	`string`	The collation type used for sorting
`hourCycle`	`LocaleHourCycleKey`	The time keeping format convention used by the locale.
`language`	`string`	The primary language subtag associated with the locale.
`numberingSystem`	`string`	The numeral system used by the locale.
`numeric`	`boolean`	Flag that defines whether the locale has special collation handling for numeric characters.
`region`	`string`	The region of the world (usually a country) associated with the locale. Possible values are region codes as defined by ISO 3166-1.
`script`	`string`	The script used for writing the particular language used in the locale. Possible values are script codes as defined by ISO 15924.
`maximize`	`Locale`	-
`minimize`	`Locale`	-
`toString`	`string`	-

See

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale

constructIntlNumberFormat()

1
function constructIntlNumberFormat(
2
	...constructorArguments: [LocalesArgument, NumberFormatOptions]
3
): object;

Functional alias for new Intl.NumberFormat(), which enables language-sensitive number formatting.

Parameters

Parameter	Type
…`constructorArguments`	[`LocalesArgument`, `NumberFormatOptions`]

Returns

object

Member	Type
`format`	`string`
`formatRange`	`string`
`formatRangeToParts`	`NumberRangeFormatPart`[]
`formatToParts`	`NumberFormatPart`[]
`resolvedOptions`	`ResolvedNumberFormatOptions`

See

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat

constructIntlPluralRules()

1
function constructIntlPluralRules(
2
	...constructorArguments: [LocalesArgument, PluralRulesOptions]
3
): object;

Functional alias for new Intl.PluralRules(), which enables plural-sensitive formatting and plural-related language rules.

Parameters

Parameter	Type
…`constructorArguments`	[`LocalesArgument`, `PluralRulesOptions`]

Returns

object

Member	Type
`resolvedOptions`	`ResolvedPluralRulesOptions`
`select`	`LDMLPluralRule`

See

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules

constructIntlRelativeTimeFormat()

1
function constructIntlRelativeTimeFormat(
2
	...constructorArguments: [LocalesArgument, RelativeTimeFormatOptions]
3
): object;

Functional alias for new Intl.RelativeTimeFormat(), which enables language-sensitive relative time formatting.

Parameters

Parameter	Type
…`constructorArguments`	[`LocalesArgument`, `RelativeTimeFormatOptions`]

Returns

object

Member	Type
`format`	`string`
`formatToParts`	`RelativeTimeFormatPart`[]
`resolvedOptions`	`ResolvedRelativeTimeFormatOptions`

See

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat

constructMap()

1
function constructMap<Key, Value>(
2
	iterable?: Iterable<readonly [Key, Value]>,
3
): object;

Functional alias for new Map().

Type parameters

Type parameter
`Key`
`Value`

Parameters

Parameter	Type
`iterable`?	`Iterable`<readonly [`Key`, `Value`]>

Returns

object

Member	Type	Description
`[toStringTag]`	`string`	-
`size`	`number`
`[iterator]`	`IterableIterator`<[`Key`, `Value`]>	-
`clear`	`void`	-
`delete`	`boolean`	-
`entries`	`IterableIterator`<[`Key`, `Value`]>	-
`forEach`	`void`	-
`get`	`undefined` \| `Value`	-
`has`	`boolean`	-
`keys`	`IterableIterator`<`Key`>	-
`set`	`Map`<`Key`, `Value`>	-
`values`	`IterableIterator`<`Value`>	-

constructPromise()

1
function constructPromise<Value>(
2
	executor: (
3
		resolve: (value: Value) => void,
4
		reject: (reason?: unknown) => void,
5
	) => void,
6
): object;

Functional alias for new Promise().

Type parameters

Type parameter
`Value`

Parameters

Parameter	Type
`executor`	(`resolve`: (`value`: `Value`) => `void`, `reject`: (`reason`?: `unknown`) => `void`) => `void`

Returns

object

Member	Type	Description
`catch`	<`RejectedValue`>(`this`: `void`, `onrejected`?: `Unary`<`unknown`, `RejectedValue` \| `PromiseLike`<`RejectedValue`>>) => `Promise`<`Value` \| `RejectedValue`>	See Promise#then
`then`	<`ResolvedValue`, `RejectedValue`>(`this`: `void`, `onResolved`?: `Unary`<`Value`, `ResolvedValue` \| `PromiseLike`<`ResolvedValue`>>, `onRejected`?: `Unary`<`unknown`, `RejectedValue` \| `PromiseLike`<`RejectedValue`>>) => `Promise`<`ResolvedValue` \| `RejectedValue`>	See Promise#then

constructProxy()

1
function constructProxy<Target>(
2
	target: Target,
3
	handler: ProxyHandler<Target>,
4
): Unbound<Target>;

Functional alias for new Proxy().

Type parameters

Type parameter
`Target` extends `object`

Parameters

Parameter	Type
`target`	`Target`
`handler`	`ProxyHandler`<`Target`>

Returns

Unbound<Target>

constructRangeError()

1
function constructRangeError(
2
	...constructorArguments: [string, ErrorOptions]
3
): object;

Functional alias for new RangeError().

Parameters

Parameter	Type
…`constructorArguments`	[`string`, `ErrorOptions`]

Returns

object

Member	Type
`cause`	`unknown`
`message`	`string`
`name`	`string`
`stack`	`string`

constructReferenceError()

1
function constructReferenceError(
2
	...constructorArguments: [string, ErrorOptions]
3
): object;

Functional alias for new ReferenceError().

Parameters

Parameter	Type
…`constructorArguments`	[`string`, `ErrorOptions`]

Returns

object

Member	Type
`cause`	`unknown`
`message`	`string`
`name`	`string`
`stack`	`string`

constructRegExp()

1
function constructRegExp(
2
	...constructorArguments: [string | RegExp, string]
3
): object;

Functional alias for new RegExp().

Parameters

Parameter	Type
…`constructorArguments`	[`string` \| `RegExp`, `string`]

Returns

object

Member	Type	Description
`dotAll`	`boolean`	Returns a Boolean value indicating the state of the dotAll flag (s) used with a regular expression. Default is false. Read-only.
`flags`	`string`	Returns a string indicating the flags of the regular expression in question. This field is read-only. The characters in this string are sequenced and concatenated in the following order: - “g” for global - “i” for ignoreCase - “m” for multiline - “u” for unicode - “y” for sticky If no flags are set, the value is the empty string.
`global`	`boolean`	Returns a Boolean value indicating the state of the global flag (g) used with a regular expression. Default is false. Read-only.
`hasIndices`	`boolean`	Returns a Boolean value indicating the state of the hasIndices flag (d) used with with a regular expression. Default is false. Read-only.
`ignoreCase`	`boolean`	Returns a Boolean value indicating the state of the ignoreCase flag (i) used with a regular expression. Default is false. Read-only.
`lastIndex`	`number`	-
`multiline`	`boolean`	Returns a Boolean value indicating the state of the multiline flag (m) used with a regular expression. Default is false. Read-only.
`source`	`string`	Returns a copy of the text of the regular expression pattern. Read-only. The regExp argument is a Regular expression object. It can be a variable name or a literal.
`sticky`	`boolean`	Returns a Boolean value indicating the state of the sticky flag (y) used with a regular expression. Default is false. Read-only.
`unicode`	`boolean`	Returns a Boolean value indicating the state of the Unicode flag (u) used with a regular expression. Default is false. Read-only.
`[matchAll]`	`IterableIterator`<`RegExpMatchArray`>	-
`[match]`	`null` \| `RegExpMatchArray`	-
`[replace]`	`string`	-
`[search]`	`number`	-
`[split]`	`string`[]	-
`compile`	`RegExp`	-
`exec`	`null` \| `RegExpExecArray`	-
`test`	`boolean`	-

constructSet()

1
function constructSet<Value>(iterable?: Iterable<Value>): object;

Functional alias for new Set().

Type parameters

Type parameter
`Value`

Parameters

Parameter	Type
`iterable`?	`Iterable`<`Value`>

Returns

object

Member	Type	Description
`[toStringTag]`	`string`	-
`size`	`number`
`[iterator]`	`IterableIterator`<`Value`>	-
`add`	`Set`<`Value`>	-
`clear`	`void`	-
`delete`	`boolean`	-
`entries`	`IterableIterator`<[`Value`, `Value`]>	-
`forEach`	`void`	-
`has`	`boolean`	-
`keys`	`IterableIterator`<`Value`>	-
`values`	`IterableIterator`<`Value`>	-

constructSyntaxError()

1
function constructSyntaxError(
2
	...constructorArguments: [string, ErrorOptions]
3
): object;

Functional alias for new SyntaxError().

Parameters

Parameter	Type
…`constructorArguments`	[`string`, `ErrorOptions`]

Returns

object

Member	Type
`cause`	`unknown`
`message`	`string`
`name`	`string`
`stack`	`string`

constructTextEncoder()

1
function constructTextEncoder(...constructorArguments: []): object;

Functional alias for new TextEncoder().

Parameters

Parameter	Type
…`constructorArguments`	[]

Returns

object

Member	Type	Description
`encoding`	`string`	Returns “utf-8”. MDN Reference
`encode`	`Uint8Array`	-
`encodeInto`	`TextEncoderEncodeIntoResult`	-

constructTypeError()

1
function constructTypeError(
2
	...constructorArguments: [string, ErrorOptions]
3
): object;

Functional alias for new TypeError().

Parameters

Parameter	Type
…`constructorArguments`	[`string`, `ErrorOptions`]

Returns

object

Member	Type
`cause`	`unknown`
`message`	`string`
`name`	`string`
`stack`	`string`

constructURIError()

1
function constructURIError(
2
	...constructorArguments: [string, ErrorOptions]
3
): object;

Functional alias for new URIError().

Parameters

Parameter	Type
…`constructorArguments`	[`string`, `ErrorOptions`]

Returns

object

Member	Type
`cause`	`unknown`
`message`	`string`
`name`	`string`
`stack`	`string`

constructWeakMap()

1
function constructWeakMap<Key, Value>(
2
	iterable?: Iterable<readonly [Key, Value]>,
3
): object;

Functional alias for new WeakMap().

Type parameters

Type parameter
`Key` extends `object`
`Value`

Parameters

Parameter	Type
`iterable`?	`Iterable`<readonly [`Key`, `Value`]>

Returns

object

Member	Type
`[toStringTag]`	`string`
`delete`	`boolean`
`get`	`undefined` \| `Value`
`has`	`boolean`
`set`	`WeakMap`<`Key`, `Value`>

constructWeakSet()

1
function constructWeakSet<Value>(iterable?: Iterable<Value>): object;

Functional alias for new WeakSet().

Type parameters

Type parameter
`Value` extends `object`

Parameters

Parameter	Type
`iterable`?	`Iterable`<`Value`>

Returns

object

Member	Type
`[toStringTag]`	`string`
`add`	`WeakSet`<`Value`>
`delete`	`boolean`
`has`	`boolean`

Common

toString()

1
function toString<Input>(input: Input): Input extends Strigifiable ?
2
	`${Input<Input>}`
3
: Input extends object ? ReturnType<Input<Input>["toString"]>
4
: string;

Parses given value to string.

Type parameters

Type parameter
`Input` extends `Strigifiable` \| `object`

Parameters

Parameter	Type
`input`	`Input`

Returns

Input extends Strigifiable ? `${Input<Input>}` : Input extends object ? ReturnType<Input<Input>["toString"]> : string

stringified value.

Example

1
toString(10); // "10"
2
toString({}); // "[object Object]"
3
toString({ toString: _ => "test" }); // "test"

Conditions

when()

1
function when<Value, Predicated>(
2
	predicate: Single<Predicated> extends Single<never> ? Filter<Value>
3
	:	Predicate<Value, Predicated>,
4
): <TrueOutput>(
5
	truthyHandler: Unary<Predicated & Value, TrueOutput>,
6
) => <FalseInput, FalseOutput>(
7
	falsyHandler: Unary<FalseInput, FalseOutput>,
8
) => (value: Value) => TrueOutput | FalseOutput;

Curried conditional (like a functional ternary).

Type parameters

Type parameter	Value
`Value`	-
`Predicated`	`never`

Parameters

Parameter	Type	Description
`predicate`	`Single`<`Predicated`> extends `Single`<`never`> ? `Filter`<`Value`> : `Predicate`<`Value`, `Predicated`>	Predicate to check value against.

Returns

Function

Curried function with predicate in context.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Predicated` & `Value`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Value` extends `Predicated` ? `Value`<`Value`> : `Predicated`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`Value`

Returns

TrueOutput | FalseOutput

Example

1
const isEven = (value: number) => value % 2 === 0;
2
const whenIsEven = when(isEven);
3
const double = (value: number) => value * 2;
4
const doubleWhenEven = whenIsEven(double);
5
const triple = (value: number) => value * 3;
6
const tripleWhenOdd = whenIsEven(triple);
7

8
tripleWhenOdd(2); // 4
9
tripleWhenOdd(3); // 9

whenFalsy()

1
function whenFalsy<Value, Predicated>(
2
	predicate: Single<Predicated> extends Single<never> ? Filter<Value>
3
	:	Predicate<Value, Predicated>,
4
): <FalseInput, FalseOutput>(
5
	falsyHandler: Unary<FalseInput, FalseOutput>,
6
) => (value: Value) => (Predicated & Value) | FalseOutput;

Like when, but when is falsy the value is returned as is.

Type parameters

Type parameter	Value
`Value`	-
`Predicated`	`never`

Parameters

Parameter	Type	Description
`predicate`	`Single`<`Predicated`> extends `Single`<`never`> ? `Filter`<`Value`> : `Predicate`<`Value`, `Predicated`>	Predicate to check value against.

Returns

Function

Curried function with predicate in context.

Type parameters

Type parameter	Value
`FalseInput`	`Value` extends `Predicated` ? `Value`<`Value`> : `Predicated`
`FalseOutput`	`Predicated` & `Value`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`Value`

Returns

Predicated & Value | FalseOutput

Example

1
const isEven = (value: number) => value % 2 === 0;
2
const whenIsOdd = whenFalsy(isEven);
3
const double = (value: number) => value * 2;
4
const doubleWhenOdd = whenIsOdd(double);
5

6
doubleWhenOdd(2); // 2
7
doubleWhenOdd(3); // 6

whenIsArray()

1
function whenIsArray<TrueOutput>(
2
	truthyHandler: Unary<ReadOnlyArray<unknown>, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is an Array.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`ReadOnlyArray`<`unknown`>, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`ReadOnlyArray`<`unknown`>
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsAsyncIterable()

1
function whenIsAsyncIterable<TrueOutput>(
2
	truthyHandler: Unary<Readonly<AsyncIterable<unknown>>, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is an AsyncIterable.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Readonly`<`AsyncIterable`<`unknown`>>, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Readonly`<`AsyncIterable`<`unknown`>>
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsBigInt()

1
function whenIsBigInt<TrueOutput>(
2
	truthyHandler: Unary<bigint, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a BigInt.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`bigint`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`bigint`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsBoolean()

1
function whenIsBoolean<TrueOutput>(
2
	truthyHandler: Unary<boolean, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Boolean.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`boolean`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`boolean`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsDate()

1
function whenIsDate<TrueOutput>(
2
	truthyHandler: Unary<Date, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Date.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Date`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Date`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsFalsy()

1
function whenIsFalsy<TrueOutput>(
2
	truthyHandler: Unary<Falsy, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Falsy value.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Falsy`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Falsy`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsFunction()

1
function whenIsFunction<TrueOutput>(
2
	truthyHandler: Unary<Function, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Function.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Function`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Function`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsIsomorphicIterable()

1
function whenIsIsomorphicIterable<TrueOutput>(
2
	truthyHandler: Unary<IsomorphicIterable<unknown>, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is an AsynchronousIterable.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`IsomorphicIterable`<`unknown`>, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`IsomorphicIterable`<`unknown`>
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsIterable()

1
function whenIsIterable<TrueOutput>(
2
	truthyHandler: Unary<Readonly<Iterable<unknown>>, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is an Iterable.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Readonly`<`Iterable`<`unknown`>>, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Readonly`<`Iterable`<`unknown`>>
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsNull()

1
function whenIsNull<TrueOutput>(
2
	truthyHandler: Unary<null, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is null.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`null`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`null`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsNullish()

1
function whenIsNullish<TrueOutput>(
2
	truthyHandler: Unary<Nullish, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Nullish value.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Nullish`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Nullish`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsNumber()

1
function whenIsNumber<TrueOutput>(
2
	truthyHandler: Unary<number, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Number.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`number`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`number`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsObject()

1
function whenIsObject<TrueOutput>(
2
	truthyHandler: Unary<object, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is an Object.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`object`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`object`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsPromise()

1
function whenIsPromise<TrueOutput>(
2
	truthyHandler: Unary<Promise<unknown>, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Promise.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Promise`<`unknown`>, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Promise`<`unknown`>
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsPropertyKey()

1
function whenIsPropertyKey<TrueOutput>(
2
	truthyHandler: Unary<PropertyKey, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a PropertyKey.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`PropertyKey`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`PropertyKey`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsPrototypeOfObject()

1
function whenIsPrototypeOfObject<TrueOutput>(
2
	truthyHandler: Unary<never, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: object) => TrueOutput | FalseOutput;

Conditional handler for when something has an Object prototype.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`never`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`never`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`object`

Returns

TrueOutput | FalseOutput

whenIsRegExp()

1
function whenIsRegExp<TrueOutput>(
2
	truthyHandler: Unary<RegExp, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a RegExp.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`RegExp`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`RegExp`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsSafeInteger()

1
function whenIsSafeInteger<TrueOutput>(
2
	truthyHandler: Unary<never, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: number) => TrueOutput | FalseOutput;

Conditional handler for when a number is a SafeInteger.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`never`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`never`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`number`

Returns

TrueOutput | FalseOutput

whenIsString()

1
function whenIsString<TrueOutput>(
2
	truthyHandler: Unary<string, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a String.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`string`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`string`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsSymbol()

1
function whenIsSymbol<TrueOutput>(
2
	truthyHandler: Unary<symbol, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Symbol.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`symbol`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`symbol`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsTruthy()

1
function whenIsTruthy<TrueOutput>(
2
	truthyHandler: Unary<Readonly<unknown>, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is a Truthy value.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Readonly`<`unknown`>, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`Readonly`<`unknown`>
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenIsUndefined()

1
function whenIsUndefined<TrueOutput>(
2
	truthyHandler: Unary<undefined, TrueOutput>,
3
): <FalseInput, FalseOutput>(
4
	falsyHandler: Unary<FalseInput, FalseOutput>,
5
) => (value: unknown) => TrueOutput | FalseOutput;

Conditional handler for when something is undefined.

Type parameters

Type parameter
`TrueOutput`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`undefined`, `TrueOutput`>

Returns

Function

Type parameters

Type parameter	Value
`FalseInput`	`undefined`
`FalseOutput`	`TrueOutput`

Parameters

Parameter	Type
`falsyHandler`	`Unary`<`FalseInput`, `FalseOutput`>

Returns

Function

Parameters

Parameter	Type
`value`	`unknown`

Returns

TrueOutput | FalseOutput

whenTruthy()

1
function whenTruthy<Value, Predicated>(
2
	predicate: Single<Predicated> extends Single<never> ? Filter<Value>
3
	:	Predicate<Value, Predicated>,
4
): <Output>(
5
	truthyHandler: Unary<Predicated & Value, Output>,
6
) => (value: Value) => Value | Output;

Like when, but when is falsy the value is returned as is.

Type parameters

Type parameter	Value
`Value`	-
`Predicated`	`never`

Parameters

Parameter	Type	Description
`predicate`	`Single`<`Predicated`> extends `Single`<`never`> ? `Filter`<`Value`> : `Predicate`<`Value`, `Predicated`>	Predicate to check value against.

Returns

Function

Curried function with predicate in context.

Type parameters

Type parameter
`Output`

Parameters

Parameter	Type
`truthyHandler`	`Unary`<`Predicated` & `Value`, `Output`>

Returns

Function

Parameters

Parameter	Type
`value`	`Value`

Returns

Value | Output

Example

1
const isEven = (value: number) => value % 2 === 0;
2
const whenIsEven = whenTruthy(isEven);
3
const double = (value: number) => value * 2;
4
const doubleWhenEven = whenIsEven(double);
5

6
doubleWhenEven(2); // 4
7
doubleWhenEven(3); // 3

Functions

always()

1
function always<Input>(input: Input): () => Input;

Returns a function that always returns the same value.

Type parameters

Type parameter
`Input`

Parameters

Parameter	Type
`input`	`Input`

Returns

Function

Function that always return the given value.

Returns

Input

Example

1
const alwaysFoo = always("foo");
2
const fillWithFoo = map(alwaysFoo);
3

4
fillWithFoo([0, 1, 2]); // ["foo", "foo", "foo"]

applyTo()

1
function applyTo<Input>(
2
	input: Input,
3
): <Output>(unary: Unary<Input, Output>) => Output;

Takes a value and applies a function to it.

Type parameters

Type parameter
`Input`

Parameters

Parameter	Type
`input`	`Input`

Returns

Function

Function that expects a function that will receive the input.

Type parameters

Type parameter
`Output`

Parameters

Parameter	Type
`unary`	`Unary`<`Input`, `Output`>

Returns

Output

Example

1
const applyTo10 = applyTo(10);
2

3
applyTo10((value: number) => value * 2); // 20
4
applyTo10((value: number) => value / 2); // 5

entryKey()

1
function entryKey<InputEntry>(entry: InputEntry): EntryKey<InputEntry>;

Get key of an Entry.

Type parameters

Type parameter
`InputEntry` extends `Entry`

Parameters

Parameter	Type	Description
`entry`	`InputEntry`	Entry to get key from.

Returns

EntryKey<InputEntry>

Key of an Entry.

Example

1
entryKey(["key", "value"]); // "key"

entryValue()

1
function entryValue<InputEntry>(entry: InputEntry): EntryValue<InputEntry>;

Get value of an Entry.

Type parameters

Type parameter
`InputEntry` extends `Entry`

Parameters

Parameter	Type	Description
`entry`	`InputEntry`	Entry to get vale from.

Returns

EntryValue<InputEntry>

Value of an Entry.

Example

1
entryKey(["key", "value"]); // "value"

flip()

1
function flip<UnaryToFlip>(
2
	unary: UnaryToFlip,
3
): (
4
	...secondArgument: Parameters<UnaryOutput<UnaryToFlip>>
5
) => (
6
	...firstArgument: Parameters<UnaryToFlip>
7
) => UnaryOutput<UnaryOutput<UnaryToFlip>>;

Flips arguments of a curried function.

Type parameters

Type parameter
`UnaryToFlip` extends `Unary`<`never`, `Unary`<`never`, `unknown`>>

Parameters

Parameter	Type
`unary`	`UnaryToFlip`

Returns

Function

Curried function with unary in context.

Parameters

Parameter	Type
…`secondArgument`	`Parameters`<`UnaryOutput`<`UnaryToFlip`>>

Returns

Function

Parameters

Parameter	Type
…`firstArgument`	`Parameters`<`UnaryToFlip`>

Returns

UnaryOutput<UnaryOutput<UnaryToFlip>>

Example

1
const concat = (first: string) => (second: string) => `${first}${second}`;
2
const flippedConcat = flip(concat);
3

4
flippedConcat("1")("2"); // "21"

identity()

1
function identity<Input>(input: Input): Input;

Identity function.

Type parameters

Type parameter
`Input`

Parameters

Parameter	Type
`input`	`Input`

Returns

Input

Same value given.

Example

1
identity("foo"); // "foo"

memoize()

1
function memoize<MemoizedFunction>(unary: MemoizedFunction): MemoizedFunction;

Memoize function return values for expensive operations.

Type parameters

Type parameter
`MemoizedFunction` extends `Unary`<`never`, `unknown`>

Parameters

Parameter	Type	Description
`unary`	`MemoizedFunction`	Function to memoize.

Returns

MemoizedFunction

Curried function with unary in context.

Example

1
const expensiveOperation = (value: number) => value * 2;
2
const memoizedOperation = memoize(expensiveOperation);
3

4
memoizedOperation(2); // 4
5
memoizedOperation(2); // 4 (cached)

negate()

1
function negate<Item, Predicated>(
2
	predicate: Single<Predicated> extends Single<never> ? Filter<Item>
3
	:	Predicate<Item, Predicated>,
4
): Single<Predicated> extends Single<never> ? Unary<Item, boolean>
5
:	Predicate<Item, Exclude<Item, Predicated>>;

Takes a function and returns a copy with negated output.

Type parameters

Type parameter	Value
`Item`	-
`Predicated`	`never`

Parameters

Parameter	Type	Description
`predicate`	`Single`<`Predicated`> extends `Single`<`never`> ? `Filter`<`Item`> : `Predicate`<`Item`, `Predicated`>	Function to be negated.

Returns

Single<Predicated> extends Single<never> ? Unary<Item, boolean> : Predicate<Item, Exclude<Item, Predicated>>

Source function with negated output.

Example

1
const isPositive = (value: number) => value >= 0;
2
const isNegative = not(isPositive);
3

4
isPositive(1); // true
5
isNegative(1); // false

once()

1
function once<OnceFunction>(
2
	unary: OnceFunction,
3
): (
4
	value: UnaryInput<OnceFunction>,
5
) => UnaryOutput<OnceFunction> | UnaryOutput<OnceFunction>;

Runs a function once, and after that returns always the same value.

Type parameters

Type parameter
`OnceFunction` extends `Unary`<`never`, `unknown`>

Parameters

Parameter	Type	Description
`unary`	`OnceFunction`	Function to run once.

Returns

Function

Curried function with unary in context.

Parameters

Parameter	Type
`value`	`UnaryInput`<`OnceFunction`>

Returns

UnaryOutput<OnceFunction> | UnaryOutput<OnceFunction>

Example

1
const expensiveOperation = (value: number) => value * 2;
2
const onceOperation = once(expensiveOperation);
3

4
onceOperation(2); // 4
5
onceOperation(3); // 4 (cached)

tap()

1
function tap<Input>(
2
	tapper: Unary<Input, unknown>,
3
): <Tapped>(tapped: Tapped) => Tapped;

Tap into a value before calling a function.

Type parameters

Type parameter
`Input`

Parameters

Parameter	Type	Description
`tapper`	`Unary`<`Input`, `unknown`>	Tapper function to be called with the value.

Returns

Function

Curried function with tapper in context.

Type parameters

Type parameter
`Tapped` extends `Unary`<`Input`, `unknown`>

Parameters

Parameter	Type
`tapped`	`Tapped`

Returns

Tapped

Example

1
const log = tap(console.log);
2
const double = (value: number) => value * 2;
3
const doubleAndLog = log(double);
4

5
doubleAndLog(2); // 4 (returns and logs 4)

thunk()

1
function thunk<Input, Output>(
2
	unary: Unary<Input, Output>,
3
): (input: Input) => () => Output;

Delayed evaluation function.

Type parameters

Type parameter
`Input`
`Output`

Parameters

Parameter	Type
`unary`	`Unary`<`Input`, `Output`>

Returns

Function

Function that will run the given function when called.

Parameters

Parameter	Type
`input`	`Input`

Returns

Function

Returns

Output

Example

1
const always = thunk(id);
2
const alwaysFoo = always("foo");
3
alwaysFoo(); // "foo"

Numbers

cryptoNumber()

1
function cryptoNumber(seed: string | Numeric): Promise<number>;

Generates number using SubtleCrypto#digest and the given seed.

⚠️ IMPORTANT: This only works in secure contexts (HTTPS/Node).

Parameters

Parameter	Type	Description
`seed`	`string` \| `Numeric`	Seed to be used to generate random numbers.

Returns

Promise<number>

Pseudo-random number from seed.

Example

1
const seededRandom1 = await random("some seed");
2
const seededRandom2 = await random("some seed");
3

4
seededRandom1 === seededRandom2; // true because it has the same seed

See

SubtleCrypto#digest
constructDataView
constructTextEncoder

Objects

awaitableHandler()

1
function awaitableHandler<Value, Output>(
2
	handler: (awaitable: Value) => Output,
3
): <AwaitableValue>(
4
	awaitable: AwaitableValue,
5
) => AwaitableValue extends Promise<Value> ? Promise<Output> : Output;

If the given value is a promise, the handler is called when is resolved, otherwise the handler is called directly with the value.

Type parameters

Type parameter
`Value`
`Output`

Parameters

Parameter	Type	Description
`handler`	(`awaitable`: `Value`) => `Output`	Handler function to be called with the value.

Returns

Function

Curried function with handler in context.

Type parameters

Type parameter
`AwaitableValue`

Parameters

Parameter	Type
`awaitable`	`AwaitableValue`

Returns

AwaitableValue extends Promise<Value> ? Promise<Output> : Output

Example

1
const double = maybePromiseHandler((value: number) => value * 2);
2

3
double(2); // 4
4
double(Promise.resolve(2)); // Promise<4>

get()

1
function get<Key>(
2
	key: Key,
3
): <Source>(object: Source) => Source[Key & keyof Source];

Get the value of a property in an object.

Type parameters

Type parameter
`Key` extends `PropertyKey`

Parameters

Parameter	Type
`key`	`Key`

Returns

Function

Curried function with key in context.

Type parameters

Type parameter
`Source` extends `Readonly`<`Record`<`Key`, `unknown`>>

Parameters

Parameter	Type
`object`	`Source`

Returns

Source[Key & keyof Source]

Example

1
const getFoo = get("foo");
2

3
getFoo({ foo: "bar" }); // "bar"
4
getFoo({}); // undefined

intercept()

1
function intercept<Interceptions>(
2
	interceptions: Interceptions,
3
): <Target>(
4
	target: Target,
5
) => keyof Target extends keyof Interceptions ?
6
	Omit<Target, keyof Interceptions>
7
:	Target & {
8
		readonly [Property in string | number | symbol]: ReturnType<
9
			Interceptions[Property]
10
		>;
11
	};

Function that takes a dictionary property -> getter and uses said getter in the matching property of the object by returning a proxy to it.

Type parameters

Type parameter
`Interceptions` extends `Readonly`<`Record`<`PropertyKey`, <`ProxiedObject`>(`target`: `ProxiedObject`) => `unknown`>>

Parameters

Parameter	Type	Description
`interceptions`	`Interceptions`	Dictionary `property -> handler`.

Returns

Function

Curried function with interceptions in context.

Type parameters

Type parameter
`Target` extends `object`

Parameters

Parameter	Type
`target`	`Target`

Returns

keyof Target extends keyof Interceptions ? Omit<Target, keyof Interceptions> : Target & { readonly [Property in string | number | symbol]: ReturnType<Interceptions[Property]> }

Example

1
const test = { foo: "foo" };
2
const barIntercept = intercept({ foo: () => "bar" });
3

4
const interceptedTest = barIntercept(test);
5
interceptedTest.foo; // "bar"
6
test.foo; // "foo"

mutate()

1
function mutate<Update>(
2
	update: Update,
3
): <Target>(target: Target) => Target & Update;

Function to encapsulate object mutations.

⚠️ IMPORTANT: Try to avoid this util, use intercept instead.

Type parameters

Type parameter
`Update` extends `object`

Parameters

Parameter	Type	Description
`update`	`Update`	Update to apply to given target.

Returns

Function

Curried function with update in context.

Type parameters

Type parameter
`Target` extends `object`

Parameters

Parameter	Type
`target`	`Target`

Returns

Target & Update

Example

1
const state = { a: 1 };
2
mutate(set("a")(2))(state);
3
console.log(state); // { a: 2 }

omit()

1
function omit<Properties>(
2
	...properties: Properties
3
): <Source>(object: Source) => Omit<Source, Properties[number]>;

Omits given properties from an object.

Type parameters

Type parameter
`Properties` extends `ReadOnlyArray`<`PropertyKey`>

Parameters

Parameter	Type	Description
…`properties`	`Properties`	Properties to omit.

Returns

Function

Curried function with properties in context.

Type parameters

Type parameter
`Source` extends `Readonly`<`Record`<`PropertyKey`, `unknown`>>

Parameters

Parameter	Type
`object`	`Source`

Returns

Omit<Source, Properties[number]>

Example

1
const object = { a: 1, b: 2, c: 3 };
2
const omitAC = omit("a", "c");
3
const result = omitAC(object); // { b: 2 }

pick()

1
function pick<Properties>(
2
	...properties: Properties
3
): <Source>(object: Source) => Pick<Source, Properties[number]>;

Picks given properties from an object.

Type parameters

Type parameter
`Properties` extends `ReadOnlyArray`<`PropertyKey`>

Parameters

Parameter	Type	Description
…`properties`	`Properties`	Properties to pick.

Returns

Function

Curried function with properties in context.

Type parameters

Type parameter
`Source` extends `Readonly`<`Record`<`PropertyKey`, `unknown`>>

Parameters

Parameter	Type
`object`	`Source`

Returns

Pick<Source, Properties[number]>

Example

1
const object = { a: 1, b: 2, c: 3 };
2
const pickAC = pick("a", "c");
3
const result = pickAC(object); // { a: 1, c: 3 }

set()

1
function set<Key>(
2
	key: Key,
3
): <Value>(
4
	value: Value,
5
) => <Source>(
6
	object: Source,
7
) => Omit<Source, Key> & Readonly<Record<Key, Value>>;

Set the value of a property in an object (read only).

Type parameters

Type parameter
`Key` extends `PropertyKey`

Parameters

Parameter	Type
`key`	`Key`

Returns

Function

Curried function with key in context.

Type parameters

Type parameter
`Value`

Parameters

Parameter	Type
`value`	`Value`

Returns

Function

Type parameters

Type parameter
`Source` extends `object`

Parameters

Parameter	Type
`object`	`Source`

Returns

Omit<Source, Key> & Readonly<Record<Key, Value>>

Example

1
const setFoo = set("foo");
2

3
setFoo("baz")({ foo: "bar" }); // { foo: "baz" }
4
setFoo("baz")({ bar: "foo" }); // { bar: "foo", foo: "baz" }
5
setFoo("baz")({}); // { foo: "baz" }

Promises

otherwise()

1
function otherwise<Output>(
2
	handler: Unary<unknown, Output | PromiseLike<Output>>,
3
): <PromisedValue>(
4
	promise: Promise<PromisedValue>,
5
) => Promise<Output | PromisedValue>;

Sets a promise catch handler.

Type parameters

Type parameter
`Output`

Parameters

Parameter	Type
`handler`	`Unary`<`unknown`, `Output` \| `PromiseLike`<`Output`>>

Returns

Function

Curried function with handler set in context.

Type parameters

Type parameter
`PromisedValue`

Parameters

Parameter	Type
`promise`	`Promise`<`PromisedValue`>

Returns

Promise<Output | PromisedValue>

Example

1
const otherwiseLog = otherwise(console.error);
2

3
otherwiseLog(fetch("/api")); // Logs on error.

then()

1
function then<HandlerInput, Output>(
2
	handler: Unary<HandlerInput, Output | PromiseLike<Output>>,
3
): <PromiseInstance>(promise: PromiseInstance) => Promise<Output>;

Sets a promise then handler.

Type parameters

Type parameter
`HandlerInput`
`Output`

Parameters

Parameter	Type
`handler`	`Unary`<`HandlerInput`, `Output` \| `PromiseLike`<`Output`>>

Returns

Function

Curried function with handler set in context.

Type parameters

Type parameter
`PromiseInstance` extends `Promise`<`HandlerInput`>

Parameters

Parameter	Type
`promise`	`PromiseInstance`

Returns

Promise<Output>

Example

1
const thenJson = then((response: Response) => response.json());
2

3
thenJson(fetch("/api")); // Parsed response