Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Reflect.ownKeys — tutte le chiavi proprie

Reflect.ownKeys(target) richiede un oggetto. Per un oggetto ordinario restituisce un array con tutte le chiavi proprie: stringhe e simboli, comprese le chiavi delle proprietà non enumerabili. Esclude le proprietà ereditate. La trappola ownKeys di un Proxy può cambiare le chiavi restituite.

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.ownKeys(target)

Reflect.ownKeys(target) crea un nuovo array di chiavi. Se target è un oggetto ordinario, l’array contiene le chiavi di tutte le sue proprietà proprie, sia enumerabili sia non enumerabili. Gli elementi sono stringhe o simboli, non i valori delle proprietà. Non esplora la catena dei prototipi. Un argomento che non è un oggetto, compresi null e una stringa, causa un TypeError; non viene convertito automaticamente in oggetto.

Per gli oggetti ordinari, vengono prima le chiavi che sono indici di array, in ordine numerico crescente; seguono le altre stringhe nell’ordine di creazione delle proprietà e infine i simboli nell’ordine di creazione delle proprietà corrispondenti. Quindi "2" precede "10" anche se le chiavi sono state aggiunte nell’ordine opposto; restano comunque stringhe.

Al contrario, Object.keys restituisce solo chiavi stringa enumerabili. Object.getOwnPropertyNames include le chiavi proprie di tipo stringa, mentre Object.getOwnPropertySymbols include i simboli propri. Usa Reflect.ownKeys quando ti servono entrambi i tipi di chiavi senza filtrarli in base all’enumerabilità.

Il metodo richiama l’operazione interna [[OwnPropertyKeys]]. Con un Proxy, può attivare la trappola ownKeys: può quindi eseguire codice dell’utente, generare un’eccezione o restituire le chiavi in un ordine consentito diverso da quello di un oggetto ordinario. La trappola può anche cambiare l’insieme delle chiavi restituite: se l’oggetto bersaglio del proxy è estensibile, può omettere chiavi di proprietà proprie configurabili o riportare chiavi aggiuntive per le quali l’oggetto bersaglio non ha un descrittore di proprietà propria. Deve includere le chiavi delle proprietà proprie non configurabili. Se l’oggetto bersaglio non è estensibile, l’insieme restituito deve coincidere esattamente con quello delle sue chiavi proprie. Non presumere che ogni oggetto esotico segua l’ordine ordinario. Questa è un’API del linguaggio ECMAScript; la sola presenza di Node 24 in un repository non dimostra il supporto nel browser di destinazione.

Esempi

const tag = Symbol("tag");
const target = Object.create({ inherited: true });
target["10"] = "ten";
target["2"] = "two";
target.name = "Ada";
Object.defineProperty(target, "hidden", { value: 42 });
target[tag] = "metadata";

const keys = Reflect.ownKeys(target);
console.log(keys.map(key => String(key)).join(" | "));
console.log(keys[keys.length - 1] === tag);

Risultato

2 | 10 | name | hidden | Symbol(tag)
true

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