JavaScript Object Properties
Property Management Methods
// Adding or changing an object property
Object.defineProperty(object, property, descriptor)
// Adding or changing object properties
Object.defineProperties(object, descriptors)
// Accessing a Property
Object.getOwnPropertyDescriptor(object, property)
// Accessing Properties
Object.getOwnPropertyDescriptors(object)
// Returns all properties as an array
Object.getOwnPropertyNames(object)
// Accessing the prototype
Object.getPrototypeOf(object)
JavaScript Object.defineProperty()
The Object.defineProperty()
method can be used to:
- Adding a new property to an object
- Changing property values
- Changing property metadata
- Changing object getters and setters
Syntax:
Object.defineProperty(object, property, descriptor)
Adding a new Property
This example adds a new property to an object:
Example
// Create an Object:
const person = {
firstName: "John",
lastName :
"Doe",
language : "EN"
};
// Add a Property
Object.defineProperty(person, "year",
{value:"2008"});
Try it Yourself »
Changing a Property Value
This example changes a property value:
Example
// Create an Object:
const person = {
firstName: "John",
lastName : "Doe",
language : "EN"
};
// Change a Property
Object.defineProperty(person, "language",
{value : "NO"});
Try it Yourself »
Property Attributes
All properties have a name. In addition they also have a value.
The value is one of the property's attributes.
Other attributes are: enumerable, configurable, and writable.
These attributes define how the property can be accessed (is it readable?, is it writable?)
In JavaScript, all attributes can be read, but only the value attribute can be changed (and only if the property is writable).
( ECMAScript 5 has methods for both getting and setting all property attributes)
Changing Meta Data
The following property meta data can be changed:
writable : true // Property value can be changed
enumerable : true // Property can be enumerated
configurable : true // Property can be reconfigured
writable : false // Property value can not be changed
enumerable : false // Property can be not enumerated
configurable : false // Property can be not reconfigured
Getters and setters can also be changed:
// Defining a getter
get: function() { return language }
// Defining a setter
set: function(value) { language = value }
This example makes language read-only:
Object.defineProperty(person, "language", {writable:false});
This example makes language not enumerable:
Object.defineProperty(person, "language", {enumerable:false});
JavaScript getOwnPropertyNames()
The Object.getOwnPropertyNames()
method can:
- List object properties
Syntax
Object.getOwnPropertyNames(object)
List all Object Properties
This example gets all properties of an object:
Example
// Create an Object
const person = {
firstName: "John",
lastName : "Doe",
language : "EN"
};
// Get all Properties
Object.getOwnPropertyNames(person);
Try it Yourself »
Object.getOwnPropertyNames()
will also list properties that is not enumerable:
Example
// Create an Object
const person = {
firstName: "John",
lastName : "Doe",
language : "EN"
};
// Set the language Property not enumerable
Object.defineProperty(person, "language", {enumerable:false});
// Get all Properties
Object.getOwnPropertyNames(person);
Try it Yourself »
JavaScript Object.keys()
The Object.keys()
method can:
- List enumerable object properties
Syntax
Object.keys(object)
List Enumerable Object Properties
This example uses Object.keys()
insted of Object.getOwnPropertyNames()
:
Example
// Create an Object
const person = {
firstName: "John",
lastName : "Doe",
language : "EN"
};
// Change the "language" Property
Object.defineProperty(person, "language", {enumerable:false});
// Get all Enumerable Properties
Object.keys(person);
Try it Yourself »
Note
The getOwnPropertyNames() method returns all properties.
The Object.keys() method returns all enumerable properties.
If you define object properties without enumerable:false, the two methods will return the same.
Adding Getters and Setters
The Object.defineProperty()
method can also be used to add Getters and
Setters:
Example
//Create an object
const person = {firstName:"John", lastName:"Doe"};
// Define a getter
Object.defineProperty(person, "fullName", {
get:
function () {return this.firstName + " " + this.lastName;}
});
Try it Yourself »
A Counter Example
Example
// Define object
const obj = {counter:0};
// Define setters
Object.defineProperty(obj, "reset", {
get : function () {this.counter = 0;}
});
Object.defineProperty(obj, "increment", {
get : function () {this.counter++;}
});
Object.defineProperty(obj, "decrement", {
get : function () {this.counter--;}
});
Object.defineProperty(obj, "add", {
set : function (value) {this.counter += value;}
});
Object.defineProperty(obj, "subtract", {
set : function (i) {this.counter -= i;}
});
// Play with the counter:
obj.reset;
obj.add = 5;
obj.subtract = 1;
obj.increment;
obj.decrement;
Try it Yourself »
Prototype Properties
JavaScript objects inherit the properties of their prototype.
The delete
keyword does not delete inherited properties, but if you delete a
prototype property, it will affect all objects
inherited from the prototype.
Complete Object Reference
For a complete reference, go to our:
Complete JavaScript Object Reference.
The reference contains descriptions and examples of all Object Properties and Methods.