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

CKTIS / JavaScript

Map.prototype.set: escribir una entrada

El método set añade o actualiza un par clave–valor en un Map y devuelve ese mismo Map para permitir encadenamiento.

Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxis

map.set(key, value)

map.set(key, value) guarda sin conversión y devuelve el Map receptor. Una clave nueva se añade al final del orden de inserción. Actualizar una clave sustituye su valor sin cambiar size ni moverla; solo delete seguido de set crea una posición nueva al final.

Las claves usan SameValueZero: NaN coincide con NaN y -0 se normaliza a +0. Claves y valores objeto conservan las mismas referencias sin clonarse. El retorno permite map.set(a, 1).set(b, 2).

El receptor debe tener datos internos de Map; objeto, Set o Proxy no gestionado lanza TypeError. Es estándar desde ECMAScript 2015. En get-or-create, un valor existente puede ser undefined, por lo que get solo no siempre comprueba presencia.

Ejemplos

const map = new Map();
console.log(map.set("a", 1) === map);
map.set("b", 2).set("a", 3);
console.log(map.size, [...map.keys()].join(","), map.get("a"));
map.delete("a");
map.set("a", 4);
console.log([...map.keys()].join(","));
const key = {};
const value = {};
map.set(key, value);
console.log(map.get(key) === value);
map.set(NaN, 1).set(NaN, 2).set(-0, "zero");
console.log(map.get(NaN), map.get(+0));
try { Map.prototype.set.call({}, "x", 1); } catch (error) { console.log(error instanceof TypeError); }

Resultado

true
2 a,b 3
b,a
true
2 zero
true

Fuentes