CKTIS / JavaScript
Reflect.set — affectation de propriété avec un résultat booléen
Reflect.set effectue une opération d’affectation de propriété et renvoie un booléen indiquant si elle a réussi. Son argument receiver facultatif permet de distinguer l’objet où commence la recherche de propriété de celui qui reçoit l’écriture.
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.set(target, key, value[, receiver])Reflect.set(target, key, value[, receiver]) invoque l’opération interne [[Set]] de l’objet target. L’argument key est converti en clé de propriété : une chaîne ou un symbole. Si receiver est omis, sa valeur par défaut est target.
Le résultat est true ou false, et non la valeur affectée. Pour les objets ordinaires, false peut indiquer, par exemple, une tentative de modifier une propriété avec writable: false, d’utiliser un accesseur sans setter ou d’ajouter une propriété à un récepteur non extensible. À lui seul, un résultat false ne déclenche pas d’exception, même en mode strict, contrairement à une affectation rejetée target[key] = value dans ce mode.
La recherche du descripteur commence à target et peut parcourir ses prototypes. Pour une propriété de données inscriptible, l’écriture crée ou met généralement à jour une propriété propre de receiver, sous réserve des restrictions de celui-ci. Lors de l’appel d’un setter, receiver est transmis comme argument this. Si le setter est une fonction JavaScript ordinaire en mode non strict, son this prend la valeur globale de this à la place de null ou de undefined, et les autres valeurs primitives sont converties en objets enveloppes. La valeur renvoyée par le setter est ignorée. Par conséquent, true ne garantit pas qu’une lecture ultérieure renverra value.
Cette méthode ne sert pas à intercepter les erreurs : un target qui n’est pas un objet provoque un TypeError, et les exceptions issues de la conversion de clé, d’un setter ou d’un piège Proxy sont propagées. Définir directement une propriété propre ne parcourt pas la chaîne de prototypes et n’appelle pas les setters hérités, mais les restrictions du descripteur d’une propriété propre existante s’appliquent toujours. Par exemple, cette opération ne peut pas modifier la valeur d’une propriété de données propre qui n’est ni configurable ni inscriptible.
Exemples
"use strict";
const target = { score: 1 };
const receiver = {};
console.log(Reflect.set(target, "score", 7, receiver));
console.log(target.score, receiver.score);
Object.defineProperty(target, "fixed", {
value: 10,
writable: false
});
console.log(Reflect.set(target, "fixed", 20));
console.log(target.fixed);Résultat
true 1 7 false 10
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.