CKTIS / JavaScript
Object.entries: coppie chiave–valore proprie
Object.entries restituisce un nuovo array di coppie per le proprietà proprie enumerabili con chiavi stringa.
Versione: ECMAScript 2017 onward; example target: Node.js 24.22.2
Sintassi
Object.entries(value)Object.entries(value) esegue prima ToObject: null e undefined generano TypeError, mentre le altre primitive vengono sottoposte a boxing. Una stringa produce quindi coppie per gli indici enumerabili dei caratteri. Il risultato è un nuovo array di array [key, value], con chiavi stringa.
Sono incluse solo proprietà proprie enumerabili con chiavi stringa. Chiavi simbolo, proprietà ereditate e non enumerabili sono escluse. L’ordine segue OwnPropertyKeys: gli indici di array crescono numericamente, mentre le altre chiavi stringa mantengono l’ordine di creazione.
Il metodo esiste da ECMAScript 2017. Prima viene fotografato l’elenco delle chiavi, ma per ciascuna il metodo ricontrolla il descrittore proprio corrente e poi legge il valore. Getter e trap Proxy possono quindi modificare l’oggetto, eliminare chiavi successive o generare eccezioni; il risultato non è una fotografia atomica dei valori.
Esempi
const symbol = Symbol("skip");
const proto = { inherited: "skip" };
const record = Object.create(proto);
Object.defineProperty(record, "first", {
enumerable: true,
configurable: true,
get() { delete record.later; return "A"; }
});
record.later = "B";
record[2] = "two";
record[1] = "one";
Object.defineProperty(record, "hidden", { value: 0 });
record[symbol] = "symbol";
console.log(JSON.stringify(Object.entries(record)));
console.log(JSON.stringify(Object.entries("hi")));
try { Object.entries(null); } catch (error) { console.log(error.name); }Risultato
[["1","one"],["2","two"],["first","A"]] [["0","h"],["1","i"]] TypeError
L’esempio mostra ordine, esclusione di simboli ed ereditarietà e un getter che elimina una chiave successiva.