propertyDescriptorIn

Return a property descriptor for an object's own or inherited property.

Usage

var propertyDescriptorIn = require( '@stdlib/utils/property-descriptor-in' );

propertyDescriptorIn( obj, property )

Returns a property descriptor for an object's own or inherited property.

var obj = {
    'a': 1,
    'b': 2
};

var desc = propertyDescriptorIn( obj, 'a' );
// returns {'configurable':true,'enumerable':true,'writable':true,'value':1}

Notes

This function differs from the built-in Object.getOwnPropertyDescriptor() as follows:
- If provided null or undefined, the function returns null, rather than throwing an error.
- If an object does not have a provided property, the function returns null, rather than undefined.

Examples

var defineProperty = require( '@stdlib/utils/define-property' );
var propertyDescriptorIn = require( '@stdlib/utils/property-descriptor-in' );

function Foo() {
    this.beep = 'boop';
    this.a = {
        'b': 'c'
    };
    defineProperty( this, 'baz', {
        'value': 'qux',
        'configurable': true,
        'writable': true,
        'enumerable': false
    });
    return this;
}

Foo.prototype.foo = [ 'bar' ];

var obj = new Foo();
var desc = propertyDescriptorIn( obj, 'foo' );

console.log( desc );
// => {'configurable':true,'enumerable':true,'writable':true,'value':['bar']}