delete

object

Der Name eines Objekts oder ein Ausdruck, der zu einem Objekt ausgewertet wird.

property

Die zu löschende Eigenschaft.

true in allen Fällen außer wenn die Eigenschaft eine own nicht konfigurierbare Eigenschaft ist, in diesem Fall wird false im nicht-strikten Modus zurückgegeben.

TypeError

Wird im strikten Modus ausgelöst, wenn die Eigenschaft eine eigene nicht konfigurierbare Eigenschaft ist.

ReferenceError

Wird ausgelöst, wenn object super ist.

Der delete Operator hat die gleiche Präzedenz wie andere unäre Operatoren wie typeof. Daher akzeptiert er jeden Ausdruck, der von höher priorisierten Operatoren gebildet wird. Dennoch führen die folgenden Formen zu frühen Syntaxfehlern im strikten Modus:

delete identifier;
delete object.#privateProperty;

Da Klassen automatisch im strikten Modus sind und private Elemente nur in Klassenkörpern legal referenziert werden können, können private Elemente niemals gelöscht werden. Während delete identifier funktionieren könnte, wenn identifier auf eine konfigurierbare Eigenschaft des globalen Objekts verweist, sollten Sie diese Form vermeiden und stattdessen globalThis voranstellen.

Obwohl andere Ausdrücke akzeptiert werden, führen sie nicht zu sinnvollen Verhaltensweisen:

delete console.log(1);
// Logs 1, returns true, but nothing deleted

Der delete Operator entfernt eine gegebene Eigenschaft von einem Objekt. Bei erfolgreicher Löschung wird true zurückgegeben, andernfalls false. Anders als oft angenommen (möglicherweise aufgrund anderer Programmiersprachen wie delete in C++) hat der delete Operator nichts mit der direkten Speicherfreigabe zu tun. Speicherverwaltung erfolgt indirekt durch das Brechen von Referenzen. Siehe die Seite zur Speicherverwaltung für mehr Details.

Es ist wichtig, die folgenden Szenarien zu beachten:

• Wenn die Eigenschaft, die Sie zu löschen versuchen, nicht existiert, hat delete keinen Effekt und gibt true zurück.
• delete hat nur einen Effekt auf eigene Eigenschaften. Wenn eine Eigenschaft mit demselben Namen in der Prototypenkette des Objekts existiert, wird nach dem Löschen die Eigenschaft aus der Prototypenkette verwendet.
• Nicht konfigurierbare Eigenschaften können nicht entfernt werden. Dazu gehören Eigenschaften von eingebauten Objekten wie Math, Array, Object und Eigenschaften, die mit Methoden wie Object.defineProperty() als nicht konfigurierbar erstellt wurden.
• Variablen, einschließlich Funktionsparameter, können niemals gelöscht werden. delete variable wird im strikten Modus einen SyntaxError auslösen und hat im nicht-strikten Modus keinen Effekt.
  • Jede Variable, die mit var deklariert wird, kann nicht aus dem globalen Gültigkeitsbereich oder aus einem Funktionsbereich gelöscht werden, da sie zwar möglicherweise an das globale Objekt gebunden sind, aber nicht konfigurierbar sind.
  • Jede Variable, die mit let oder const deklariert wird, kann nicht aus dem Bereich gelöscht werden, in dem sie definiert wurden, da sie nicht an ein Objekt gebunden sind.

Im folgenden Beispiel löschen wir eine eigene Eigenschaft eines Objekts, während eine Eigenschaft mit demselben Namen in der Prototypenkette verfügbar ist:

function Foo() {
  this.bar = 10;
}

Foo.prototype.bar = 42;

const foo = new Foo();

// foo.bar is associated with the
// own property.
console.log(foo.bar); // 10

// Delete the own property within the
// foo object.
delete foo.bar; // returns true

// foo.bar is still available in the
// prototype chain.
console.log(foo.bar); // 42

// Delete the property on the prototype.
delete Foo.prototype.bar; // returns true

// The "bar" property can no longer be
// inherited from Foo since it has been
// deleted.
console.log(foo.bar); // undefined

Wenn Sie ein Array-Element löschen, wird die Länge des Arrays nicht beeinflusst. Das gilt sogar, wenn Sie das letzte Element des Arrays löschen.

Wenn der delete Operator ein Array-Element entfernt, befindet sich dieses Element nicht mehr im Array. Im folgenden Beispiel wird trees[3] mit delete entfernt.

const trees = ["redwood", "bay", "cedar", "oak", "maple"];
delete trees[3];
console.log(3 in trees); // false

Dies erzeugt ein lückenhaftes Array mit einem leeren Slot. Wenn Sie möchten, dass ein Array-Element existiert, aber einen undefinierten Wert hat, verwenden Sie den Wert undefined anstelle des delete Operators. Im folgenden Beispiel wird trees[3] der Wert undefined zugewiesen, aber das Array-Element existiert weiterhin:

const trees = ["redwood", "bay", "cedar", "oak", "maple"];
trees[3] = undefined;
console.log(3 in trees); // true

Wenn Sie stattdessen ein Array-Element entfernen möchten, indem Sie den Inhalt des Arrays ändern, verwenden Sie die Methode splice(). Im folgenden Beispiel wird trees[3] vollständig aus dem Array entfernt, indem die splice() Methode verwendet wird:

const trees = ["redwood", "bay", "cedar", "oak", "maple"];
trees.splice(3, 1);
console.log(trees); // ["redwood", "bay", "cedar", "maple"]

Wenn eine Eigenschaft als nicht konfigurierbar markiert ist, hat delete keinen Effekt und gibt false zurück. Im strikten Modus wird dies einen TypeError auslösen.

const Employee = {};
Object.defineProperty(Employee, "name", { configurable: false });

console.log(delete Employee.name); // returns false

var erstellt nicht konfigurierbare Eigenschaften, die nicht mit dem delete Operator gelöscht werden können:

// Since "nameOther" is added using with the
// var keyword, it is marked as non-configurable
var nameOther = "XYZ";

// We can access this global property using:
Object.getOwnPropertyDescriptor(globalThis, "nameOther");
// {
//   value: "XYZ",
//   writable: true,
//   enumerable: true,
//   configurable: false
// }

delete globalThis.nameOther; // return false

Im strikten Modus würde dies eine Ausnahme auslösen.

Wenn eine globale Eigenschaft konfigurierbar ist (zum Beispiel durch direkte Eigenschaften-Zuweisung), kann sie gelöscht werden und nachfolgende Referenzen auf sie als globale Variablen werden einen ReferenceError erzeugen.

globalThis.globalVar = 1;
console.log(globalVar); // 1
// In non-strict mode, you can use `delete globalVar` as well
delete globalThis.globalVar;
console.log(globalVar); // ReferenceError: globalVar is not defined

• Detaillierte Analyse zu delete
• Reflect.deleteProperty()
• Map.prototype.delete()