Object.create Function (JavaScript)

Creates an object that has the specified prototype, and that optionally contains specified properties.

Syntax

Object.create(prototype, descriptors)  

Parameters

prototype
Required. The object to use as a prototype. May be null.

descriptors
Optional. A JavaScript object that contains one or more property descriptors.

A data property is a property that can get and set a value. A data property descriptor contains a value attribute, plus writable, enumerable, and configurable attributes. If the last three attributes are not specified, they default to false. An accessor property calls a user-provided function every time the value is retrieved or set. An accessor property descriptor contains a set attribute, a get attribute, or both. For more information, see Object.defineProperty Function.

Return Value

A new object that has the specified internal prototype and contains the specified properties, if any.

Exceptions

A TypeError exception is thrown if any of the following conditions is true:

  • The prototype argument is not an object and is not null.

  • A descriptor in the descriptors argument has a value or writable attribute, and has a get or set attribute.

  • A descriptor in the descriptors argument has a get or set attribute that is not a function.

Remarks

You can use this function using a null``prototype parameter in order to stop the prototype chain. The object created will have no prototype.

Example

The following example creates an object using a null prototype and adds two enumerable properties.

var newObj = Object.create(null, {  
            size: {  
                value: "large",  
                enumerable: true  
            },  
            shape: {  
                value: "round",  
                enumerable: true  
            }  
        });  

document.write(newObj.size + "<br/>");  
document.write(newObj.shape + "<br/>");  
document.write(Object.getPrototypeOf(newObj));  

// Output:  
// large  
// round  
// null  

Example

The following example creates an object that has the same internal prototype as the Object object. You can see that it has the same prototype as an object created by using an object literal. The Object.getPrototypeOf function gets the prototype of the original object. To get the object's property descriptor, you can use Object.getOwnPropertyDescriptor Function.

var firstLine = { x: undefined, y: undefined };  

var secondLine = Object.create(Object.prototype, {  
        x: {  
                value: undefined,   
                writable: true,   
                configurable: true,   
                enumerable: true  
            },  
            y: {  
                value: undefined,   
                writable: true,   
                configurable: true,   
                enumerable: true  
            }  
});  

document.write("first line prototype = " + Object.getPrototypeOf(firstLine));  
document.write("<br/>");  
document.write("second line prototype = " + Object.getPrototypeOf(secondLine));  

// Output:  
// first line prototype = [object Object]  
// second line prototype = [object Object]  

Example

The following example creates an object that has the same internal prototype as the Shape object.


// Create the shape object.  
var Shape = { twoDimensional: true, color: undefined, hasLineSegments: undefined };  

var Square = Object.create(Object.getPrototypeOf(Shape));  

Requirements

Supported in the following document modes: Internet Explorer 9 standards, Internet Explorer 10 standards, and Internet Explorer 11 standards. Also supported in Store apps (Windows 8 and Windows Phone 8.1). See Version Information.
Not supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards.

See Also

Object.getPrototypeOf Function
isPrototypeOf Method (Object)
Creating Objects