Object.keys()

Renvoie un tableau des noms des propriétés propres et énumérables d’un objet.

Renvoie
Un tableau de chaînes contenant les noms des propriétés.
Modifie l’original
Non
Sur cette page

Exemple

#
JavaScript
const user = { name: 'Léa', level: 7, premium: true }

console.log(Object.keys(user))
console.log(Object.keys(user).length)
console.log(Object.keys({}).length === 0)
Console
['name', 'level', 'premium']
3
true

Définition et utilisation

#

La méthode Object.keys() prend un objet et renvoie un tableau de chaînes contenant les noms de ses propriétés. Elle ne tient compte que des propriétés propres (non héritées) et énumérables.

Cela vous permet de parcourir un objet avec les méthodes de tableaux : compter ses champs, vérifier si un objet est vide, ou construire une liste d’options à partir des clés d’une configuration.

L’ordre des clés est prévisible : d’abord les clés qui ressemblent à des entiers (par ordre croissant), puis les autres chaînes dans leur ordre d’ajout.

Syntaxe

#
Syntaxe
Object.keys(obj)

Paramètres

#
  • obj

    objet

    L’objet dont vous voulez récupérer les clés.

Plus d’exemples

#
Ordre des clés numériques
JavaScript
const ranking = { 10: 'Lucas', 2: 'Léa', b: 'x', a: 'y' }
console.log(Object.keys(ranking))
Console
['2', '10', 'b', 'a']

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Vous pouvez détecter un objet vide avec Object.keys(obj).length === 0.
  • Si vous avez besoin à la fois des clés et des valeurs, utilisez Object.entries().

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.