Assert
Helper functions that have to do with asserting.
Functions
assertArray()
function assertArray(value, msg): asserts value is unknown[]
Defined in: functions/assert.ts:12
Helper function to throw an error if the provided value is not an array.
Parameters
Parameter | Type |
---|---|
value | unknown |
msg | string |
Returns
asserts value is unknown[]
assertBoolean()
function assertBoolean(value, msg): asserts value is boolean
Defined in: functions/assert.ts:22
Helper function to throw an error if the provided value is not a boolean.
Parameters
Parameter | Type |
---|---|
value | unknown |
msg | string |
Returns
asserts value is boolean
assertDefined()
function assertDefined<T>(value, ...__namedParameters): asserts value is Exclude<T, undefined>
Defined in: functions/assert.ts:36
Helper function to throw an error if the provided value is equal to undefined
.
This is useful to have TypeScript narrow a T | undefined
value to T
in a concise way.
Type Parameters
Type Parameter |
---|
T |
Parameters
Parameter | Type |
---|---|
value | T |
...__namedParameters | [undefined ] extends [T ] ? [string ] : ["The assertion is useless because the provided value does not contain undefined." ] |
Returns
asserts value is Exclude<T, undefined>
assertEnumValue()
function assertEnumValue<T>(
value,
transpiledEnum,
msg,
set?): asserts value is T[keyof T]
Defined in: functions/assert.ts:59
Helper function to throw an error if the provided value is not contained within an enum.
Type Parameters
Type Parameter |
---|
T extends TranspiledEnum |
Parameters
Parameter | Type | Description |
---|---|---|
value | string | number | The value to check. |
transpiledEnum | T | The enum to check against. |
msg | string | The error message to throw if the check fails. |
set ? | ReadonlySet <string | number > | Optional. A set that contains all of the values of an enum. If provided, this function will check for existence using the set (instead of the enum itself). Using a set should be more performant for enums with around 52 or more elements. |
Returns
asserts value is T[keyof T]
assertNotNull()
function assertNotNull<T>(value, ...__namedParameters): asserts value is Exclude<T, null>
Defined in: functions/assert.ts:75
Helper function to throw an error if the provided value is equal to null
.
This is useful to have TypeScript narrow a T | null
value to T
in a concise way.
Type Parameters
Type Parameter |
---|
T |
Parameters
Parameter | Type |
---|---|
value | T |
...__namedParameters | [null ] extends [T ] ? [string ] : ["The assertion is useless because the provided value does not contain null." ] |
Returns
asserts value is Exclude<T, null>
assertNumber()
function assertNumber(value, msg): asserts value is number
Defined in: functions/assert.ts:89
Helper function to throw an error if the provided value is not a number.
Parameters
Parameter | Type |
---|---|
value | unknown |
msg | string |
Returns
asserts value is number
assertObject()
function assertObject(value, msg): asserts value is Record<string, unknown>
Defined in: functions/assert.ts:107
Helper function to throw an error if the provided value is not an object (i.e. a TypeScript record).
This is useful to have TypeScript narrow a Record<string, unknown> | undefined
value to
Record<string, unknown>
in a concise way.
Under the hood, this function uses the isObject
helper function.
Parameters
Parameter | Type |
---|---|
value | unknown |
msg | string |
Returns
asserts value is Record<string, unknown>
assertString()
function assertString(value, msg): asserts value is string
Defined in: functions/assert.ts:117
Helper function to throw an error if the provided value is not a string.
Parameters
Parameter | Type |
---|---|
value | unknown |
msg | string |
Returns
asserts value is string