Class PropMap

constructor

• new PropMap(props?): PropMap

• Constructor.

  Parameters

  • Optional props: object | PropMap | Map<string, any>

    the initial properties; if a PropMap instance is provided, the properties of that object will be copied into this one; otherwise the object will be used directly to hold property values

  Returns PropMap

Readonly props

size

• get size(): number

• Get the number of properties configured.

  Returns number

[iterator]

• [iterator](): IterableIterator<[string, any]>

• Get an iterator over the property entries.

  Returns IterableIterator<[string, any]>

  iterator over [k, v] values

prop

• prop(key): any

• Get a property value.

  Parameters

  • key: string

    the key to get

  Returns any

  the associated value for the given key
• prop(key, newValue): PropMap

• Set or remove a property value.

  Parameters

  • key: string

    the key to set the value for

  • newValue: any

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

  Returns PropMap

  this object

properties

• properties(): Record<string, any>

• Get all properties.

  Returns Record<string, any>

  all properties of this object copied into a simple object
• properties(newProps): PropMap

• Set or remove multiple properties.

  Parameters

  • newProps: object | Map<string, any>

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

  Returns PropMap

  this object

toUriEncoding

• toUriEncoding(propertyName?, callbackFn?): string

• 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. Any Util.Enum values will have their name property used.

  Parameters

  • Optional propertyName: string

    an optional object property prefix to add to all properties

  • Optional callbackFn: PropMapUriEncodingCallbackFn

    An optional function that will be called for each property. The function will be passed property name and value arguments, and must return either undefined to skip the property, a 2 or 3-element array with the property name and value to use, and an optional boolean to force array values to use mutliple parameter keys. Any other return value causes the property to be used as-is.

  Returns string

  the URI encoded string

toUriEncodingWithSorting

• toUriEncodingWithSorting(sorts?, pagination?, propertyName?, callbackFn?): string

• Get this object as a standard URI encoded (query parameters) string value with sorting and pagination parameters.

  This calls Util.PropMap.toUriEncoding first, then encodes the sorts and pagination parameters, if provided.

  Parameters

  • Optional sorts: SortDescriptor[]

    optional sort settings to use

  • Optional pagination: Pagination

    optional pagination settings to use

  • Optional propertyName: string

    an optional object property prefix to add to all properties

  • Optional callbackFn: PropMapUriEncodingCallbackFn

    An optional function that will be called for each property. The function will be passed property name and value arguments, and must return either undefined 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 string

  the URI encoded string