CKTIS / JavaScript
Acceso a propiedades de objetos mediante claves calculadas
Usa `obj[expr]` para leer una propiedad o asignarle un valor según una expresión, en vez de indicar un nombre fijo tras un punto.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
obj[expr] // read using a computed key
obj[expr] = value // assign using a computed key
obj?.[expr] // optional computed access
obj.name // access the fixed string key "name"
({ [expr]: value }) // define a property in an object literalEn obj[expr], JavaScript evalúa expr para elegir la propiedad que se va a leer o a la que se va a asignar un valor. obj.key siempre designa la clave de texto "key"; obj[key] usa el valor de la variable key. En cambio, { [expr]: value } define una propiedad al crear un objeto, en lugar de leerla de un objeto existente.
ToPropertyKey primero convierte el valor de la clave en un valor primitivo. Si el resultado es un Symbol, lo conserva; si no, lo convierte en una cadena. Por eso obj[1] y obj["1"] se refieren a la misma propiedad. Los corchetes admiten cadenas con espacios, pero obj["#secret"] no accede al campo privado de clase #secret.
En un objeto ordinario, una lectura puede encontrar una propiedad heredada o invocar un getter. Si la propiedad no existe en toda la cadena de prototipos, la lectura devuelve undefined, igual que si la propiedad tiene el valor undefined. Usa Object.hasOwn(obj, key) para comprobar si la propiedad pertenece directamente al objeto. Antes de leer o escribir con una clave no fiable, comprueba que esté en una lista de claves permitidas; Object.hasOwn por sí solo no sustituye esa comprobación.
La lectura normal sobre null o undefined lanza un TypeError si antes no se produce otro error. Con esos valores como base, obj?.[expr] devuelve undefined sin evaluar expr. No captura los errores de un getter ni puede ser el destino de una asignación. Es sintaxis de JavaScript, no una API del DOM; comprueba la compatibilidad con ?. y Object.hasOwn en entornos de ejecución antiguos.
Ejemplos
{
const key = "display count";
const tag = Symbol("status");
const obj = { key: 0, [key]: 2, [tag]: "ready" };
obj[key] = obj[key] + 1;
console.log(obj[key]);
console.log(obj.key);
console.log(obj[tag]);
const absent = null;
console.log(String(absent?.[key]));
}Resultado
3 0 ready undefined
`obj[key]` pasa de `2` a `3`, pero `obj.key` sigue valiendo `0`. `obj[tag]` lee `ready` mediante una clave de tipo `Symbol`, y el acceso opcional sobre `null` da `undefined`.
Lecciones relacionadas
- JavaScript · Lección 38 · Avanzado · Versión: 4
- JavaScript · Lección 44 · Avanzado · Versión: 4