apps-script-utils 2.1.1 Help

getByteSize

function getByteSize(value: string): number;

Read the caveat before using this. The name and the original intent are the UTF-8 byte length, but as it stands the function counts UTF-16 code units and only widens the first surrogate it meets. An ASCII string measures correctly; anything outside ASCII — Cyrillic, Greek, CJK, an emoji — measures short. Until that is fixed, measure a payload with Utilities.newBlob(text).getBytes().length instead.

Parameters

Parameter

Type

Description

value

string

The string to measure.

Returns

number — the length, in code units.

Throws

Exception

Condition

InvalidStringException

the value is not a string.

Examples

In use

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

See also

Source

src/appsscript/base/getByteSize.ts

23 September 2026
FormulaTransformergetColumnIndexByLetter

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