jQuery: The Write Less, Do More JavaScript Library

Utilities/jQuery.extend

From jQuery JavaScript Library

Jump to: navigation, search

« Back to Utilities

jQuery.extend( target, object1, [objectN] )

Extend one object with one or more others, returning the original, modified, object.
This is a great utility for simple inheritance.
Arguments:

targetObject
The object to extend.
object1Object
The object that will be merged into the first.
objectN (Optional)Object
More objects to merge into the first.

Examples:
Merge settings and options, modifying settings.

var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
jQuery.extend(settings, options);

settings == { validate: true, limit: 5, name: "bar" }

Merge defaults and options, without modifying the defaults.

var empty = {}
var defaults = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
var settings = $.extend(empty, defaults, options);

settings == { validate: true, limit: 5, name: "bar" }
empty == { validate: true, limit: 5, name: "bar" }

NameType