Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources