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 propriedadelength de um objetoString contém o comprimento da string.length é uma propriedaderead-only (somente leitura) de instâncias de string.

Sintaxe

str.length

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 porlength não seja exatamente o número de caracteres na string.

ECMASCript 2016 (ed. 7) estabeleceu um comprimento máximo de2^53 - 1 elementos. Anteriormente, nenhum comprimento máximo havia sido especificado. No Firefox, as strings têm um comprimento (length) máximo de2**30 - 2 (~ 1 GB). Em versões anteriores ao Firefox 65, o comprimento máximo era2**28 - 1 (~ 256 MB).

Para uma string vazia,length é0.

A propriedade estáticaString.length retorna o valor1.

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