getByteSize

function getByteSize(value: string): number;

Прочитайте оговорку, прежде чем этим пользоваться. По имени и по замыслу это длина в байтах UTF-8, но в нынешнем виде функция считает кодовые единицы UTF-16 и расширяет только первую встреченную суррогатную пару. Для строки из ASCII результат верен; для всего остального — кириллицы, греческого, CJK, эмодзи — занижен. Пока это не исправлено, измеряйте объём через Utilities.newBlob(text).getBytes().length.

Параметры

Параметр	Тип	Описание
`value`	`string`	Измеряемая строка.

Возвращает

number — длина в кодовых единицах.

Исключения

Исключение	Условие
`InvalidStringException`	значение не является строкой.

Примеры

Применение

getByteSize("abc"); // => 3

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

Исходный код

src/appsscript/base/getByteSize.ts

23 September 2026

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