WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.preventExtensions — neue Eigenschaften verhindern

Object.preventExtensions(obj) verhindert unwiderruflich, dass einem Objekt eigene Eigenschaften hinzugefügt werden, und gibt dasselbe Objekt zurück. Vorhandene Werte oder verschachtelte Objekte werden dadurch nicht eingefroren.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Object.preventExtensions(obj)

Object.preventExtensions(obj) macht ein Objekt nicht erweiterbar: Es können keine neuen eigenen Eigenschaften hinzugefügt werden, auch keine mit symbol-Schlüsseln. Die Methode verändert das übergebene Objekt und gibt dieselbe Referenz zurück, keine Kopie. Mit Object.isExtensible(obj) lässt sich der Zustand prüfen. Der Vorgang kann nicht rückgängig gemacht werden.

Bei einem gewöhnlichen Objekt behalten vorhandene Eigenschaften ihre Deskriptoren: Beschreibbaren Eigenschaften lassen sich weiterhin Werte zuweisen, und konfigurierbare Eigenschaften lassen sich weiterhin löschen. Eine gelöschte Eigenschaft kann nicht wieder hinzugefügt werden. Auch der Wechsel zu einem anderen Prototyp ist untersagt; den bisherigen Prototyp anzugeben bleibt erlaubt.

Ein typisiertes Array fester Länge, das auf einem ArrayBuffer mit unveränderlicher Größe basiert, kann nicht erweiterbar gemacht werden. Seine vorhandenen indizierten Elemente lassen sich jedoch nicht löschen, obwohl ihre Deskriptoren configurable: true ausweisen.

Eine Zuweisung, die eine neue eigene Eigenschaft erzeugen würde, löst im Strict Mode einen TypeError aus und wird außerhalb davon normalerweise ignoriert. Object.defineProperty löst unabhängig vom Modus einen TypeError aus, wenn eine Eigenschaft hinzugefügt werden soll. Die Methode selbst löst ebenfalls einen TypeError aus, wenn der interne Vorgang das Verhindern ablehnt, etwa durch eine Proxy-Falle, die false zurückgibt. Im aktuellen ECMAScript werden primitive Argumente, einschließlich null und undefined, unverändert zurückgegeben.

Object.seal bietet stärkeren Schutz: Es setzt configurable für alle eigenen Eigenschaften auf false, sodass sie nicht gelöscht werden können. Bei einem versiegelten gewöhnlichen Objekt lässt sich das Attribut writable einer beschreibbaren Dateneigenschaft weiterhin von true auf false setzen. Bei einem versiegelten Modul-Namensraumobjekt weisen die Deskriptoren der Eigenschaften, die den exportierten Bindungen entsprechen, zwar writable: true aus, das Objekt lässt die Änderung dieses Attributs auf false aber nicht zu. Bei einem gewöhnlichen Objekt setzt Object.freeze zusätzlich writable für alle eigenen Dateneigenschaften auf false. Bei einem Modul-Namensraumobjekt löst Object.freeze einen TypeError aus, wenn es versucht, writable für eine Eigenschaft, die einer exportierten Bindung entspricht, auf false zu setzen. Ist diese Bindung noch nicht initialisiert, kann bereits das Abrufen des Eigenschaftsdeskriptors einen ReferenceError auslösen, bevor es zu diesem Versuch kommt. Keine dieser Operationen wirkt sich rekursiv auf verschachtelte Objekte aus. Dies ist eine ECMAScript-Sprach-API und keine browserbasierte Web-API; der Standard allein belegt nicht die Unterstützung in einem bestimmten Browser.

Beispiele

"use strict";
const item = { count: 1, temporary: true };
const result = Object.preventExtensions(item);
console.log(result === item);
console.log(Object.isExtensible(item));
item.count = 2;
console.log(item.count);
console.log(delete item.temporary);
try {
  item.extra = 3;
} catch (error) {
  console.log(error.name);
}
console.log(Object.hasOwn(item, "extra"));

Ergebnis

true
false
2
true
TypeError
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen