Baseline Widely available *
Das Map
Objekt speichert Schlüssel-Werte-Paare und merkt sich die ursprüngliche Einfügereihenfolge der Schlüssel. Jeder Wert (sowohl Objekte als auch primitive Werte) kann als Schlüssel oder als Wert verwendet werden.
const map = new Map();
map.set("a", 1);
map.set("b", 2);
map.set("c", 3);
console.log(map.get("a"));
// Expected output: 1
map.set("a", 97);
console.log(map.get("a"));
// Expected output: 97
console.log(map.size);
// Expected output: 3
map.delete("b");
console.log(map.size);
// Expected output: 2
Beschreibung
Map
Objekte sind Sammlungen von Schlüssel-Werte-Paaren. Ein Schlüssel in der Map
kann nur einmal vorkommen; er ist im Kollektiv der Map
einzigartig. Ein Map
Objekt wird durch Schlüssel-Werte-Paare iteriert â eine for...of
Schleife liefert ein Array mit 2 Elementen [key, value]
für jede Iteration zurück. Die Iteration erfolgt in Einfügereihenfolge, was der Reihenfolge entspricht, in der jedes Schlüssel-Werte-Paar zuerst durch die set()
Methode in die Karte eingefügt wurde (das heiÃt, es war kein Schlüssel mit demselben Wert bereits in der Map, als set()
aufgerufen wurde).
Die Spezifikation erfordert, dass Karten so implementiert werden, "dass sie im Durchschnitt Zugriffzeiten bieten, die sublinear zur Anzahl der Elemente in der Sammlung sind". Daher könnte sie intern als Hashtabelle (mit O(1) Zugriff), als Suchbaum (mit O(log(N)) Zugriff) oder als eine andere Datenstruktur dargestellt werden, solange die Komplexität besser als O(N) ist.
SchlüsseligkeitDie Gleichheit der Werte basiert auf dem SameValueZero Algorithmus. (Früher wurde SameValue verwendet, das 0
und -0
unterschiedlich behandelte. Prüfen Sie die Browser-Kompatibilität.) Dies bedeutet, dass NaN
als gleich zu NaN
betrachtet wird (obwohl NaN !== NaN
) und alle anderen Werte gemäà der Semantik des ===
Operators als gleich betrachtet werden.
Object
ist ähnlich zu Map
â beide ermöglichen es Ihnen, Schlüssel auf Werte zu setzen, diese Werte abzurufen, Schlüssel zu löschen und zu erkennen, ob etwas unter einem Schlüssel gespeichert ist. Aus diesem Grund (und weil es keine eingebauten Alternativen gab), wurde Object
historisch als Map
verwendet.
Es gibt jedoch wichtige Unterschiede, die Map
in manchen Fällen vorzuziehen machen:
Map
enthält standardmäÃig keine Schlüssel. Sie enthält nur das, was ausdrücklich hineingelegt wurde.
Ein Object
hat ein Prototype, daher enthält es Standardschlüssel, die mit Ihren eigenen Schlüsseln kollidieren könnten, wenn Sie nicht vorsichtig sind.
Hinweis: Dies kann umgangen werden, indem man Object.create(null)
verwendet, was jedoch selten gemacht wird.
Map
ist sicher in der Verwendung mit benutzerdefinierten Schlüsseln und Werten.
Das Setzen benutzerdefinierter Schlüssel-Werte-Paare auf einem Object
könnte es einem Angreifer ermöglichen, das Prototype des Objekts zu überschreiben, was zu Objekt-Injektionsangriffen führen kann. Wie bei dem Problem der zufälligen Schlüssel kann dies auch durch die Verwendung eines null
-Prototyp-Objekts gemildert werden.
Map
können jeden Wert haben (einschlieÃlich Funktionen, Objekte oder beliebige Primitive). Die Schlüssel eines Object
müssen entweder ein String
oder ein Symbol
sein. Schlüsselreihenfolge
Die Schlüssel in einer Map
sind in einer klaren Reihenfolge: Ein Map
Objekt iteriert Einträge, Schlüssel und Werte in der Reihenfolge des Einfügens der Einträge.
Obwohl die Schlüssel eines gewöhnlichen Object
jetzt sortiert sind, war dies nicht immer der Fall, und die Reihenfolge ist komplex. Daher ist es am besten, sich nicht auf die Eigenschaftsreihenfolge zu verlassen.
Die Reihenfolge wurde erstmals nur für eigene Eigenschaften in ECMAScript 2015 definiert; ECMAScript 2020 definiert die Reihenfolge auch für geerbte Eigenschaften. Beachten Sie jedoch, dass kein einzelner Mechanismus alle Eigenschaften eines Objekts iteriert; die verschiedenen Mechanismen schlieÃen jeweils unterschiedliche Teilmengen von Eigenschaften ein. (for-in
schlieÃt nur auflistbare, string-gesicherte Eigenschaften ein; Object.keys
schlieÃt nur eigene, auflistbare, string-gesicherte Eigenschaften ein; Object.getOwnPropertyNames
schlieÃt eigene, string-gesicherte Eigenschaften auch wenn nicht-auflistbar ein; Object.getOwnPropertySymbols
tut das Gleiche nur für Symbol
-gesicherte Eigenschaften, etc.)
GröÃe
Die Anzahl von Elementen in einerMap
kann einfach über ihre size
Eigenschaft abgerufen werden. Die Bestimmung der Anzahl von Elementen in einem Object
ist umständlicher und weniger effizient. Ein gängiger Weg, dies zu tun, ist über die length
des von Object.keys()
zurückgegebenen Arrays. Iteration Eine Map
ist ein iterierbares Objekt und kann direkt iteriert werden.
Object
implementiert kein Iterierungsprotokoll und ist daher nicht direkt mit der JavaScript for...of Anweisung iterierbar (standardmäÃig).
Hinweis:
Object.keys
oder Object.entries
verwenden.Bietet bessere Leistung in Szenarien, die häufige Hinzufügungen und Entfernungen von Schlüssel-Werte-Paaren beinhalten.
Nicht optimiert für häufige Hinzufügungen und Entfernungen von Schlüssel-Werte-Paaren.
Serialisierung und ParsingKeine native Unterstützung für Serialisierung oder Parsing.
(Aber Sie können Ihre eigene Serialisierungs- und Parsing-Unterstützung für Map
erstellen, indem Sie JSON.stringify()
mit seinem replacer Argument und JSON.parse()
mit seinem reviver Argument verwenden. Siehe die Stack Overflow Frage Wie JSON.stringify für eine ES6 Map verwendet wird?).
Native Unterstützung für die Serialisierung von Object
zu JSON, indem JSON.stringify()
verwendet wird.
Native Unterstützung für das Parsen von JSON zu Object
, indem JSON.parse()
verwendet wird.
Das Festlegen von Objekteigenschaften funktioniert auch für Map Objekte und kann zu erheblichen Verwirrungen führen.
Daher erscheint dies auf einfach Weise:
const wrongMap = new Map();
wrongMap["bla"] = "blaa";
wrongMap["bla2"] = "blaaa2";
console.log(wrongMap); // Map { bla: 'blaa', bla2: 'blaaa2' }
Aber diese Art der Festlegung einer Eigenschaft interagiert nicht mit der Map-Datenstruktur. Sie nutzt die Eigenschaft des generischen Objekts. Der Wert von 'bla' wird nicht in der Map für Abfragen gespeichert. Andere Operationen an den Daten schlagen fehl:
wrongMap.has("bla"); // false
wrongMap.delete("bla"); // false
console.log(wrongMap); // Map { bla: 'blaa', bla2: 'blaaa2' }
Die korrekte Verwendung zur Speicherung von Daten in der Map erfolgt über die Methode set(key, value)
.
const contacts = new Map();
contacts.set("Jessie", { phone: "213-555-1234", address: "123 N 1st Ave" });
contacts.has("Jessie"); // true
contacts.get("Hilary"); // undefined
contacts.set("Hilary", { phone: "617-555-4321", address: "321 S 2nd St" });
contacts.get("Jessie"); // {phone: "213-555-1234", address: "123 N 1st Ave"}
contacts.delete("Raymond"); // false
contacts.delete("Jessie"); // true
console.log(contacts.size); // 1
Map-ähnliche Browser-APIs
Browser Map
-ähnliche Objekte (oder "mapähnliche Objekte") sind Web API Schnittstellen, die sich in vielerlei Hinsicht wie eine Map
verhalten.
Genau wie Map
können Einträge in derselben Reihenfolge durchlaufen werden, in der sie dem Objekt hinzugefügt wurden. Map
-ähnliche Objekte und Map
haben auch Eigenschaften und Methoden, die denselben Namen und dasselbe Verhalten teilen. Im Gegensatz zu Map
erlauben sie jedoch nur spezifische vordefinierte Typen für die Schlüssel und Werte jedes Eintrags.
Die erlaubten Typen sind in der Spezifikations-IDL-Definition festgelegt. Zum Beispiel ist RTCStatsReport
ein Map
-ähnliches Objekt, das Zeichenfolgen für Schlüssel und Objekte für Werte verwenden muss. Dies ist in der untenstehenden Spezifikations-IDL definiert:
interface RTCStatsReport {
readonly maplike<DOMString, object>;
};
Map
-ähnliche Objekte sind entweder nur lesbar oder lese-schreibbar (siehe das readonly
Schlüsselwort in der obigen IDL).
Map
-ähnliche Objekte haben die Eigenschaft size
, und die Methoden: entries()
, forEach()
, get()
, has()
, keys()
, values()
, und Symbol.iterator()
.Map
-ähnliche Objekte haben zusätzlich die Methoden: clear()
, delete()
, und set()
.Die Methoden und Eigenschaften haben dasselbe Verhalten wie die gleichwertigen Entitäten in Map
, abgesehen von der Einschränkung auf die Typen der Schlüssel und Werte.
Die folgenden sind Beispiele für nur-lesbare Map
-ähnliche Browserobjekte:
Map()
Erzeugt ein neues Map
Objekt.
Map[Symbol.species]
Die Konstruktionsfunktion, die zum Erstellen abgeleiteter Objekte verwendet wird.
Map.groupBy()
Gruppiert die Elemente eines gegebenen Iterables unter Verwendung der von einer bereitgestellten Callback-Funktion zurückgegebenen Werte. Die abschlieÃend zurückgegebene Map
verwendet die einzigartigen Werte der Testfunktion als Schlüssel, die verwendet werden können, um die Array von Elementen in jeder Gruppe zu erhalten.
Diese Eigenschaften werden auf Map.prototype
definiert und mit allen Map
Instanzen geteilt.
Map.prototype.constructor
Die Konstruktionsfunktion, die das Instanzobjekt erschaffen hat. Für Map
Instanzen ist der Anfangswert der Map
Konstruktor.
Map.prototype.size
Gibt die Anzahl der Schlüssel/Wert-Paare im Map
Objekt zurück.
Map.prototype[Symbol.toStringTag]
Der Anfangswert der [Symbol.toStringTag]
Eigenschaft ist der String "Map"
. Diese Eigenschaft wird in Object.prototype.toString()
verwendet.
Map.prototype.clear()
Entfernt alle Schlüssel-Wert-Paare aus dem Map
Objekt.
Map.prototype.delete()
Gibt true
zurück, wenn ein Element im Map
Objekt existierte und entfernt wurde, oder false
, wenn das Element nicht existiert. map.has(key)
wird danach false
zurückgeben.
Map.prototype.entries()
Gibt ein neues Iterator-Objekt zurück, das ein zweigliedriges Array von [key, value]
für jedes Element im Map
Objekt in der Einfügereihenfolge enthält.
Map.prototype.forEach()
Ruft callbackFn
einmal für jedes im Map
Objekt existierende Schlüssel-Werte-Paar in der Einfügereihenfolge auf. Wenn ein thisArg
Parameter an forEach
übergeben wird, wird er als this
Wert für jeden Callback verwendet.
Map.prototype.get()
Gibt den mit dem übergebenen Schlüssel assoziierten Wert zurück oder undefined
, wenn keiner existiert.
Map.prototype.has()
Gibt einen Booleanwert zurück, der angibt, ob ein Wert in dem Map
Objekt mit dem übergebenen Schlüssel assoziiert war oder nicht.
Map.prototype.keys()
Gibt ein neues Iterator-Objekt zurück, das die Schlüssel für jedes Element im Map
Objekt in der Einfügereihenfolge enthält.
Map.prototype.set()
Setzt den Wert für den übergebenen Schlüssel im Map
Objekt. Gibt das Map
Objekt zurück.
Map.prototype.values()
Gibt ein neues Iterator-Objekt zurück, das die Werte für jedes Element im Map
Objekt in der Einfügereihenfolge enthält.
Map.prototype[Symbol.iterator]()
Gibt ein neues Iterator-Objekt zurück, das ein zweigliedriges Array von [key, value]
für jedes Element im Map
Objekt in der Einfügereihenfolge enthält.
const myMap = new Map();
const keyString = "a string";
const keyObj = {};
const keyFunc = () => {};
// setting the values
myMap.set(keyString, "value associated with 'a string'");
myMap.set(keyObj, "value associated with keyObj");
myMap.set(keyFunc, "value associated with keyFunc");
console.log(myMap.size); // 3
// getting the values
console.log(myMap.get(keyString)); // "value associated with 'a string'"
console.log(myMap.get(keyObj)); // "value associated with keyObj"
console.log(myMap.get(keyFunc)); // "value associated with keyFunc"
console.log(myMap.get("a string")); // "value associated with 'a string'", because keyString === 'a string'
console.log(myMap.get({})); // undefined, because keyObj !== {}
console.log(myMap.get(() => {})); // undefined, because keyFunc !== () => {}
Verwenden von NaN als Map-Schlüssel
NaN
kann auch als Schlüssel verwendet werden. Obwohl jedes NaN
nicht gleich sich selbst ist (NaN !== NaN
ist wahr), funktioniert das folgende Beispiel, weil NaN
s ununterscheidbar voneinander sind:
const myMap = new Map();
myMap.set(NaN, "not a number");
myMap.get(NaN);
// "not a number"
const otherNaN = Number("foo");
myMap.get(otherNaN);
// "not a number"
Iteration der Map mit for...of
Maps können mit einer for...of
Schleife iteriert werden:
const myMap = new Map();
myMap.set(0, "zero");
myMap.set(1, "one");
for (const [key, value] of myMap) {
console.log(`${key} = ${value}`);
}
// 0 = zero
// 1 = one
for (const key of myMap.keys()) {
console.log(key);
}
// 0
// 1
for (const value of myMap.values()) {
console.log(value);
}
// zero
// one
for (const [key, value] of myMap.entries()) {
console.log(`${key} = ${value}`);
}
// 0 = zero
// 1 = one
Iteration der Map mit forEach()
Maps können mit der forEach()
Methode iteriert werden:
myMap.forEach((value, key) => {
console.log(`${key} = ${value}`);
});
// 0 = zero
// 1 = one
Beziehung zu Array-Objekten
const kvArray = [
["key1", "value1"],
["key2", "value2"],
];
// Use the regular Map constructor to transform a 2D key-value Array into a map
const myMap = new Map(kvArray);
console.log(myMap.get("key1")); // "value1"
// Use Array.from() to transform a map into a 2D key-value Array
console.log(Array.from(myMap)); // Will show you exactly the same Array as kvArray
// A succinct way to do the same, using the spread syntax
console.log([...myMap]);
// Or use the keys() or values() iterators, and convert them to an array
console.log(Array.from(myMap.keys())); // ["key1", "key2"]
Klonen und Zusammenführen von Maps
Genau wie Array
s können Map
s geklont werden:
const original = new Map([[1, "one"]]);
const clone = new Map(original);
console.log(clone.get(1)); // one
console.log(original === clone); // false (useful for shallow comparison)
Hinweis: Beachten Sie, dass die Daten selbst nicht geklont werden. Mit anderen Worten, es ist nur eine flache Kopie der Map
.
Maps können zusammengeführt werden, wobei die Einzigartigkeit der Schlüssel erhalten bleibt:
const first = new Map([
[1, "one"],
[2, "two"],
[3, "three"],
]);
const second = new Map([
[1, "uno"],
[2, "dos"],
]);
// Merge two maps. The last repeated key wins.
// Spread syntax essentially converts a Map to an Array
const merged = new Map([...first, ...second]);
console.log(merged.get(1)); // uno
console.log(merged.get(2)); // dos
console.log(merged.get(3)); // three
Maps können auch mit Arrays zusammengeführt werden:
const first = new Map([
[1, "one"],
[2, "two"],
[3, "three"],
]);
const second = new Map([
[1, "uno"],
[2, "dos"],
]);
// Merge maps with an array. The last repeated key wins.
const merged = new Map([...first, ...second, [1, "un"]]);
console.log(merged.get(1)); // un
console.log(merged.get(2)); // dos
console.log(merged.get(3)); // three
Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4