← 返回首页
Map.prototype.getOrInsert() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Seitenleiste umschalten
  1. Web
  2. JavaScript
  3. JavaScript-Referenz
  4. Eingebaute Standardobjekte
  5. Map
  6. getOrInsert()
Farbschema
  • Systemeinstellung
  • Hell
  • Dunkel
Deutsch
Sprache merken Mehr erfahren

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Map.prototype.getOrInsert()

Baseline 2026
Neu verfügbar

Seit February 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die getOrInsert() Methode von Map Instanzen gibt den Wert zurück, der dem angegebenen Schlüssel in dieser Map entspricht. Falls der Schlüssel nicht vorhanden ist, fügt sie einen neuen Eintrag mit dem Schlüssel und einem gegebenen Standardwert ein und gibt den eingefügten Wert zurück.

Falls die Berechnung des Standardwerts aufwendig ist, sollten Sie in Betracht ziehen, anstelle dessen Map.prototype.getOrInsertComputed() zu verwenden, welche einen Rückruf annimmt, um den Standardwert nur dann zu berechnen, wenn er tatsächlich benötigt wird.

In diesem Artikel

Probieren Sie es aus

const map = new Map([["bar", "foo"]]); console.log(map.getOrInsert("bar", "default")); // Expected output: "foo" console.log(map.getOrInsert("baz", "default")); // Expected output: "default"

Syntax

js
getOrInsert(key, defaultValue)

Parameter

key

Der Schlüssel des Werts, der aus dem Map Objekt zurückgegeben werden soll. Objektschlüssel werden durch Referenz verglichen, nicht durch den Wert.

defaultValue

Der Wert, der eingefügt und zurückgegeben wird, wenn der Schlüssel im Map Objekt noch nicht vorhanden ist.

Rückgabewert

Der Wert, der dem angegebenen Schlüssel im Map Objekt zugeordnet ist. Falls der Schlüssel nicht gefunden werden kann, wird defaultValue eingefügt und zurückgegeben.

Beschreibung

Die getOrInsert() Methode ist äquivalent zum Folgenden:

js
if (map.has(key)) { return map.get(key); } map.set(key, defaultValue); return defaultValue;

Sie ist auch ähnlich dem folgenden Muster (das etwas weniger zuverlässig ist, falls null oder undefined gültige Werte in Ihrer Map sind):

js
map.set(key, map.get(key) ?? defaultValue);

Beispiele

Multimap

In einer Map, wo jeder Schlüssel auf ein Array von Werten abgebildet ist, können Sie getOrInsert() verwenden, um sicherzustellen, dass das Array für einen gegebenen Schlüssel existiert, bevor Sie versuchen, einen neuen Wert in das Array zu schieben.

js
map.getOrInsert(key, []).push(value);

Anwenden von Standardwerten

Sie können getOrInsert() verwenden, um sicherzustellen, dass ein Schlüssel in einer Map existiert, selbst wenn Sie seinen Wert derzeit nicht benötigen. Dies geschieht meistens, um Benutzereingaben zu normalisieren.

Stellen Sie sich vor, Sie haben eine Map mit Benutzerpräferenzen und möchten sicherstellen, dass eine bestimmte Präferenz immer auf einen Standardwert gesetzt ist, wenn der Benutzer sie nicht spezifiziert hat:

js
const options = readConfig(); options.getOrInsert("theme", "light"); options.getOrInsert("fontSize", 14); // Later in your code, you can safely assume these options exist document.body.dataset.theme = options.get("theme");

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-map.prototype.getorinsert

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

Help improve MDN

War diese Übersetzung hilfreich?
Ja Nein
Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.
Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden
  1. Eingebaute Standardobjekte
  2. Map
  3. Konstruktor
    1. Map()
  4. Statische Methoden
    1. groupBy()
  5. Statische Eigenschaften
    1. [Symbol.species]
  6. Instanzmethoden
    1. clear()
    2. delete()
    3. entries()
    4. forEach()
    5. get()
    6. getOrInsert()
    7. getOrInsertComputed()
    8. has()
    9. keys()
    10. set()
    11. values()
    12. [Symbol.iterator]()
  7. Instanzeigenschaften
    1. size
  8. Vererbung
  9. Object/Function
  10. Statische Methoden
    1. apply()
    2. bind()
    3. call()
    4. toString()
    5. [Symbol.hasInstance]()
  11. Statische Eigenschaften
    1. displayName
    2. length
    3. name
    4. prototype
    5. arguments
    6. caller
  12. Instanzmethoden
    1. __defineGetter__()
    2. __defineSetter__()
    3. __lookupGetter__()
    4. __lookupSetter__()
    5. hasOwnProperty()
    6. isPrototypeOf()
    7. propertyIsEnumerable()
    8. toLocaleString()
    9. toString()
    10. valueOf()
  13. Instanzeigenschaften
    1. __proto__
    2. constructor

Der Bauplan für ein besseres Internet.

MDN Mitmachen Entwicklung

Besuche die gemeinnützige Muttergesellschaft der Mozilla Corporation, die Mozilla Foundation.
Teile dieses Inhalts sind ©1998–2026 von einzelnen mozilla.org-Mitwirkenden. Inhalte sind verfügbar unter einer Creative-Commons-Lizenz.