Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti