Map : méthode getOrInsert()

Baseline 2026

Nouvellement disponible

Depuis February 2026, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La méthode getOrInsert() des instances de Map retourne la valeur correspondant à la clé définie dans cette Map. Si la clé n'est pas présente, elle insère une nouvelle entrée avec la clé et une valeur par défaut donnée, puis retourne la valeur insérée.

Si le calcul de la valeur par défaut est coûteux, envisagez d'utiliser Map.prototype.getOrInsertComputed() à la place, qui prend une fonction de rappel pour calculer la valeur par défaut uniquement si elle est réellement nécessaire.

Dans cet article

Exemple interactif

const map = new Map([["toto", "truc"]]);
console.log(map.getOrInsert("toto", "défaut"));
// Sortie attendue : "truc"

console.log(map.getOrInsert("baz", "défaut"));
// Sortie attendue : "défaut"

Syntaxe

getOrInsert(key, defaultValue)

Paramètres

key

La clé de la valeur à retourner depuis l'objet Map. Les clés des objets sont comparées par référence, et pas par valeur.

defaultValue

La valeur à insérer et à retourner si la clé n'est pas déjà présente dans l'objet Map.

Valeur de retour

La valeur associée à la clé définie dans l'objet Map. Si la clé n'est pas trouvée, defaultValue est inséré et retourné.

Description

La méthode getOrInsert() est équivalente à ce qui suit :

js
if (map.has(cle)) {
  return map.get(cle);
}
map.set(cle, valeurDefaut);
return valeurDefaut;

C'est également similaire au modèle suivant (qui est légèrement moins fiable si null ou undefined sont des valeurs valides dans vos tableaux associatifs) :

map.set(cle, map.get(cle) ?? valeurDefaut);

js
const options = readConfig();
options.getOrInsert("theme", "light");
options.getOrInsert("fontSize", 14);

// Plus tard dans votre code, vous pouvez supposer en toute sécurité que ces options existent
document.body.dataset.theme = options.get("theme");