delete

object

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

property

Die zu löschende Eigenschaft.

true für alle Fälle außer wenn die Eigenschaft eine eigene nicht konfigurierbare Eigenschaft ist, in welchem Fall false im Nicht-Strikt-Modus zurückgegeben wird.

TypeError

Wird im strengen 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 durch höherpriorisierte Operatoren gebildet wird. Allerdings führen die folgenden Formen im strengen Modus zu frühen Syntaxfehlern:

delete identifier;
delete object.#privateProperty;

Da Klassen automatisch im strengen Modus sind und private Eigenschaften nur legal in Klassenkörpern referenziert werden können, bedeutet dies, dass private Eigenschaften niemals gelöscht werden können. Während delete identifier funktionieren könnte, wenn identifier eine konfigurierbare Eigenschaft des globalen Objekts ist, sollten Sie diese Form vermeiden und sie 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 von einem Objekt. Bei erfolgreicher Löschung wird true zurückgegeben, andernfalls wird false zurückgegeben. Anders als oft angenommen (vielleicht aufgrund anderer Programmiersprachen wie delete in C++), hat der delete Operator nichts damit zu tun, direkt Speicher freizugeben. Speicherverwaltung erfolgt indirekt durch das Aufbrechen von Referenzen. Weitere Details finden Sie auf der Seite zur Speicherverwaltung.

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

• Wenn die Eigenschaft, die Sie löschen möchten, 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 Prototypkette des Objekts existiert, wird das Objekt nach der Löschung die Eigenschaft aus der Prototypkette verwenden.
• Nicht konfigurierbare Eigenschaften können nicht entfernt werden. Dies schließt Eigenschaften von eingebauten Objekten wie Math, Array, Object und Eigenschaften ein, die als nicht konfigurierbar mit Methoden wie Object.defineProperty() erstellt wurden.
• Das Löschen von Variablen, einschließlich Funktionsparametern, funktioniert nie. delete variable wird einen SyntaxError im strengen Modus werfen und hat im nicht-strengen Modus keine Wirkung.
  • Jede mit var deklarierte Variable kann weder aus dem globalen Scope noch aus dem Scope einer Funktion gelöscht werden, da sie, obwohl sie möglicherweise mit dem globalen Objekt verbunden sind, nicht konfigurierbar sind.
  • Jede mit let oder const deklarierte Variable kann nicht aus dem Scope gelöscht werden, in dem sie definiert wurde, da sie nicht mit einem Objekt verbunden sind.

Im folgenden Beispiel löschen wir eine eigene Eigenschaft eines Objekts, während eine Eigenschaft mit demselben Namen in der Prototypkette 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. 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 möchten, dass ein Array-Element existiert, aber einen undefinierten Wert hat, verwenden Sie stattdessen 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] mit splice() vollständig aus dem Array entfernt:

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 strengen 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 strengen Modus würde dies eine Ausnahme auslösen.

Wenn eine globale Eigenschaft konfigurierbar ist (zum Beispiel durch direkte Zuweisung der Eigenschaft), kann sie gelöscht werden, und nachfolgende Referenzen darauf 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

• Tiefgehende Analyse von delete
• Reflect.deleteProperty()
• Map.prototype.delete()