assertArray()function

assertArray(arr: MutableArray<T>, min: 1, max: 1, caller?: AnyCaller): asserts arr is [T]
assertArray(arr: MutableArray<T>, min: 2, max: 2, caller?: AnyCaller): asserts arr is [T, T]
assertArray(arr: MutableArray<T>, min: 3, max: 3, caller?: AnyCaller): asserts arr is [T, T, T]
assertArray(arr: MutableArray<T>, min?: 1, max?: number, caller?: AnyCaller): asserts arr is [T, ...T[]]
assertArray(arr: MutableArray<T>, min: 2, max?: number, caller?: AnyCaller): asserts arr is [T, T, ...T[]]
assertArray(arr: MutableArray<T>, min: 3, max?: number, caller?: AnyCaller): asserts arr is [T, T, T, ...T[]]
assertArray(arr: MutableArray<T>, min: number, max?: number, caller?: AnyCaller): asserts arr is MutableArray<T>
assertArray(arr: ImmutableArray<T>, min: 1, max: 1, caller?: AnyCaller): asserts arr is readonly [T]
assertArray(arr: ImmutableArray<T>, min: 2, max: 2, caller?: AnyCaller): asserts arr is readonly [T, T]
assertArray(arr: ImmutableArray<T>, min: 3, max: 3, caller?: AnyCaller): asserts arr is readonly [T, T, T]
assertArray(arr: ImmutableArray<T>, min?: 1, max?: number, caller?: AnyCaller): asserts arr is readonly [T, ...T[]]
assertArray(arr: ImmutableArray<T>, min: 2, max?: number, caller?: AnyCaller): asserts arr is readonly [T, T, ...T[]]
assertArray(arr: ImmutableArray<T>, min: 3, max?: number, caller?: AnyCaller): asserts arr is readonly [T, T, T, ...T[]]
assertArray(arr: ImmutableArray<T>, min?: number, max?: number, caller?: AnyCaller): asserts arr is ImmutableArray<T>
ParamType
arrMutableArray<T>
Mutable array: an array that can be changed. required
min1
Minimum number of items the array must contain (defaults to 0). required
max1
Maximum number of items the array may contain (defaults to Infinity). required
callerAnyCaller
Function to attribute a thrown error to (defaults to assertArray itself).
min2
required
max2
required
callerAnyCaller
Any calling function or constructor, usually referring to something that can call in the current scope that can appear in a stack trace.
min3
required
max3
required
min1
maxnumber
minnumber
required
arrImmutableArray<T>
Immutable array: an array that cannot be changed. required
min1
required
max1
required
minnumber
Return
asserts arr is [T]
asserts arr is [T, T]
asserts arr is [T, T, T]
asserts arr is [T, ...T[]]
asserts arr is [T, T, ...T[]]
asserts arr is [T, T, T, ...T[]]
asserts arr is MutableArray<T>
asserts arr is readonly [T]
asserts arr is readonly [T, T]
asserts arr is readonly [T, T, T]
asserts arr is readonly [T, ...T[]]
asserts arr is readonly [T, T, ...T[]]
asserts arr is readonly [T, T, T, ...T[]]
asserts arr is ImmutableArray<T>
Throws
RequiredError
If value is not an array within the length bounds.

Assert that an unknown value is an array (optionally with specified min/max length).

Examples

assertArray([1, 2, 3]); // (passes)
assertArray("nope"); // throws RequiredError