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) на основі вихідного коду бібліотеки.