Namespace goog.object
code »Global Functions
Adds a key-value pair to the object. Throws an exception if the key is
already in use. Use set if you want to change an existing pair.
code »goog.object.clear ( obj )Removes all key value pairs from the object/map/hash.
Parameters |
---|
|
Does a flat clone of the object.
Parameters |
---|
|
Returns |
|
Whether the object/hash/map contains the given object as a value.
An alias for goog.object.containsValue(obj, val).
Parameters |
---|
|
Returns |
|
code »goog.object.containsKey ( obj, key ) ⇒ boolean
Whether the object/map/hash contains the given key.
boolean
Parameters |
---|
|
Returns |
|
Whether the object/map/hash contains the given value. This is O(n).
Parameters |
---|
|
Returns |
|
code »goog.object.create ( var_args ) ⇒ !Object
Creates a new object built from the key-value pairs provided as arguments.
!Object
Parameters |
---|
|
Returns |
|
Throws |
|
Creates an immutable view of the underlying object, if the browser
supports immutable objects.
In default mode, writes to this view will fail silently. In strict mode,
they will throw an error.
Parameters |
---|
|
Returns |
|
code »goog.object.createSet ( var_args ) ⇒ !Object
Creates a new object where the property names come from the arguments but
the value is always set to true
!Object
Parameters |
---|
|
Returns |
|
Calls a function for each element in an object/map/hash. If
all calls return true, returns true. If any call returns false, returns
false at this point and does not continue to check the remaining elements.
Parameters |
---|
Returns |
|
code »goog.object.extend ( target, var_args )Extends an object with another object.
This operates 'in-place'; it does not create a new Object.
Example:
var o = {};
goog.object.extend(o, {a: 0, b: 1});
o; // {a: 0, b: 1}
goog.object.extend(o, {c: 2});
o; // {a: 0, b: 1, c: 2}
Calls a function for each element in an object/map/hash. If that call returns
true, adds the element to a new object.
Parameters |
---|
|
Returns |
|
Searches an object for an element that satisfies the given condition and
returns its key.
Parameters |
---|
Returns |
|
Searches an object for an element that satisfies the given condition and
returns its value.
Parameters |
---|
Returns |
|
Calls a function for each element in an object/map/hash.
Parameters |
---|
Returns the value for the given key.
code »goog.object.getAnyKey ( obj ) ⇒ (string|undefined)
Returns one key from the object map, if any exists.
For map literals the returned key will be the first one in most of the
browsers (a know exception is Konqueror).
(string|undefined)
Parameters |
---|
|
Returns |
|
Returns one value from the object map, if any exists.
For map literals the returned value will be the first one in most of the
browsers (a know exception is Konqueror).
Parameters |
---|
|
Returns |
|
code »goog.object.getCount ( obj ) ⇒ number
Returns the number of key-value pairs in the object map.
number
Parameters |
---|
|
Returns |
|
code »goog.object.getKeys ( obj ) ⇒ !Array.<string>
Returns the keys of the object/map/hash.
!Array.<string>
Parameters |
---|
|
Returns |
|
code »goog.object.getValueByKeys ( obj, var_args ) ⇒ *
Get a value from an object multiple levels deep. This is useful for
pulling values from deeply nested objects, such as JSON responses.
Example usage: getValueByKeys(jsonObj, 'foo', 'entries', 3)
*
Parameters |
---|
Returns |
|
Returns the values of the object/map/hash.
Parameters |
---|
|
Returns |
|
code »goog.object.isEmpty ( obj ) ⇒ boolean
Whether the object/map/hash is empty.
boolean
Parameters |
---|
|
Returns |
|
code »goog.object.isImmutableView ( obj ) ⇒ boolean
boolean
Parameters |
---|
|
Returns |
|
For every element in an object/map/hash calls a function and inserts the
result into a new object.
Parameters |
---|
|
Returns |
|
code »goog.object.remove ( obj, key ) ⇒ boolean
Removes a key-value pair based on the key.
boolean
Parameters |
---|
|
Returns |
|
Adds a key-value pair to the object/map/hash.
Adds a key-value pair to the object/map/hash if it doesn't exist yet.
Calls a function for each element in an object/map/hash. If any
call returns true, returns true (without checking the rest). If
all calls return false, returns false.
Parameters |
---|
Returns |
|
code »goog.object.transpose ( obj ) ⇒ !Object
Returns a new object in which all the keys and values are interchanged
(keys become values and values become keys). If multiple keys map to the
same value, the chosen transposed value is implementation-dependent.
!Object
Parameters |
---|
|
Returns |
|
code »goog.object.unsafeClone ( obj ) ⇒ *
Clones a value. The input may be an Object, Array, or basic type. Objects and
arrays will be cloned recursively.
WARNINGS:
goog.object.unsafeClone
does not detect reference loops. Objects
that refer to themselves will cause infinite recursion.
goog.object.unsafeClone
is unaware of unique identifiers, and
copies UIDs created by getUid
into cloned results.
*
goog.object.unsafeClone
does not detect reference loops. Objects
that refer to themselves will cause infinite recursion.
goog.object.unsafeClone
is unaware of unique identifiers, and
copies UIDs created by getUid
into cloned results.Parameters |
---|
|
Returns |
|