Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.prototype.at — leer una unidad de código UTF-16 por índice

String.prototype.at(index) devuelve una cadena que contiene una unidad de código UTF-16. Los índices negativos cuentan desde el final; una posición fuera de rango devuelve undefined.

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

Sintaxis

string.at(index)

String.prototype.at(index) lee una unidad de código UTF-16 sin modificar la cadena. Los índices empiezan en 0; -1 indica la última unidad y -2, la penúltima. El resultado es una cadena de longitud 1 o undefined si la posición calculada queda fuera de rango. Para una cadena vacía, el método devuelve undefined si el índice se convierte correctamente. El índice se convierte antes de comprobar los límites, por lo que "".at(0n) lanza un TypeError.

El argumento se convierte en un número entero truncando su parte fraccionaria hacia cero. Un argumento omitido, undefined y NaN representan el índice 0; los infinitos devuelven undefined. Para un índice negativo, la posición es string.length + index después de la conversión.

A diferencia de at(), charAt() no cuenta hacia atrás con índices negativos y devuelve "" fuera de rango. La expresión text[-1] lee una propiedad llamada "-1", no la última unidad de la cadena.

Una unidad de código UTF-16 no tiene por qué ser un carácter Unicode completo ni un carácter percibido por el usuario: "😀".at(0) devuelve solo la primera mitad de un par sustituto. El método pertenece a ECMAScript 2022, no a una API del navegador. La especificación no establece qué versiones de navegador lo admiten; comprueba los entornos de destino antes de implementarlo, por ejemplo con typeof String.prototype.at === "function".

Ejemplos

const text = "JavaScript";
console.log(text.at(0));
console.log(text.at(-1));
console.log(text.at(-2));
console.log(text.at(10));
console.log(text.charAt(10) === "");
console.log("😀".at(0).length);

Resultado

J
t
p
undefined
true
1

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes