CKTIS / JavaScript
Object.values — valori delle proprietà proprie di un oggetto
Object.values(obj) restituisce un nuovo array con i valori delle proprietà proprie ed enumerabili che hanno chiavi stringa. Esclude le proprietà ereditate o non enumerabili e le chiavi Symbol.
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
Object.values(obj)Object.values(obj) è un metodo statico: chiamalo su Object, non sull’oggetto che stai esaminando. Restituisce un nuovo array che contiene solo i valori delle proprietà proprie ed enumerabili con chiavi stringa. Non restituisce le chiavi né le coppie chiave-valore. Esclude le proprietà ereditate, quelle non enumerabili e quelle con chiavi Symbol.
Negli oggetti ordinari, le chiavi che sono indici di array vengono elaborate per prime in ordine numerico crescente; le altre chiavi stringa seguono nell’ordine in cui sono state create le proprietà. Non si tratta né di un ordinamento dei valori né di un ordinamento alfabetico delle chiavi. Nell’esempio, la chiave 2 precede 10, ed entrambe precedono label.
L’argomento viene convertito in un oggetto. null e undefined generano un TypeError; una stringa espone proprietà indicizzate enumerabili, quindi Object.values("abc") produce ["a","b","c"]. I normali valori primitivi numerici e booleani non hanno proprietà proprie enumerabili e quindi producono [].
Un nuovo array non equivale a una copia profonda: le voci il cui valore è un oggetto restano riferimenti agli stessi oggetti. La lettura dei valori attiva i getter, che possono avere effetti collaterali o generare eccezioni. Il metodo in sé non modifica le proprietà dell’oggetto di origine, ma il codice eseguito durante le letture può cambiarle.
Esempi
const record = Object.create({ inherited: "ignored" });
record.label = "item";
record[10] = "ten";
record[2] = "two";
Object.defineProperty(record, "hidden", { value: "ignored" });
record[Symbol("secret")] = "ignored";
console.log(JSON.stringify(Object.values(record)));Risultato
["two","ten","item"]
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.