new

The new operator lets you create an instance of a user-defined object type or of one of the built-in object types that has a constructor function.

Syntax

objectName = new objectType (param1 [,param2] ...[,paramN])

Arguments

objectName—Name of the new object instance.

objectType—Must be a function that defines an object type.

param1...paramN—Property values for the object. These properties are parameters defined for the objecType function.

Description

Creating a user-defined object type requires two steps:

To define an object type, create a function for the object type that specifies its name, properties, and methods. An object can have a property that is itself another object. See the examples that follow.

You can always add a property to a previously defined object. For example, the statement car1.color = "black" adds a property color to car1, and assigns it a value of black. However, this does not affect any other objects. To add the new property to all objects of the same type, you must add the property to the definition of the car object type.

You can add a property to a previously defined object type by using the Function.prototype property. This defines a property that is shared by all objects created with that function, rather than by just one instance of the object type. The following code adds a color property to all objects of type car, and then assigns a value to the color property of the object car1.

Car.prototype.color=null
car1.color="black"
birthday.description="The day you were born"

Examples

Example1: object type and object instance. Suppose you want to create an object type for cars. You want this type of object to be called car, and you want it to have properties for make, model, and year. To do this, you would write the following function:

function car(make, model, year) {
  this.make = make
  this.model = model
  this.year = year
}

Now you can create an object called mycar as follows:

mycar = new car("Eagle", "Talon TSi", 1993)

This statement creates mycar and assigns it the specified values for its properties. Then the value of mycar.make is the string “Eagle,” mycar.year is the integer 1993, and so on.

You can create any number of car objects by calls to new. For example,

kenscar = new car("Nissan", "300ZX", 1992)

Example2: object property that is itself another object. Suppose you define an object called person as follows:

function person(name, age, sex) {
  this.name = name
  this.age = age
  this.sex = sex
}

And then instantiate two new person objects as follows:

rand = new person("Rand McNally", 33, "M")
ken = new person("Ken Jones", 39, "M")

Then you can rewrite the definition of car to include an owner property that takes a person object, as follows:

function car(make, model, year, owner) {
  this.make = make; 
  this.model = model;
  this.year = year;
  this.owner = owner;
}

To instantiate the new objects, you then use the following:

car1 = new car("Eagle", "Talon TSi", 1993, rand);
car2 = new car("Nissan", "300ZX", 1992, ken)

Instead of passing a literal string or integer value when creating the new objects, the above statements pass the objects rand and ken as the parameters for the owners. To find out the name of the owner of car2, you can access the following property:

car2.owner.name