Class: PropMap

util~ PropMap

A basic map-like object.


new PropMap(props)

Constructor.

Parameters:
Name Type Description
props object

the initial properties

Members


props :object

The object that all properties are stored on.

Type:
  • object

Methods


prop(key [, newValue])

Get, set, or remove a property value.

Parameters:
Name Type Argument Description
key string

the key to get or set the value for

newValue * <optional>

if defined, the new value to set for the given key; if null then the key property will be removed

Returns:

if called as a getter, the associated value for the given key, otherwise this object

Type
*

properties( [newProps])

Get, set, or remove multiple properties.

Parameters:
Name Type Argument Description
newProps object <optional>

the new values to set; if any value is null that property will be deleted

Returns:

if called as a getter, all properties of this object copied into a simple object; otherwise this object

Type
object

toUriEncoding( [propertyName] [, callbackFn])

Get this object as a standard URI encoded (query parameters) string value.

All enumerable properties of the props property will be added to the result. If any property value is an array, the values of the array will be joined by a comma.

Parameters:
Name Type Argument Description
propertyName string <optional>

an optional object property prefix to add to all properties

callbackFn function <optional>

An optional function that will be called for each property. The function will be passed property name and value arguments, and must return either null to skip the property, a 2-element array with the property name and value to use, or anything else to use the property as- is.

Returns:

the URI encoded string

Type
string