Object Initializer
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Ein Objekt-Initializer ist eine durch Kommas getrennte Liste von null oder mehr Paaren von Eigenschaftsnamen und zugehörigen Werten eines Objekts, eingeschlossen in geschweifte Klammern ({}
). Objekte können auch mithilfe von Object.create()
oder durch Aufrufen einer Konstruktorfunktion mit dem new
-Operator initialisiert werden.
Probieren Sie es aus
const object1 = { a: "foo", b: 42, c: {} };
console.log(object1.a);
// Expected output: "foo"
const a = "foo";
const b = 42;
const c = {};
const object2 = { a: a, b: b, c: c };
console.log(object2.b);
// Expected output: 42
const object3 = { a, b, c };
console.log(object3.a);
// Expected output: "foo"
Syntax
o = {
a: "foo",
b: 42,
c: {},
1: "number literal property",
"foo:bar": "string literal property",
shorthandProperty,
method(parameters) {
// …
},
get property() {},
set property(value) {},
[expression]: "computed property",
__proto__: prototype,
...spreadProperty,
};
Beschreibung
Objektliteral-Syntax vs. JSON
Die Objektliteral-Syntax ist nicht dasselbe wie die JavaScript Object Notation (JSON). Obwohl sie ähnlich aussehen, gibt es Unterschiede zwischen ihnen:
- JSON erlaubt nur die Eigenschaftsdefinition mit dem
"property": value
-Syntax. Der Eigenschaftsname muss in doppelten Anführungszeichen stehen, und die Definition kann keine Kurzform sein. Berechnete Eigenschaftsnamen sind ebenfalls nicht erlaubt. - JSON-Objekteigenschaftenwerte können nur Zeichenketten, Zahlen,
true
,false
,null
, Arrays oder ein anderes JSON-Objekt sein. Das bedeutet, dass JSON keine Methoden oder nicht-einfache Objekte wieMap
oderRegExp
ausdrücken kann. - In JSON ist
"__proto__"
ein normaler Eigenschaftsschlüssel. In einem Objektliteral setzt es das Prototyp des Objekts.
JSON ist eine strikte Teilmenge der Objektliteral-Syntax, was bedeutet, dass jeder gültige JSON-Text als Objektliteral geparst werden kann und wahrscheinlich keine Syntaxfehler verursacht. Die einzige Ausnahme ist, dass die Objektliteral-Syntax doppelte __proto__
-Schlüssel verbietet, was nicht für JSON.parse()
gilt. Letzteres behandelt __proto__
wie eine normale Eigenschaft und nimmt den letzten Vorkommnis als Wert der Eigenschaft. Die einzige Zeit, in der sich der objektive Sinn, den sie darstellen, unterscheidet, ist ebenfalls, wenn die Quelle den __proto__
-Schlüssel enthält — für Objektliterale setzt es den Prototyp des Objekts; für JSON ist es eine normale Eigenschaft.
console.log(JSON.parse('{ "__proto__": 0, "__proto__": 1 }')); // {__proto__: 1}
console.log({ "__proto__": 0, "__proto__": 1 }); // SyntaxError: Duplicate __proto__ fields are not allowed in object literals
console.log(JSON.parse('{ "__proto__": {} }')); // { __proto__: {} }
console.log({ "__proto__": {} }); // {} (with {} as prototype)
Beispiele
Objekte erstellen
Ein leeres Objekt ohne Eigenschaften kann folgendermaßen erstellt werden:
const object = {};
Der Vorteil der Literal- oder Initializer-Notation besteht jedoch darin, dass Sie schnell Objekte mit Eigenschaften innerhalb der geschweiften Klammern erstellen können. Sie notieren eine Liste von Schlüssel: Wert
-Paaren, getrennt durch Kommas.
Der folgende Code erstellt ein Objekt mit drei Eigenschaften, und die Schlüssel sind "foo"
, "age"
und "baz"
. Die Werte dieser Schlüssel sind eine Zeichenkette "bar"
, die Zahl 42
und ein weiteres Objekt.
const object = {
foo: "bar",
age: 42,
baz: { myProp: 12 },
};
Zugriff auf Eigenschaften
Sobald Sie ein Objekt erstellt haben, möchten Sie möglicherweise darauf zugreifen oder es ändern. Auf Objekteigenschaften kann mithilfe der Punktnotation oder der Klammernotation zugegriffen werden. (Siehe Eigenschaftszugriffe für detaillierte Informationen.)
object.foo; // "bar"
object["age"]; // 42
object.baz; // {myProp: 12}
object.baz.myProp; //12
Eigenschaftsdefinitionen
Wir haben bereits gelernt, wie man Eigenschaften mit der Initialisierer-Syntax notiert. Oft gibt es Variablen in Ihrem Code, die Sie in ein Objekt einfügen möchten. Sie werden Code wie diesen sehen:
const a = "foo";
const b = 42;
const c = {};
const o = {
a: a,
b: b,
c: c,
};
Es gibt eine kürzere Notation, um dasselbe zu erreichen:
const a = "foo";
const b = 42;
const c = {};
// Shorthand property names
const o = { a, b, c };
// In other words,
console.log(o.a === { a }.a); // true
Doppelte Eigenschaftsnamen
Wenn Sie denselben Namen für Ihre Eigenschaften verwenden, wird die zweite Eigenschaft die erste überschreiben.
const a = { x: 1, x: 2 };
console.log(a); // {x: 2}
Nach ES2015 sind doppelte Eigenschaftsnamen überall erlaubt, einschließlich Strict Mode. Sie können auch doppelte Eigenschaftsnamen in Klassen haben. Die einzige Ausnahme sind private Eigenschaften, die innerhalb des Klassenrumpfs eindeutig sein müssen.
Methodendefinitionen
Eine Eigenschaft eines Objekts kann sich auch auf eine Funktion oder eine Getter- oder Setter-Methode beziehen.
const o = {
property: function (parameters) {},
get property() {},
set property(value) {},
};
Es ist eine Kurznotation verfügbar, sodass das Schlüsselwort function
nicht mehr notwendig ist.
// Shorthand method names
const o = {
property(parameters) {},
};
Es gibt auch eine Möglichkeit, Generatormethoden prägnant zu definieren.
const o = {
*generator() {
// …
},
};
Dies ist gleichwertig mit dieser ES5-ähnlichen Notation (aber beachten Sie, dass ECMAScript 5 keine Generatoren hat):
const o = {
generator: function* () {
// …
},
};
Für mehr Informationen und Beispiele zu Methoden siehe Methodendefinitionen.
Berechnete Eigenschaftsnamen
Die Objektinitialisierer-Syntax unterstützt auch berechnete Eigenschaftsnamen. Dadurch können Sie einen Ausdruck in eckigen Klammern []
einfügen, der berechnet und als Eigenschaftsname verwendet wird. Dies erinnert an die Klammernotation der Eigenschaftszugriff-Syntax, die Sie möglicherweise bereits verwendet haben, um Eigenschaften zu lesen und zu setzen.
Nun können Sie eine ähnliche Syntax auch in Objektliteralen verwenden:
// Computed property names
let i = 0;
const a = {
[`foo${++i}`]: i,
[`foo${++i}`]: i,
[`foo${++i}`]: i,
};
console.log(a.foo1); // 1
console.log(a.foo2); // 2
console.log(a.foo3); // 3
const items = ["A", "B", "C"];
const obj = {
[items]: "Hello",
};
console.log(obj); // A,B,C: "Hello"
console.log(obj["A,B,C"]); // "Hello"
const param = "size";
const config = {
[param]: 12,
[`mobile${param.charAt(0).toUpperCase()}${param.slice(1)}`]: 4,
};
console.log(config); // {size: 12, mobileSize: 4}
Spread-Eigenschaften
Objektliterale unterstützen die Spread-Syntax. Sie kopiert eigene aufzählbare Eigenschaften von einem bereitgestellten Objekt in ein neues Objekt.
Shallow-Cloning (ohne prototype
) oder das Zusammenführen von Objekten ist jetzt mit einer kürzeren Syntax möglich als mit Object.assign()
.
const obj1 = { foo: "bar", x: 42 };
const obj2 = { foo: "baz", y: 13 };
const clonedObj = { ...obj1 };
// { foo: "bar", x: 42 }
const mergedObj = { ...obj1, ...obj2 };
// { foo: "baz", x: 42, y: 13 }
Warnung:
Beachten Sie, dass Object.assign()
Setter auslöst, während die Spread-Syntax dies nicht tut!
Prototyp-Setter
Eine Eigenschaftsdefinition der Form __proto__: value
oder "__proto__": value
erstellt keine Eigenschaft mit dem Namen __proto__
. Stattdessen, wenn der bereitgestellte Wert ein Objekt oder null
ist, verweist es auf das [[Prototype]]
des erstellten Objekts auf diesen Wert. (Wenn der Wert kein Objekt oder null
ist, wird das Objekt nicht geändert.)
Beachten Sie, dass der __proto__
-Schlüssel standardisierte Syntax ist, im Gegensatz zu den nicht-standardisierten und nicht-performanten Object.prototype.__proto__
Accessoren. Es setzt das [[Prototype]]
während der Objekterstellung, ähnlich wie Object.create
— anstatt die Prototypenkette zu ändern.
const obj1 = {};
console.log(Object.getPrototypeOf(obj1) === Object.prototype); // true
const obj2 = { __proto__: null };
console.log(Object.getPrototypeOf(obj2)); // null
const protoObj = {};
const obj3 = { "__proto__": protoObj };
console.log(Object.getPrototypeOf(obj3) === protoObj); // true
const obj4 = { __proto__: "not an object or null" };
console.log(Object.getPrototypeOf(obj4) === Object.prototype); // true
console.log(Object.hasOwn(obj4, "__proto__")); // false
Nur ein einzelner Prototyp-Setter ist in einem Objektliteral erlaubt. Mehrere Prototyp-Setter führen zu einem Syntaxfehler.
Eigenschaftsdefinitionen, die keine "Doppelpunkt"-Notation verwenden, sind keine Prototyp-Setter. Es handelt sich um Eigenschaftsdefinitionen, die sich identisch zu ähnlichen Definitionen mit jedem anderen Namen verhalten.
const __proto__ = "variable";
const obj1 = { __proto__ };
console.log(Object.getPrototypeOf(obj1) === Object.prototype); // true
console.log(Object.hasOwn(obj1, "__proto__")); // true
console.log(obj1.__proto__); // "variable"
const obj2 = { __proto__() { return "hello"; } };
console.log(obj2.__proto__()); // "hello"
const obj3 = { ["__proto__"]: 17 };
console.log(obj3.__proto__); // 17
// Mixing prototype setter with normal own properties with "__proto__" key
const obj4 = { ["__proto__"]: 17, __proto__: {} }; // {__proto__: 17} (with {} as prototype)
const obj5 = {
["__proto__"]: 17,
__proto__: {},
__proto__: null, // SyntaxError: Duplicate __proto__ fields are not allowed in object literals
};
const obj6 = {
["__proto__"]: 17,
["__proto__"]: "hello",
__proto__: null,
}; // {__proto__: "hello"} (with null as prototype)
const obj7 = {
["__proto__"]: 17,
__proto__,
__proto__: null,
}; // {__proto__: "variable"} (with null as prototype)
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-object-initializer |
Browser-Kompatibilität
BCD tables only load in the browser