Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.length — délka řetězce v jednotkách UTF-16

Vlastnost length řetězce vrací počet jeho kódových jednotek UTF-16, což nemusí být vždy počet znaků vnímaných uživatelem. Čte se jako text.length, bez závorek.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

text.length

Tento záznam String.length popisuje vlastnost délky řetězcové hodnoty: použijte text.length, nikoli text.length(). Výsledkem je nezáporné celé číslo, které počítá kódové jednotky UTF-16. Prázdný řetězec má délku 0. Jde o součást ECMAScriptu, nikoli o Web API.

Nezaměňujte tuto hodnotu za počet kódových bodů Unicode, znaků vnímaných uživatelem ani bajtů. Emoji reprezentované párem náhradních znaků zabírá dvě jednotky. Také písmeno následované kombinující značkou může vypadat jako jeden znak, přestože jeho délka je 2.

Délka konkrétního řetězce je neměnná; přiřazení hodnoty do length text nezkrátí. U obalového objektu String je tato vlastní vlastnost nezapisovatelná, nevyčitatelná (enumerable: false) a nekonfigurovatelná.

Pozor na zápis: doslovný výraz String.length čte délku seznamu parametrů konstruktoru String, nikoli délku řetězce. Chcete-li změřit text, vždy umístěte řetězcovou hodnotu před .length.

Příklady

const samples = ["", "abc", "\uD83D\uDE00", "e\u0301"];
for (const text of samples) {
  console.log(text.length);
}

Výsledek

0
3
2
2

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje