Object.getOwnPropertyDescriptor Function

Object.getOwnPropertyDescriptor Function (JavaScript)

 

Gets the own property descriptor of the specified object. An own property descriptor is one that is defined directly on the object and is not inherited from the object's prototype.

Object.getOwnPropertyDescriptor(object, propertyname)

object

Required. The object that contains the property.

propertyname

Required. The name of the property.

The descriptor of the property.

You can use the Object.getOwnPropertyDescriptor function to obtain a descriptor object that describes attributes of the property.

The Object.defineProperty Function (JavaScript) is used to add or modify properties.

The following example gets a data property descriptor and uses it to make the property read-only.

// Create a user-defined object.
var obj = {};

// Add a data property.
obj.newDataProperty = "abc";

// Get the property descriptor.
var descriptor = Object.getOwnPropertyDescriptor(obj, "newDataProperty");

// Change a property attribute.
descriptor.writable = false;
Object.defineProperty(obj, "newDataProperty", descriptor);

To list the property attributes, you can add the following code to this example.

// Get the descriptor from the object.
var desc2 = Object.getOwnPropertyDescriptor(obj, "newDataProperty");

// List the descriptor attributes.
for (var prop in desc2) {
    document.write(prop + ': ' + desc2[prop]);
    document.write("<br />");
}

// Output:
// value: abc
// writable: false
// enumerable: true
// configurable: true

Requirements

All features are supported in Internet Explorer 9 standards mode, Internet Explorer 10 standards mode, Internet Explorer 11 standards mode, and Windows Store apps.

Internet Explorer 8 standards mode supports DOM objects but not user-defined objects. The enumerable and configurable attributes can be specified, but they are not used.

Show:
© 2016 Microsoft