CKTIS / JavaScript
Reflect.deleteProperty — eigenschappen verwijderen met een booleaans resultaat
Reflect.deleteProperty(target, propertyKey) probeert een eigen eigenschap van een object te verwijderen en geeft een booleaans resultaat terug. Bij een gewoon object geeft de methode ook true terug als de eigenschap ontbreekt, en false als deze configurable: false heeft.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Reflect.deleteProperty(target, propertyKey)Reflect.deleteProperty(target, propertyKey) roept de interne [[Delete]]-bewerking van het object aan. target moet een object zijn; een primitieve waarde, waaronder null, veroorzaakt een TypeError. propertyKey wordt omgezet in een eigenschapssleutel: een tekenreeks of een Symbol.
Bij een gewoon object verwijdert de methode een eigen eigenschap als het attribuut configurable de waarde true heeft. De methode geeft dan true terug; ook als er geen eigen eigenschap bestaat, geeft ze true terug. Een eigenschap met configurable: false blijft ongewijzigd en het resultaat is false. De methode verwijdert geen eigenschappen van het prototype: door een eigen eigenschap te verwijderen kan een geërfde eigenschap met dezelfde sleutel zichtbaar worden.
Anders dan delete target[propertyKey] in strict mode geeft de methode false terug, in plaats van alleen vanwege een geweigerde verwijdering een uitzondering te veroorzaken. Dat betekent niet dat de methode nooit uitzonderingen veroorzaakt: die kunnen ontstaan bij het omzetten van de sleutel of door een Proxy, waarvan de deleteProperty-trap de bewerking kan onderscheppen en aan de invarianten van de specificatie is gebonden.
Het voorbeeld laat het verwijderen zien, een ontbrekende eigenschap en een geweigerde verwijdering in strict mode. Dit is een functie uit de ECMAScript-standaardbibliotheek, geen Web-API. De specificatie alleen bewijst niet dat de functie in een bepaalde browserversie wordt ondersteund; de aanwezigheid van Node 24 in een repository bewijst dat evenmin.
Voorbeelden
"use strict";
const item = { temporary: 1 };
Object.defineProperty(item, "fixed", {
value: 2,
configurable: false
});
console.log(Reflect.deleteProperty(item, "temporary"));
console.log(Reflect.deleteProperty(item, "missing"));
console.log(Reflect.deleteProperty(item, "fixed"));
console.log(Object.prototype.hasOwnProperty.call(item, "temporary"));
console.log(item.fixed);Resultaat
true true false false 2
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.