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

Базовые утилиты

Функции, не привязанные к какому-либо фреймворку: проверка типов и значений (isX/nonX/requireX), работа со строками, массивами и объектами, JSON и HTML. Среда выполнения Google Apps Script им не нужна.

Пометка New означает функцию, добавленную в последнем выпуске; пометка Deprecated — функцию, которую планируется удалить в одном из будущих выпусков.

Функция

Возвращает

Краткое описание

chunk

Array

Делит массив на последовательные группы фиксированного размера, проверяя оба аргумента.

compact New

Array

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

decodeHtml

String

Превращает числовые ссылки на символы обратно в символы.

diff New

Number

Возвращает интервал между двумя датами в выбранных единицах.

encodeHtml

String

Кодирует каждый символ числовой ссылкой.

equals New

Boolean

Сравнивает два значения вглубь и безопасно относительно null.

escapeHtml

String

Заменяет пять символов, которые иначе были бы прочитаны как разметка.

escapeRegExp

String

Экранирует символы, которые имеют особое значение в регулярном выражении.

escapeXml

String

Экранирует символы, зарезервированные в XML.

first New

Any

Берёт первый элемент массива или его первые n элементов, без отдельной проверки на пустоту.

flat New

Object

Разворачивает вложенный объект в один уровень с ключами через точку.

getDaysInMonth New

Number

Возвращает количество дней в месяце указанной даты.

getDaysLeftInMonth New

Number

Возвращает, сколько дней остаётся от даты до конца её месяца.

getPath New

Any

Читает вложенное свойство по пути, с запасным значением.

hashCode

Number

Вычисляет числовой хеш для любого значения.

intersect New

Array

Находит значения, присутствующие во всех переданных массивах.

is2DArray

Boolean

Проверяет, что значение — непустой массив, каждый элемент которого сам является массивом.

isArray

Boolean

Проверяет, является ли значение массивом.

isBoolean

Boolean

Проверяет, является ли значение логическим значением.

isConsistent2DArray

Boolean

Проверяет, что значение — непустая матрица, все строки которой одной длины.

isCountable

Boolean

Проверяет, является ли значение счётным числом.

isDouble New

Boolean

Проверяет, является ли значение числом с дробной частью.

isEmail

Boolean

Проверяет, является ли значение адресом электронной почты.

isEmpty

Boolean

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

isException

Boolean

Проверяет, является ли значение экземпляром Exception.

isFloat New

Boolean

Проверяет, является ли значение числом с дробной частью.

isFunction

Boolean

Проверяет, является ли значение функцией.

isFunctionLike

Boolean

Проверяет, является ли значение вызываемым значением.

isInteger

Boolean

Проверяет, является ли значение целым числом.

isLength

Boolean

Проверяет, является ли значение допустимой длиной массива.

isNaN New

Boolean

Проверяет, является ли значение числом NaN.

isNil

Boolean

Проверяет, является ли значение значением null или undefined.

isNonNegative New

Boolean

Проверяет, является ли значение неотрицательным числом.

isNull

Boolean

Проверяет, является ли значение значением null.

isNumber

Boolean

Проверяет, является ли значение числом.

isNumberLike

Boolean

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

isObject

Boolean

Проверяет, является ли значение объектом.

isObjectLike

Boolean

Проверяет, является ли значение объектоподобным значением.

isRegExp

Boolean

Проверяет, является ли значение регулярным выражением.

isSafeInteger New

Boolean

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

isScalar

Boolean

Проверяет, является ли значение скалярным значением.

isString

Boolean

Проверяет, является ли значение строкой.

isSymbol

Boolean

Проверяет, является ли значение символом.

last New

Any

Берёт последний элемент массива или его последние n элементов в исходном порядке.

merge New

String

Подставляет значения объекта в плейсхолдеры {{ key }} шаблона.

nonDouble New

Boolean

Проверяет, что значение не является числом с дробной частью.

nonEmptyString Deprecated

String

Возвращает значение как непустую строку, называя аргумент в сообщении об ошибке.

isUndefined

Boolean

Проверяет, является ли значение значением undefined.

isUrl

Boolean

Проверяет, является ли значение URL-адресом.

isValidLocale

Boolean

Проверяет, является ли значение кодом локали.

isValidSlug

Boolean

Проверяет, является ли значение слагом.

isValidVersion

Boolean

Проверяет, является ли значение строкой версии.

isVersionCompatible

Boolean

Проверяет, что версия не ниже требуемой.

non2DArray New

Boolean

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

nonArray

Boolean

Проверяет, что значение не является массивом.

nonBoolean

Boolean

