String.length

La propiedad length de un objeto String representa la longitud de una cadena, en unidades de código UTF-16.

Sintaxis

str.length

Descripción

Esta propiedad devuelve el número de caracteres de una cadena. UTF-16, el formato usado por JavaScript, usa 16-bit para representar los caracteres más comunes, pero necesita usar dos caracteres para otros menos usados, así que es posible que el valor devuelto por length no corresponda al número de caracteres de la cadena.

ECMASCript 2016 (ed. 7) estableció una longitud máxima de 2^53 - 1 elementos. Anteriormente, ninguna longitud máxima era especificada. 

Para una cadena vacía, length es 0.

La propiedad static String.length devuelve 1.

Ejemplos

Uso Básico

var x = 'Mozilla';
var empty = '';

console.log('Mozilla is ' + x.length + ' code units long');
/* "Mozilla is 7 code units long" */

console.log('The empty string has a length of ' + empty.length);
/* "The empty string has a length of 0" */

Asignando a length

var myString = "bluebells";

// Attempting to assign a value to a string's .length property has no observable effect.
myString.length = 4;
console.log(myString);
/* "bluebells" */

Especificaciones

Especificación Estatus Comentario
ECMAScript 1st Edition. Estándar Primera definicíon. Implementado en JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
La definición de 'String.prototype.length' en esta especificación.
Standard
ECMAScript 2015 (6th Edition, ECMA-262)
La definición de 'String.prototype.length' en esta especificación.
Standard
ECMAScript (ECMA-262)
La definición de 'String.prototype.length' en esta especificación.
Living Standard

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también