Class: Map

Phaser.Structs. Map

The keys of a Map can be arbitrary values.

var map = new Map([
   [ 1, 'one' ],
   [ 2, 'two' ],
   [ 3, 'three' ]
]);

new Map(elements)

Parameters:
Name Type Description
elements Array.<*>

An optional array of key-value pairs to populate this Map with.

Since: 3.0.0
Source: src/structs/Map.js (Line 19)

Members


entries :Object.<string, *>

The entries in this Map.

Type:
  • Object.<string, *>
Since: 3.0.0
Default Value:
  • {}
Source: src/structs/Map.js (Line 48)

size :number

The number of key / value pairs in this Map.

Type:
  • number
Since: 3.0.0
Default Value:
  • 0
Source: src/structs/Map.js (Line 60)

Methods


clear()

Delete all entries from this Map.

Since: 3.0.0
Source: src/structs/Map.js (Line 190)
Returns:

This Map object.

Type
Phaser.Structs.Map

contains(value)

Returns true if the value exists within this Map. Otherwise, returns false.

Parameters:
Name Type Description
value *

The value to search for.

Since: 3.0.0
Source: src/structs/Map.js (Line 301)
Returns:

true if the value is found, otherwise false.

Type
boolean

delete(key)

Delete the specified element from this Map.

Parameters:
Name Type Description
key string

The key of the element to delete from this Map.

Since: 3.0.0
Source: src/structs/Map.js (Line 166)
Returns:

This Map object.

Type
Phaser.Structs.Map

dump()

Dumps the contents of this Map to the console via console.group.

Since: 3.0.0
Source: src/structs/Map.js (Line 251)

each(callback)

Passes all entries in this Map to the given callback.

Parameters:
Name Type Description
callback EachMapCallback

The callback which will receive the keys and entries held in this Map.

Since: 3.0.0
Source: src/structs/Map.js (Line 273)
Returns:

This Map object.

Type
Phaser.Structs.Map

get(key)

Returns the value associated to the key, or undefined if there is none.

Parameters:
Name Type Description
key string

The key of the element to return from the Map object.

Since: 3.0.0
Source: src/structs/Map.js (Line 105)
Returns:

The element associated with the specified key or undefined if the key can't be found in this Map object.

Type
*

getArray()

Returns an Array of all the values stored in this Map.

Since: 3.0.0
Source: src/structs/Map.js (Line 126)
Returns:

An array of the values stored in this Map.

Type
Array.<*>

has(key)

Returns a boolean indicating whether an element with the specified key exists or not.

Parameters:
Name Type Description
key string

The key of the element to test for presence of in this Map.

Since: 3.0.0
Source: src/structs/Map.js (Line 149)
Returns:

Returns true if an element with the specified key exists in this Map, otherwise false.

Type
boolean

keys()

Returns all entries keys in this Map.

Since: 3.0.0
Source: src/structs/Map.js (Line 213)
Returns:

Array containing entries' keys.

Type
Array.<string>

merge(map [, override])

Merges all new keys from the given Map into this one.
If it encounters a key that already exists it will be skipped unless override is set to true.

Parameters:
Name Type Argument Default Description
map Phaser.Structs.Map

The Map to merge in to this Map.

override boolean <optional>
false

Set to true to replace values in this Map with those from the source map, or false to skip them.

Since: 3.0.0
Source: src/structs/Map.js (Line 328)
Returns:

This Map object.

Type
Phaser.Structs.Map

set(key, value)

Adds an element with a specified key and value to this Map.

Parameters:
Name Type Description
key string

The key of the element to be added to this Map.

value *

The value of the element to be added to this Map.

Since: 3.0.0
Source: src/structs/Map.js (Line 79)
Returns:

This Map object.

Type
Phaser.Structs.Map

values()

Returns an Array of all entries.

Since: 3.0.0
Source: src/structs/Map.js (Line 228)
Returns:

An Array of entries.

Type
Array.<*>