JavaScript property enumerability

JavaScript, Object · Sep 11, 2022

In most cases, object properties are enumerable by default, unless they are Symbols. This means that you can use the for...in loop to iterate over the properties of an object. Similarly, enumerable properties appear in object methods that enumerate the properties of an object. An example of this is the Object.keys() method, which will omit properties that are not enumerable. Finally, when using the object spread operator (...), only enumerable properties are copied to the new object.

const person = {
  name: 'John',
  surname: 'Doe',
  age: 30,
  socialSecurityNumber: '123-45-6789',
};

Object.defineProperty(person, 'socialSecurityNumber', {
  enumerable: false,
});

person.hasOwnProperty('socialSecurityNumber'); // true
person.propertyIsEnumerable('socialSecurityNumber'); // false

Object.keys(person); // ['name', 'surname', 'age']
Object.getOwnPropertyNames(person);
// ['name', 'surname', 'age', 'socialSecurityNumber']

const clone = { ...person };
clone.socialSecurityNumber; // undefined

To create a non-enumerable property, you can use Object.defineProperty() with the appropriate descriptor. You can check for the property's existence, using Object.prototype.hasOwnProperty() and for its enumerability, using Object.prototype.propertyIsEnumerable(). Additionally, in contrast to Symbols, non-enumerable properties will show up when using Object.getOwnPropertyNames().

Written by Angelos Chalaris

I'm Angelos Chalaris, a JavaScript software engineer, based in Athens, Greece. The best snippets from my coding adventures are published here to help others learn to code.

If you want to keep in touch, follow me on GitHub or Twitter.

More like this