CKTIS / JavaScript
String.length — comprimento da cadeia em unidades UTF-16
A propriedade length de uma cadeia devolve o número de unidades de código UTF-16, que nem sempre corresponde ao número de caracteres percebidos pelo utilizador. Consulta-a como text.length, sem parênteses.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
text.lengthEsta entrada String.length descreve a propriedade de comprimento de um valor de cadeia: utiliza text.length, não text.length(). O resultado é um número inteiro não negativo que conta unidades de código UTF-16. Uma cadeia vazia tem comprimento 0. Isto faz parte do ECMAScript, não é uma API Web.
Não confundas este valor com o número de pontos de código Unicode, de caracteres percebidos pelo utilizador ou de bytes. Um emoji representado por um par substituto ocupa duas unidades. Uma letra seguida de um sinal combinante também pode parecer um só carácter, apesar de ter comprimento 2.
O comprimento de uma cadeia específica é imutável; atribuir um valor a length não trunca o texto. Num objeto wrapper String, esta propriedade própria não é gravável, enumerável nem configurável.
Atenção à notação: a expressão literal String.length lê o comprimento da lista de parâmetros do construtor String, não o comprimento de uma cadeia. Para medir texto, coloca sempre o valor da cadeia antes de .length.
Exemplos
const samples = ["", "abc", "\uD83D\uDE00", "e\u0301"];
for (const text of samples) {
console.log(text.length);
}Resultado
0 3 2 2
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.