apps-script-utils 2.1.1 Help

requireNonNumberLike

function requireNonNumberLike<T>(value: T, message: string = "Expected a non-numeric value."): T;

A finite number, or a string that converts to one. NaN, the infinities and the empty string are excluded, which is what separates this from a bare Number(value).

isX and nonX answer a question and never interrupt control flow; requireX and requireNonX hand the value back or throw. The scheme is explained in Validation conventions.

Parameters

Parameter

Type

Description

value

T

The value to validate.

message (optional) = "Expected a non-numeric value."

string

The message of the exception. A default is used when omitted.

Returns

T — the same value, with convertible to a number excluded from its type.

Throws

Exception

Condition

IllegalArgumentException

the value is convertible to a number.

Examples

What passes and what does not

requireNonNumberLike(NaN); // => NaN requireNonNumberLike(Infinity); // => Infinity requireNonNumberLike(1); // throws IllegalArgumentException requireNonNumberLike("1.5"); // throws IllegalArgumentException

See also

Source

src/lang/base/requireNonNumberLike.ts

23 September 2026
requireNonNumberrequireNonObject

This documentation was generated with AI (Claude) from the library's source code.