Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Reflect — operazioni esplicite sugli oggetti

Reflect fornisce metodi statici per leggere, scrivere e ispezionare gli oggetti. Il risultato booleano di una scrittura consente di verificare se l’operazione è riuscita, ma non significa che il metodo non possa mai generare un’eccezione.

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.get(target, key[, receiver])
Reflect.set(target, key, value[, receiver])
Reflect.defineProperty(target, key, descriptor)
Reflect.ownKeys(target)

Reflect è un oggetto integrato di ECMAScript, non una funzione né un costruttore: Reflect() e new Reflect() generano un TypeError. I suoi metodi espongono operazioni corrispondenti ai meccanismi interni degli oggetti.

Reflect.get legge una proprietà, mentre Reflect.set tenta di scriverla e restituisce un booleano, non il valore assegnato. In entrambi i metodi, il parametro facoltativo receiver è target per impostazione predefinita e determina il valore di this quando vengono invocati getter o setter. Reflect.ownKeys restituisce tutte le chiavi proprie di tipo stringa e simbolo, comprese quelle non enumerabili; esclude quelle ereditate.

Reflect.defineProperty restituisce false quando un oggetto rifiuta un descrittore valido, mentre in tale situazione Object.defineProperty genera un’eccezione. Un risultato booleano non garantisce l’assenza di eccezioni: possono causarle argomenti non validi e il codice di getter, setter o trappole Proxy. Le operazioni sulle proprietà richiedono che target sia un oggetto.

Nell’esempio, la proprietà non è enumerabile né scrivibile. Reflect.set restituisce false anche in modalità strict, il valore resta 10 e Reflect.ownKeys trova comunque la chiave.

Esempi

"use strict";
const target = {};
Reflect.defineProperty(target, "score", {
  value: 10,
  writable: false,
  enumerable: false,
  configurable: false
});
console.log(Reflect.get(target, "score"));
console.log(Reflect.set(target, "score", 20));
console.log(Reflect.ownKeys(target).join(","));
console.log(Reflect.get(target, "score"));

Risultato

10
false
score
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