Проверяет, что значение не является логическим значением.

nonConsistent2DArray New

Boolean

Проверяет, что значение не является двумерным массивом с одинаковой длиной строк.

nonEmpty

Boolean

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

nonException New

Boolean

Проверяет, что значение не является экземпляром Exception.

nonFloat New

Boolean

Проверяет, что значение не является числом с дробной частью.

nonFunction New

Boolean

Проверяет, что значение не является функцией.

nonCountable New

Boolean

Проверяет, что значение не является счётным числом.

nonFunctionLike New

Boolean

Проверяет, что значение не является вызываемым значением.

nonInteger New

Boolean

Проверяет, что значение не является целым числом.

nonLength New

Boolean

Проверяет, что значение не является допустимой длиной массива.

nonNaN New

Boolean

Проверяет, что значение не является числом NaN.

nonNil

Boolean

Проверяет, что значение не является значением null или undefined.

nonNull

Boolean

Проверяет, что значение не является значением null.

nonNegative Deprecated

Boolean

Проверяет, что значение — неотрицательное число.

nonNumber

Boolean

Проверяет, что значение не является числом.

nonNumberLike New

Boolean

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

nonObject New

Boolean

Проверяет, что значение не является объектом.

nonObjectLike New

Boolean

Проверяет, что значение не является объектоподобным значением.

nonRegExp New

Boolean

Проверяет, что значение не является регулярным выражением.

nonSafeInteger New

Boolean

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

nonScalar

Boolean

Проверяет, что значение не является скалярным значением.

nonString

Boolean

Проверяет, что значение не является строкой.

nonSymbol

Boolean

Проверяет, что значение не является символом.

nonUndefined

Boolean

Проверяет, что значение не является значением undefined.

nonUrl New

Boolean

Проверяет, что значение не является URL-адресом.

nonValidEmail New

Boolean

Проверяет, что значение не является адресом электронной почты.

nonValidLocale New

Boolean

Проверяет, что значение не является кодом локали.

nonValidSlug New

Boolean

Проверяет, что значение не является слагом.

nonValidVersion New

Boolean

Проверяет, что значение не является строкой версии.

nonVersionCompatible New

Boolean

Проверяет, что версия ниже требуемой.

now

Number

Возвращает текущее время в миллисекундах с начала эпохи.

ObjectTag

Enum

Внутренние теги, которые может сообщить значение, в виде именованных констант.

objectToString

String

Возвращает внутренний тег значения.

offset New

Date

Сдвигает дату на заданное количество единиц.

parseJson Deprecated

Object

Разбирает JSON, а при неудаче строгого разбора пробует нестрогий.

require2DArray New

Array

Возвращает значение как непустой двумерный массив или выбрасывает исключение.

requireArray New

Array

Возвращает значение как массив или выбрасывает исключение.

requireBoolean New

Boolean

Возвращает значение как логическое значение или выбрасывает исключение.

requireConsistent2DArray New

Array

Возвращает значение как двумерный массив с одинаковой длиной строк или выбрасывает исключение.

requireCountable New

Number

Возвращает значение как счётное число или выбрасывает исключение.

requireDouble New

Number

Возвращает значение как число с дробной частью или выбрасывает исключение.

requireEmpty New

Any

Возвращает значение как пустое значение или выбрасывает исключение.

requireException New

Exception

Возвращает значение как Exception или выбрасывает исключение.

requireFloat New

Number

Возвращает значение как число с дробной частью или выбрасывает исключение.

requireFunction New

Function

Возвращает значение как функцию или выбрасывает исключение.

requireFunctionLike New

Function

Возвращает значение как вызываемое значение или выбрасывает исключение.

requireInteger New

Number

Возвращает значение как целое число или выбрасывает исключение.

requireLength New

Number

Возвращает значение как допустимую длину массива или выбрасывает исключение.

requireNaN New

Number

Возвращает значение как NaN или выбрасывает исключение.

requireNil New

Null | Undefined

Возвращает значение как null или undefined или выбрасывает исключение.

requireNonArray New

Any

Возвращает значение, убедившись, что оно не является массивом.

requireNonBoolean New

Any

Возвращает значение, убедившись, что оно не является логическим значением.

requireNonDouble New

Any

Возвращает значение, убедившись, что оно не является числом с дробной частью.

requireNonEmpty New

Any

Возвращает значение, убедившись, что оно не является пустым значением.

requireNonFloat New

Any

Возвращает значение, убедившись, что оно не является числом с дробной частью.

requireNonInteger New

Any

Возвращает значение, убедившись, что оно не является целым числом.

requireNonNaN New

Any

Возвращает значение, убедившись, что оно не является числом NaN.

requireNonSafeInteger New

Any

Возвращает значение, убедившись, что оно не является безопасным целым числом.

requireSafeInteger New

Number

Возвращает значение как безопасное целое число или выбрасывает исключение.

requireSymbol New

Symbol

Возвращает значение как символ или выбрасывает исключение.

requireNonEmptyString

String

Возвращает значение как непустую строку или бросает исключение.

requireNonException New

Any

Возвращает значение, убедившись, что оно не является экземпляром Exception.

requireNonFunction New

Any

Возвращает значение, убедившись, что оно не является функцией.

requireNonFunctionLike New

Any

Возвращает значение, убедившись, что оно не является вызываемым значением.

requireNoNilElements New

Array

Возвращает коллекцию без изменений, убедившись, что ни один её элемент не равен null или undefined.

requireNonLength New

Any

Возвращает значение, убедившись, что оно не является допустимой длиной массива.

requireNonNil New

Any

Возвращает значение, убедившись, что оно не является значением null или undefined.

requireNonNull

any

Возвращает значение, убедившись, что оно не является значением null или undefined.

requireNonNumber New

Any

Возвращает значение, убедившись, что оно не является числом.

requireNonNumberLike New

Any

Возвращает значение, убедившись, что оно не является преобразуемым в число.

requireNonObject New

Any

Возвращает значение, убедившись, что оно не является объектом.

requireNonObjectLike New

Any

Возвращает значение, убедившись, что оно не является объектоподобным значением.

requireNonRegExp New

Any

Возвращает значение, убедившись, что оно не является регулярным выражением.

requireNonScalar New

Any

Возвращает значение, убедившись, что оно не является скалярным значением.

requireNonString New

Any

Возвращает значение, убедившись, что оно не является строкой.

requireNonSymbol New

Any

Возвращает значение, убедившись, что оно не является символом.

requireNonUndefined New

Any

Возвращает значение, убедившись, что оно не является значением undefined.

requireNull New

Null

Возвращает значение как null или выбрасывает исключение.

requireNumber New

Number

Возвращает значение как число или выбрасывает исключение.

requireNumberLike New

Number | String

Возвращает значение как числовое значение или выбрасывает исключение.

requireObject New

Object

Возвращает значение как объект или выбрасывает исключение.

requireObjectLike New

Object

Возвращает значение как объектоподобное значение или выбрасывает исключение.

requireRegExp New

RegExp

Возвращает значение как регулярное выражение или выбрасывает исключение.

requireScalar New

Scalar

Возвращает значение как скалярное значение или выбрасывает исключение.

requireState New

void

Утверждает, что условие выполняется, и бросает исключение, если нет.

requireString

String

Возвращает значение как строку или выбрасывает исключение.

requireUndefined New

Undefined

Возвращает значение как undefined или выбрасывает исключение.

requireUrl New

String

Возвращает значение как URL-адрес или выбрасывает исключение.

requireValidEmail

String

Возвращает значение как адрес электронной почты или выбрасывает исключение.

requireValidLocale New

String

Возвращает значение как код локали или выбрасывает исключение.

requireValidSlug New

String

Возвращает значение как слаг или выбрасывает исключение.

requireValidVersion New

String

Возвращает значение как строку версии или выбрасывает исключение.

requireVersionCompatible New

String

Возвращает версию, убедившись, что она удовлетворяет требованию, иначе бросает исключение.

retry New

T

Повторяет вызов функции при исключении, увеличивая паузу между попытками.

setPath New

Object

Записывает вложенное свойство по пути, создавая недостающее.

StopWatch New

StopWatch

Измеряет время последовательности именованных задач.

stringifyJson

String

Сериализует значение в JSON с фиксированным порядком ключей.

toCamelCase

String

Склеивает слова строки в camelCase.

toInteger

Number \| null

Извлекает число из значения или сообщает, что числа нет.

toKebabCase

String

Переписывает строку в kebab-case.

toLowerCase

String

Приводит строку к нижнему регистру, при желании прибирая пробелы.

toProperCase

String

Делает первую букву каждого слова заглавной, а остальные строчными.

toSnakeCase

String

Переписывает строку в snake_case.

toUpperCase

String

Приводит строку к верхнему регистру, при желании прибирая пробелы.

transpose

Array

Меняет местами строки и столбцы матрицы.

unique New

Array

Удаляет из массива повторы, сохраняя первое вхождение каждого значения.

versionCompare

Number

Сравнивает две строки версий по числам.

without New

Array

Удаляет из массива все вхождения перечисленных значений.

23 September 2026

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