Object.freeze()

obj

Das Objekt, das eingefroren werden soll.

Das Objekt, das der Funktion übergeben wurde.

Das Einfrieren eines Objekts entspricht dem Verhindern von Erweiterungen und dem Ändern aller bestehenden Eigenschaftsdeskriptoren von configurable zu false — und für Dateneigenschaften auch writable zu false. Nichts kann dem Eigenschaften-Set eines eingefrorenen Objekts hinzugefügt oder daraus entfernt werden. Jeder Versuch dies zu tun, wird entweder stillschweigend fehlschlagen oder eine TypeError-Ausnahme auslösen (meistens, aber nicht ausschließlich im Strict-Modus).

Für Dateneigenschaften eines eingefrorenen Objekts können ihre Werte nicht geändert werden, da die Attribute writable und configurable auf false gesetzt sind. Zugriffseigenschaften (Getter und Setter) funktionieren genauso — der von den Gettern zurückgegebene Eigenschaftswert kann sich weiterhin ändern und der Setter kann aufgerufen werden, ohne beim Setzen der Eigenschaft Fehler auszulösen. Beachten Sie, dass Werte, die Objekte sind, weiterhin modifiziert werden können, es sei denn, sie sind ebenfalls eingefroren. Als Objekt kann ein Array eingefroren werden; nach dem Einfrieren können seine Elemente nicht verändert werden und es können keine Elemente hinzugefügt oder daraus entfernt werden.

Private Elemente sind keine Eigenschaften und haben nicht das Konzept von Eigenschaftsdeskriptoren. Das Einfrieren eines Objekts mit privaten Elementen verhindert nicht, dass die Werte dieser privaten Elemente geändert werden. (Das Einfrieren von Objekten soll in der Regel als Sicherheitsmaßnahme gegen externen Code dienen, aber externer Code kann sowieso nicht auf private Elemente zugreifen.) Private Elemente können weder hinzugefügt noch vom Objekt entfernt werden, unabhängig davon, ob das Objekt eingefroren ist oder nicht.

freeze() gibt dasselbe Objekt zurück, das der Funktion übergeben wurde. Es erstellt keine eingefrorene Kopie.

Ein TypedArray oder ein DataView mit Elementen wird eine TypeError verursachen, da sie Ansichten über den Speicher sind und definitiv andere mögliche Probleme verursachen werden:

Object.freeze(new Uint8Array(0)); // No elements
// Uint8Array []

Object.freeze(new Uint8Array(1)); // Has elements
// TypeError: Cannot freeze array buffer views with elements

Object.freeze(new DataView(new ArrayBuffer(32))); // No elements
// DataView {}

Object.freeze(new Float64Array(new ArrayBuffer(64), 63, 0)); // No elements
// Float64Array []

Object.freeze(new Float64Array(new ArrayBuffer(64), 32, 2)); // Has elements
// TypeError: Cannot freeze array buffer views with elements

Beachten Sie, dass, da die Standard-Drei-Eigenschaften (buf.byteLength, buf.byteOffset und buf.buffer) schreibgeschützt sind (wie die eines ArrayBuffer oder SharedArrayBuffer), es keinen Grund gibt, zu versuchen, diese Eigenschaften einzufrieren.

Im Gegensatz zu Object.seal(), werden bei Objekten, die mit Object.freeze() eingefroren werden, bestehende Eigenschaften unveränderlich gemacht und Dateneigenschaften können nicht neu zugewiesen werden.

const a = [0];
Object.freeze(a); // The array cannot be modified now.

a[0] = 1; // fails silently

// In strict mode such attempt will throw a TypeError
function fail() {
  "use strict";
  a[0] = 1;
}

fail();

// Attempted to push
a.push(2); // throws a TypeError

Das eingefrorene Objekt ist unveränderlich. Es ist jedoch nicht zwangsläufig konstant. Das folgende Beispiel zeigt, dass ein eingefrorenes Objekt nicht konstant ist (das Einfrieren ist oberflächlich).

const obj1 = {
  internal: {},
};

Object.freeze(obj1);
obj1.internal.a = "aValue";

obj1.internal.a; // 'aValue'

Um ein konstantes Objekt zu erhalten, muss der gesamte Referenzgraph (direkte und indirekte Verweise auf andere Objekte) nur unveränderliche eingefrorene Objekte referenzieren. Das zugefrierende Objekt ist deshalb als unveränderlich zu bezeichnen, weil der gesamte Objektzustand (Werte und Verweise auf andere Objekte) innerhalb des gesamten Objekts festgelegt ist. Beachten Sie, dass Strings, Zahlen und Booleans immer unveränderlich sind und dass Funktionen und Arrays Objekte sind.

Das Ergebnis des Aufrufs von Object.freeze(object) gilt nur für die unmittelbaren Eigenschaften des Objekts selbst und verhindert zukünftige Hinzufügungs-, Entfernungs- oder Wertneuheitsoperationen nur auf object. Wenn die Werte dieser Eigenschaften selbst Objekte sind, sind diese Objekte nicht eingefroren und können Ziel für Eigenschaftshinzufügungs-, Entfernungs- oder Wertneuheitsoperationen sein.

const employee = {
  name: "Mayank",
  designation: "Developer",
  address: {
    street: "Rohini",
    city: "Delhi",
  },
};

Object.freeze(employee);

employee.name = "Dummy"; // fails silently in non-strict mode
employee.address.city = "Noida"; // attributes of child object can be modified

console.log(employee.address.city); // "Noida"

Um ein Objekt unveränderlich zu machen, frieren Sie rekursiv jede nicht primitive Eigenschaft ein (tiefes Einfrieren). Verwenden Sie das Muster fallweise basierend auf Ihrem Design, wenn Sie wissen, dass das Objekt keine Zyklen im Referenzgraphen enthält, da sonst eine Endlosschleife ausgelöst wird. Beispielsweise haben Funktionen, die mit der function-Syntax erstellt wurden, eine prototype-Eigenschaft mit einer constructor-Eigenschaft, die auf die Funktion selbst verweist, sodass sie standardmäßig Zyklen haben. Andere Funktionen, wie Pfeilfunktionen, können dennoch eingefroren werden.

Eine Verbesserung an deepFreeze() wäre es, die Objekte zu speichern, die bereits besucht wurden, so dass Sie beim Prozess der Unveränderlichen-Machung eines Objekts den rekursiven Aufruf von deepFreeze() unterdrücken können. Für ein Beispiel siehe Verwendung von WeakSet zur Erkennung von zyklischen Referenzen. Sie laufen immer noch Gefahr, ein Objekt einzufrieren, das nicht eingefroren werden sollte, wie z. B. window.

function deepFreeze(object) {
  // Retrieve the property names defined on object
  const propNames = Reflect.ownKeys(object);

  // Freeze properties before freezing self
  for (const name of propNames) {
    const value = object[name];

    if ((value && typeof value === "object") || typeof value === "function") {
      deepFreeze(value);
    }
  }

  return Object.freeze(object);
}

const obj2 = {
  internal: {
    a: null,
  },
};

deepFreeze(obj2);

obj2.internal.a = "anotherValue"; // fails silently in non-strict mode
obj2.internal.a; // null

• Object.isFrozen()
• Object.preventExtensions()
• Object.isExtensible()
• Object.seal()
• Object.isSealed()