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 eigene nicht-konfigurierbare Eigenschaft ist, in welchem Fall false im nicht-strikten Modus zurückgegeben wird.

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 Priorität wie andere unäre Operatoren wie typeof. Daher akzeptiert er jeden Ausdruck, der mit Operatoren höherer Priorität gebildet wurde. Die folgenden Formen führen jedoch im strikten Modus zu frühen Syntaxfehlern:

delete identifier;
delete object.#privateProperty;

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

Während 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 aus einem Objekt. Bei erfolgreicher Löschung wird true zurückgegeben, andernfalls wird false zurückgegeben. Im Gegensatz zu dem, was gemeinhin angenommen wird (vielleicht aufgrund anderer Programmiersprachen wie delete in C++), hat der delete Operator nichts mit der direkten Freigabe von Speicher zu tun. Das Speichermanagement erfolgt indirekt über das Aufbrechen von Referenzen. Weitere Details finden Sie auf der Seite Speichermanagement.

Es ist wichtig, die folgenden Szenarien zu berücksichtigen:

• Wenn die Eigenschaft, die Sie zu löschen versuchen, nicht existiert, hat delete keine Wirkung und gibt true zurück.
• delete hat nur eine Wirkung auf eigene Eigenschaften. Wenn eine Eigenschaft mit demselben Namen in der Prototypenkette des Objekts existiert, verwendet das Objekt nach der Löschung die Eigenschaft der Prototypenkette.
• 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.
• Das Löschen von Variablen, einschließlich Funktionsparameter, funktioniert nie. delete variable führt im strikten Modus zu einem SyntaxError und hat im nicht-strikten Modus keine Wirkung.
  • Jede mit var deklarierte Variable kann nicht aus dem globalen Gültigkeitsbereich oder aus dem Gültigkeitsbereich einer Funktion gelöscht werden, weil sie, obwohl sie mit dem globalen Objekt verbunden sein können, nicht konfigurierbar sind.
  • Jede mit let oder const deklarierte Variable kann nicht aus dem Gültigkeitsbereich gelöscht werden, in dem sie definiert wurden, weil 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 length des Arrays nicht beeinflusst. Dies gilt auch, wenn Sie das letzte Element des Arrays löschen.

Wenn der delete Operator ein Array-Element entfernt, ist 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 dünn besetztes Array mit einem leeren Platz. Wenn Sie wollen, dass ein Array-Element existiert, aber einen undefinierten Wert hat, verwenden Sie anstelle des delete Operators den Wert undefined. 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 durch Ändern der Inhalte des Arrays entfernen möchten, verwenden Sie die Methode splice(). Im folgenden Beispiel wird trees[3] vollständig aus dem Array entfernt, indem splice() 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 keine Wirkung und gibt false zurück. Im strikten Modus wird dagegen ein TypeError ausgelöst.

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 (z.B. durch direkte Eigenschaftszuweisung), kann sie gelöscht werden, und nachfolgende Verweise auf sie als globale Variablen führen zu einem ReferenceError.

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 des delete Operators
• Reflect.deleteProperty()
• Map.prototype.delete()