CKTIS / JavaScript
Reflect.deleteProperty — supprimer des propriétés avec un résultat booléen
Reflect.deleteProperty(target, propertyKey) tente de supprimer une propriété propre d’un objet et renvoie un résultat booléen. Pour un objet ordinaire, la méthode renvoie true même si la propriété est absente, et false si elle a configurable: false.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Reflect.deleteProperty(target, propertyKey)Reflect.deleteProperty(target, propertyKey) appelle l’opération interne [[Delete]] de l’objet. target doit être un objet ; une valeur primitive, y compris null, provoque une TypeError. propertyKey est converti en clé de propriété : une chaîne ou un Symbol.
Pour un objet ordinaire, la méthode supprime une propriété propre si son attribut configurable vaut true. Elle renvoie alors true ; elle renvoie également true si aucune propriété propre n’existe. Une propriété avec configurable: false reste inchangée et le résultat est false. La méthode ne supprime pas les propriétés du prototype : la suppression d’une propriété propre peut rendre visible une propriété héritée portant la même clé.
Contrairement à delete target[propertyKey] en mode strict, la méthode renvoie false au lieu de déclencher une exception uniquement parce que la suppression a été refusée. Cela ne signifie pas qu’elle ne déclenche jamais d’exception : celles-ci peuvent provenir de la conversion de la clé ou d’un Proxy, dont le piège deleteProperty peut intercepter l’opération et reste soumis aux invariants de la spécification.
L’exemple montre la suppression d’une propriété, l’absence d’une propriété et le refus d’une suppression en mode strict. Il s’agit d’une fonction de la bibliothèque standard ECMAScript, et non d’une API Web. La spécification seule ne prouve pas la prise en charge dans une version précise d’un navigateur ; la présence de Node 24 dans un dépôt ne le prouve pas non plus.
Exemples
"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);Résultat
true true false false 2
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.