N-R > new |  |

new

new, constructor

Availability

Flash Player 5.

Usage

    new constructor()

Parameters

`constructor` A function followed by any optional parameters in parentheses. The function is usually the name of the object type (for example, Array, Number, or Object) to be constructed.

Returns

Nothing.

Description

Operator; creates a new, initially anonymous, object and calls the function identified by the `constructor` parameter. The `new` operator passes to the function any optional parameters in parentheses, as well as the newly created object, which is referenced using the keyword `this`. The constructor function can then use `this` to set the variables of the object.

The `prototype` property of the constructor function is copied into the `__proto__` property of the new object. As a result, the new object supports all of the methods and properties specified in the Prototype object of the constructor function.

Example

The following example creates the `Book` function and then uses the `new` operator to create the objects `book1` and `book2`.

    function Book(name, price){
    	this.name = name;
    	this.price = price;
    }

    book1 = new Book("Confederacy of Dunces", 19.95);
    book2 = new Book("The Floating Opera", 10.95);

Example

The following example uses the new operator to create an instance of the Array object with 18 elements:

    golfCourse = new Array(18);

See also

`[] (array access)`, `{} (object initializer)`

The constructor method section within each object entry.