apps-script-utils (Русский) 2.1.1 Help

requireNumberLike

function requireNumberLike( value: unknown, message: string = "Expected a numeric value." ): number | string;

Конечное число или строка, которая в него превращается. NaN, бесконечности и пустая строка исключены — этим проверка и отличается от простого Number(value).

isX и nonX отвечают на вопрос и никогда не прерывают выполнение; requireX и requireNonX возвращают значение или выбрасывают исключение. Схема разобрана в Соглашения о проверках.

Параметры

Параметр

Тип

Описание

value

unknown

Значение, которое нужно проверить.

message (необязательный) = "Expected a numeric value."

string

Сообщение исключения. Если не задано, используется сообщение по умолчанию.

Возвращает

number | string — то же значение, уже проверенное как числовое значение.

Исключения

Исключение

Условие

IllegalArgumentException

значение не является преобразуемым в число.

Примеры

Что проходит, а что нет

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

Смотрите также

Исходный код

src/lang/base/requireNumberLike.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.