Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Object.keys — chiavi proprie enumerabili di un oggetto

Object.keys(obj) restituisce un nuovo array con le chiavi proprie enumerabili di un oggetto, sotto forma di stringhe. Esclude le proprietà ereditate, quelle non enumerabili e le chiavi Symbol. Negli oggetti ordinari, le chiavi che sono indici di array precedono le altre chiavi stringa.

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.keys(obj)

Object.keys(obj) è un metodo statico di Object che restituisce un nuovo array di nomi di proprietà. Include solo proprietà proprie, cioè non ereditate da un prototipo, il cui attributo enumerable è true e la cui chiave è una stringa. Il risultato contiene stringhe anche quando le chiavi sono state scritte come numeri. Le chiavi Symbol sono escluse.

Negli oggetti ordinari, le chiavi che sono indici di array compaiono in ordine numerico crescente, seguite dalle altre chiavi stringa nell’ordine di creazione delle proprietà. Non si tratta né di un ordinamento alfabetico né di una regola valida per ogni stringa simile a un numero: "02" non è un indice di array. Gli oggetti Proxy possono influire sull’ordine ed eseguire codice durante l’enumerazione.

A differenza di for...in, il metodo esclude le proprietà enumerabili ereditate. Reflect.ownKeys(obj), invece, include anche le proprietà proprie non enumerabili e le chiavi Symbol. Object.keys non legge i valori delle proprietà e non ne invoca i getter; l’array restituito non si aggiorna quando l’oggetto cambia.

null e undefined causano un TypeError. Gli altri valori primitivi vengono convertiti in oggetti: Object.keys("ab") produce ["0","1"], mentre Object.keys(42) produce []. Questa è un’API del linguaggio ECMAScript, non un’API del browser; eseguire l’esempio in Node.js non dimostra la compatibilità con uno specifico browser.

Esempi

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

console.log(JSON.stringify(Object.keys(item)));

Risultato

["2","10","name"]

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