Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Reflect.set — assegnazione di proprietà con risultato booleano

Reflect.set esegue un’operazione di assegnazione di proprietà e restituisce un booleano che ne indica l’esito. Il receiver opzionale permette di distinguere l’oggetto da cui inizia la ricerca della proprietà da quello che riceve la scrittura.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

Reflect.set(target, key, value[, receiver])

Reflect.set(target, key, value[, receiver]) invoca l’operazione interna [[Set]] dell’oggetto target. L’argomento key viene convertito in una chiave di proprietà: una stringa o un simbolo. Se receiver viene omesso, il suo valore predefinito è target.

Il risultato è true o false, non il valore assegnato. Per gli oggetti ordinari, false può indicare, per esempio, un tentativo di modificare una proprietà con writable: false, di usare un accessor senza setter o di aggiungere una proprietà a un ricevente non estensibile. Un risultato false, da solo, non genera un’eccezione nemmeno in modalità strict, a differenza di un’assegnazione rifiutata target[key] = value in tale modalità.

La ricerca del descrittore parte da target e può attraversarne i prototipi. Per una proprietà dati scrivibile, la scrittura in genere crea o aggiorna una proprietà propria di receiver, nel rispetto delle sue restrizioni. Quando viene chiamato un setter, receiver viene passato come argomento this. Se il setter è una funzione JavaScript ordinaria in modalità non strict, il suo this assume il valore globale di this al posto di null o undefined, mentre gli altri valori primitivi vengono racchiusi in oggetti wrapper. Il valore restituito dal setter viene ignorato. Di conseguenza, true non garantisce che una lettura successiva restituisca value.

Il metodo non è un meccanismo per intercettare gli errori: un target che non è un oggetto causa un TypeError, e le eccezioni dovute alla conversione della chiave, a un setter o a una trap di Proxy vengono propagate. Quando si definisce direttamente una proprietà propria, non si percorre la catena dei prototipi e non si chiamano i setter ereditati, ma si rispettano comunque i vincoli del descrittore di una proprietà propria già esistente. Per esempio, non si può modificare il valore di una proprietà dati propria che non è né configurabile né scrivibile.

Esempi

"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);

Risultato

true
1 7
false
10

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti