String.length
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
A propriedade length de um objeto String contém o comprimento da string. length é uma propriedade read-only (somente leitura) de instâncias de string.
Sintaxe
str.length
Descrição
Essa propriedade retorna o número de unidades de código presentes na string. UTF-16, a codificação utilizada pelo JavaScript, utiliza uma unidade de código de 16-bits para representar os caracteres mais comuns, mas precisa usar duas unidades para caracteres menos usados, então é possível que o valor retornado por length não seja exatamente o número de caracteres na string.
ECMASCript 2016 (ed. 7) estabeleceu um comprimento máximo de 2^53 - 1 elementos. Anteriormente, nenhum comprimento máximo havia sido especificado. No Firefox, as strings têm um comprimento (length) máximo de 2**30 - 2 (~ 1 GB). Em versões anteriores ao Firefox 65, o comprimento máximo era 2**28 - 1 (~ 256 MB).
Para uma string vazia, length é 0.
A propriedade estática String.length retorna o valor 1.
Exemplos
Uso básico
var x = "Mozilla";
var empty = "";
console.log(
"Mozilla possui " + x.length + " unidades de código de comprimento",
);
/* "Mozilla possui 7 unidades de código de comprimento" */
console.log("A string vazia possui um comprimento de " + empty.length);
/* "A string vazia possui um comprimento de 0" */
Atribuindo valor ao comprimento
let myString = "campainhas";
// A tentativa de atribuir um valor à propriedade .length
// de uma string não tem efeito observável.
myString.length = 4;
console.log(myString);
// retorna "campainhas"
console.log(myString.length);
// retorna 10
Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-properties-of-string-instances-length |
Navegadores compatíveis
Loading…