NOOP

staticNOOP()

Description:

A NOOP (No Operation) callback function.

Used internally by Phaser when it's more expensive to determine if a callback exists

than it is to just invoke an empty function.

Source: src/utils/NOOP.js#L7
Since: 3.0.0

NULL

staticNULL()

Description:

A NULL OP callback function.

This function always returns null.

Used internally by Phaser when it's more expensive to determine if a callback exists

than it is to just invoke an empty function.

Source: src/utils/NULL.js#L7
Since: 3.60.0

Phaser.Utils.Array

Add

staticAdd(array, item, [limit], [callback], [context])

Description:

Adds the given item, or array of items, to the array.

Each item must be unique within the array.

The array is modified in-place and returned.

You can optionally specify a limit to the maximum size of the array. If the quantity of items being

added will take the array length over this limit, it will stop adding once the limit is reached.

You can optionally specify a callback to be invoked for each item successfully added to the array.

Parameters:

Returns: array - The input array.

Source: src/utils/array/Add.js#L7
Since: 3.4.0

AddAt

staticAddAt(array, item, [index], [limit], [callback], [context])

Description:

Adds the given item, or array of items, to the array starting at the index specified.

Each item must be unique within the array.

Existing elements in the array are shifted up.

The array is modified in-place and returned.

You can optionally specify a limit to the maximum size of the array. If the quantity of items being

added will take the array length over this limit, it will stop adding once the limit is reached.

You can optionally specify a callback to be invoked for each item successfully added to the array.

Parameters:

Returns: array - The input array.

Source: src/utils/array/AddAt.js#L7
Since: 3.4.0

BringToTop

staticBringToTop(array, item)

Description:

Moves the given element to the top of the array.

The array is modified in-place.

Parameters:

Returns: * - The element that was moved.

Source: src/utils/array/BringToTop.js#L7
Since: 3.4.0

CountAllMatching

staticCountAllMatching(array, property, value, [startIndex], [endIndex])

Description:

Returns the total number of elements in the array which have a property matching the given value.

Parameters:

Returns: number - The total number of elements with properties matching the given value.

Source: src/utils/array/CountAllMatching.js#L9
Since: 3.4.0

Each

staticEach(array, callback, context, [args])

Description:

Passes each element in the array to the given callback.

Parameters:

Returns: array - The input array.

Source: src/utils/array/Each.js#L7
Since: 3.4.0

EachInRange

staticEachInRange(array, callback, context, startIndex, endIndex, [args])

Description:

Passes each element in the array, between the start and end indexes, to the given callback.

Parameters:

Returns: array - The input array.

Source: src/utils/array/EachInRange.js#L9
Since: 3.4.0

FindClosestInSorted

staticFindClosestInSorted(value, array, [key])

Description:

Searches a pre-sorted array for the closet value to the given number.

If the key argument is given it will assume the array contains objects that all have the required key property name,

and will check for the closest value of those to the given number.

Parameters:

Returns: number, any - The nearest value found in the array, or if a key was given, the nearest object with the matching property value.

Source: src/utils/array/FindClosestInSorted.js#L7
Since: 3.0.0

Flatten

staticFlatten(array, [output])

Description:

Takes an array and flattens it, returning a shallow-copy flattened array.

Parameters:

Returns: array - The flattened output array.

Source: src/utils/array/Flatten.js#L7
Since: 3.60.0

GetAll

staticGetAll(array, [property], [value], [startIndex], [endIndex])

Description:

Returns all elements in the array.

You can optionally specify a matching criteria using the property and value arguments.

For example: getAll('visible', true) would return only elements that have their visible property set.

Optionally you can specify a start and end index. For example if the array had 100 elements,

and you set startIndex to 0 and endIndex to 50, it would return matches from only

the first 50 elements.

Parameters:

Returns: array - All matching elements from the array.

Source: src/utils/array/GetAll.js#L9
Since: 3.4.0

GetFirst

staticGetFirst(array, [property], [value], [startIndex], [endIndex])

Description:

Returns the first element in the array.

You can optionally specify a matching criteria using the property and value arguments.

For example: getAll('visible', true) would return the first element that had its visible property set.

Optionally you can specify a start and end index. For example if the array had 100 elements,

and you set startIndex to 0 and endIndex to 50, it would search only the first 50 elements.

You can also specify a negative startIndex, such as -1, which would start the search at the end of the array

Parameters:

Returns: object - The first matching element from the array, or null if no element could be found in the range given.

Source: src/utils/array/GetFirst.js#L9
Since: 3.4.0

GetRandom

staticGetRandom(array, [startIndex], [length])

Description:

Returns a Random element from the array.

Tags:

• generic
• genericUse
• genericUse

Parameters:

Returns: T - A random element from the array, or null if no element could be found in the range given.

Source: src/utils/array/GetRandom.js#L7
Since: 3.0.0

MoveAbove

staticMoveAbove(array, item1, item2)

Description:

Moves the given array element above another one in the array.

If the given element is already above the other, it isn't moved.

Above means toward the end of the array.

The array is modified in-place.

Parameters:

Returns: array - The input array.

Source: src/utils/array/MoveAbove.js#L7
Since: 3.55.0

MoveBelow

staticMoveBelow(array, item1, item2)

Description:

Moves the given array element below another one in the array.

If the given element is already below the other, it isn't moved.

Below means toward the start of the array.

The array is modified in-place.

Parameters:

Returns: array - The input array.

Source: src/utils/array/MoveBelow.js#L7
Since: 3.55.0

MoveDown

staticMoveDown(array, item)

Description:

Moves the given array element down one place in the array.

The array is modified in-place.

Parameters:

Returns: array - The input array.

Source: src/utils/array/MoveDown.js#L7
Since: 3.4.0

MoveTo

staticMoveTo(array, item, index)

Description:

Moves an element in an array to a new position within the same array.

The array is modified in-place.

Parameters:

Returns: * - The element that was moved.

Source: src/utils/array/MoveTo.js#L7
Since: 3.4.0

MoveUp

staticMoveUp(array, item)

Description:

Moves the given array element up one place in the array.

The array is modified in-place.

Parameters:

Returns: array - The input array.

Source: src/utils/array/MoveUp.js#L7
Since: 3.4.0

NumberArray

staticNumberArray(start, end, [prefix], [suffix])

Description:

Create an array representing the range of numbers (usually integers), between, and inclusive of,

the given start and end arguments. For example:

var array = Phaser.Utils.Array.NumberArray(2, 4); // array = [2, 3, 4]

var array = Phaser.Utils.Array.NumberArray(0, 9); // array = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]

var array = Phaser.Utils.Array.NumberArray(8, 2); // array = [8, 7, 6, 5, 4, 3, 2]

This is equivalent to Phaser.Utils.Array.NumberArrayStep(start, end, 1).

You can optionally provide a prefix and / or suffix string. If given the array will contain

strings, not integers. For example:

var array = Phaser.Utils.Array.NumberArray(1, 4, 'Level '); // array = ["Level 1", "Level 2", "Level 3", "Level 4"]

var array = Phaser.Utils.Array.NumberArray(5, 7, 'HD-', '.png'); // array = ["HD-5.png", "HD-6.png", "HD-7.png"]

Parameters:

Returns: Array.<number>, Array.<string> - The array of number values, or strings if a prefix or suffix was provided.

Source: src/utils/array/NumberArray.js#L7
Since: 3.0.0

NumberArrayStep

staticNumberArrayStep([start], [end], [step])

Description:

Create an array of numbers (positive and/or negative) progressing from start

up to but not including end by advancing by step.

If start is less than end a zero-length range is created unless a negative step is specified.

Certain values for start and end (eg. NaN/undefined/null) are currently coerced to 0;

for forward compatibility make sure to pass in actual numbers.

Parameters:

Returns: Array.<number> - The array of number values.

Source: src/utils/array/NumberArrayStep.js#L9
Since: 3.0.0

QuickSelect

staticQuickSelect(arr, k, [left], [right], [compare])

Description:

A Floyd-Rivest quick selection algorithm.

Rearranges the array items so that all items in the [left, k] range are smaller than all items in [k, right];

The k-th element will have the (k - left + 1)th smallest value in [left, right].

The array is modified in-place.

Based on code by Vladimir Agafonkin

Parameters:

Source: src/utils/array/QuickSelect.js#L25
Since: 3.0.0

Range

staticRange(a, b, [options])

Description:

Creates an array populated with a range of values, based on the given arguments and configuration object.

Range ([a,b,c], [1,2,3]) =

a1, a2, a3, b1, b2, b3, c1, c2, c3

Range ([a,b], [1,2,3], qty = 3) =

a1, a1, a1, a2, a2, a2, a3, a3, a3, b1, b1, b1, b2, b2, b2, b3, b3, b3

Range ([a,b,c], [1,2,3], repeat x1) =

a1, a2, a3, b1, b2, b3, c1, c2, c3, a1, a2, a3, b1, b2, b3, c1, c2, c3

Range ([a,b], [1,2], repeat -1 = endless, max = 14) =

Maybe if max is set then repeat goes to -1 automatically?

a1, a2, b1, b2, a1, a2, b1, b2, a1, a2, b1, b2, a1, a2 (capped at 14 elements)

Range ([a], [1,2,3,4,5], random = true) =

a4, a1, a5, a2, a3

Range ([a, b], [1,2,3], random = true) =

b3, a2, a1, b1, a3, b2

Range ([a, b, c], [1,2,3], randomB = true) =

a3, a1, a2, b2, b3, b1, c1, c3, c2

Range ([a], [1,2,3,4,5], yoyo = true) =

a1, a2, a3, a4, a5, a5, a4, a3, a2, a1

Range ([a, b], [1,2,3], yoyo = true) =

a1, a2, a3, b1, b2, b3, b3, b2, b1, a3, a2, a1

Parameters:

Returns: array - An array of arranged elements.

Source: src/utils/array/Range.js#L28
Since: 3.0.0

Remove

staticRemove(array, item, [callback], [context])

Description:

Removes the given item, or array of items, from the array.

The array is modified in-place.

You can optionally specify a callback to be invoked for each item successfully removed from the array.

Parameters:

Returns: , Array.<> - The item, or array of items, that were successfully removed from the array.

Source: src/utils/array/Remove.js#L9
Since: 3.4.0

RemoveAt

staticRemoveAt(array, index, [callback], [context])

Description:

Removes the item from the given position in the array.

The array is modified in-place.

You can optionally specify a callback to be invoked for the item if it is successfully removed from the array.

Parameters:

Returns: * - The item that was removed.

Source: src/utils/array/RemoveAt.js#L9
Since: 3.4.0

RemoveBetween

staticRemoveBetween(array, startIndex, endIndex, [callback], [context])

Description:

Removes the item within the given range in the array.

The array is modified in-place.

You can optionally specify a callback to be invoked for the item/s successfully removed from the array.

Parameters:

Returns: Array.<*> - An array of items that were removed.

Source: src/utils/array/RemoveBetween.js#L9
Since: 3.4.0

RemoveRandomElement

staticRemoveRandomElement(array, [start], [length])

Description:

Removes a random object from the given array and returns it.

Will return null if there are no array items that fall within the specified range or if there is no item for the randomly chosen index.

Parameters:

Returns: object - The random element that was removed, or null if there were no array elements that fell within the given range.

Source: src/utils/array/RemoveRandomElement.js#L9
Since: 3.0.0

Replace

staticReplace(array, oldChild, newChild)

Description:

Replaces an element of the array with the new element.

The new element cannot already be a member of the array.

The array is modified in-place.

Parameters:

Returns: boolean - Returns true if the oldChild was successfully replaced, otherwise returns false.

Source: src/utils/array/Replace.js#L7
Since: 3.4.0

RotateLeft

staticRotateLeft(array, [total])

Description:

Moves the element at the start of the array to the end, shifting all items in the process.

The "rotation" happens to the left.

Parameters:

Returns: * - The most recently shifted element.

Source: src/utils/array/RotateLeft.js#L7
Since: 3.0.0

RotateRight

staticRotateRight(array, [total])

Description:

Moves the element at the end of the array to the start, shifting all items in the process.

The "rotation" happens to the right.

Parameters:

Returns: * - The most recently shifted element.

Source: src/utils/array/RotateRight.js#L7
Since: 3.0.0

SafeRange

staticSafeRange(array, startIndex, endIndex, [throwError])

Description:

Tests if the start and end indexes are a safe range for the given array.

Parameters:

Returns: boolean - True if the range is safe, otherwise false.

Source: src/utils/array/SafeRange.js#L7
Since: 3.4.0

SendToBack

staticSendToBack(array, item)

Description:

Moves the given element to the bottom of the array.

The array is modified in-place.

Parameters:

Returns: * - The element that was moved.

Source: src/utils/array/SendToBack.js#L7
Since: 3.4.0

SetAll

staticSetAll(array, property, value, [startIndex], [endIndex])

Description:

Scans the array for elements with the given property. If found, the property is set to the value.

For example: SetAll('visible', true) would set all elements that have a visible property to false.

Optionally you can specify a start and end index. For example if the array had 100 elements,

and you set startIndex to 0 and endIndex to 50, it would update only the first 50 elements.

Parameters:

Returns: array - The input array.

Source: src/utils/array/SetAll.js#L9
Since: 3.4.0

Shuffle

staticShuffle(array)

Description:

Shuffles the contents of the given array using the Fisher-Yates implementation.

The original array is modified directly and returned.

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<T> - The shuffled array.

Source: src/utils/array/Shuffle.js#L7
Since: 3.0.0

SortByDigits

staticSortByDigits(array)

Description:

Takes the given array and runs a numeric sort on it, ignoring any non-digits that

may be in the entries.

You should only run this on arrays containing strings.

Parameters:

Returns: Array.<string> - The sorted input array.

Source: src/utils/array/SortByDigits.js#L7
Since: 3.50.0

SpliceOne

staticSpliceOne(array, index)

Description:

Removes a single item from an array and returns it without creating gc, like the native splice does.

Based on code by Mike Reinstein.

Parameters:

Returns: * - The item which was spliced (removed).

Source: src/utils/array/SpliceOne.js#L7
Since: 3.0.0

StableSort

staticStableSort(array, [compare])

Description:

An in-place stable array sort, because Array#sort() is not guaranteed stable.

This is an implementation of merge sort, without recursion.

Function based on the Two-Screen/stable sort 0.1.8 from https://github.com/Two-Screen/stable

Parameters:

Returns: array - The sorted result.

Source: src/utils/array/StableSort.js#L142
Since: 3.0.0

Swap

staticSwap(array, item1, item2)

Description:

Swaps the position of two elements in the given array.

The elements must exist in the same array.

The array is modified in-place.

Parameters:

Returns: array - The input array.

Source: src/utils/array/Swap.js#L7
Since: 3.4.0

Phaser.Utils.Array.Matrix

CheckMatrix

staticCheckMatrix([matrix])

Description:

Checks if an array can be used as a matrix.

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: boolean - true if the given matrix array is a valid matrix.

Source: src/utils/array/matrix/CheckMatrix.js#L7
Since: 3.0.0

MatrixToString

staticMatrixToString([matrix])

Description:

Generates a string (which you can pass to console.log) from the given Array Matrix.

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: string - A string representing the matrix.

Source: src/utils/array/matrix/MatrixToString.js#L10
Since: 3.0.0

ReverseColumns

staticReverseColumns([matrix])

Description:

Reverses the columns in the given Array Matrix.

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<Array.<T>> - The column reversed matrix.

Source: src/utils/array/matrix/ReverseColumns.js#L7
Since: 3.0.0

ReverseRows

staticReverseRows([matrix])

Description:

Reverses the rows in the given Array Matrix.

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<Array.<T>> - The column reversed matrix.

Source: src/utils/array/matrix/ReverseRows.js#L7
Since: 3.0.0

Rotate180

staticRotate180([matrix])

Description:

Rotates the array matrix 180 degrees.

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<Array.<T>> - The rotated matrix array. The source matrix should be discard for the returned matrix.

Source: src/utils/array/matrix/Rotate180.js#L9
Since: 3.0.0

RotateLeft

staticRotateLeft([matrix], [amount])

Description:

Rotates the array matrix to the left (or 90 degrees)

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<Array.<T>> - The rotated matrix array. The source matrix should be discard for the returned matrix.

Source: src/utils/array/matrix/RotateLeft.js#L9
Since: 3.0.0

RotateMatrix

staticRotateMatrix([matrix], [direction])

Description:

Rotates the array matrix based on the given rotation value.

The value can be given in degrees: 90, -90, 270, -270 or 180,

or a string command: rotateLeft, rotateRight or rotate180.

Based on the routine from http://jsfiddle.net/MrPolywhirl/NH42z/.

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<Array.<T>> - The rotated matrix array. The source matrix should be discard for the returned matrix.

Source: src/utils/array/matrix/RotateMatrix.js#L10
Since: 3.0.0

RotateRight

staticRotateRight([matrix], [amount])

Description:

Rotates the array matrix to the left (or -90 degrees)

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<Array.<T>> - The rotated matrix array. The source matrix should be discard for the returned matrix.

Source: src/utils/array/matrix/RotateRight.js#L9
Since: 3.0.0

Translate

staticTranslate([matrix], [x], [y])

Description:

Translates the given Array Matrix by shifting each column and row the

amount specified.

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<Array.<T>> - The translated matrix.

Source: src/utils/array/matrix/TranslateMatrix.js#L10
Since: 3.50.0

TransposeMatrix

staticTransposeMatrix([array])

Description:

Transposes the elements of the given matrix (array of arrays).

The transpose of a matrix is a new matrix whose rows are the columns of the original.

A matrix is a two-dimensional array (array of arrays), where all sub-arrays (rows)

have the same length. There must be at least two rows. This is an example matrix:

[

   [ 1, 1, 1, 1, 1, 1 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 2, 0, 1, 2, 0, 4 ],

   [ 2, 0, 3, 4, 0, 4 ],

   [ 2, 0, 0, 0, 0, 4 ],

   [ 3, 3, 3, 3, 3, 3 ]

]

Tags:

• generic
• genericUse

Parameters:

Returns: Array.<Array.<T>> - A new array matrix which is a transposed version of the given array.

Source: src/utils/array/matrix/TransposeMatrix.js#L7
Since: 3.0.0

Phaser.Utils.Base64

ArrayBufferToBase64

staticArrayBufferToBase64(arrayBuffer, [mediaType])

Description:

Converts an ArrayBuffer into a base64 string.

The resulting string can optionally be a data uri if the mediaType argument is provided.

See https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs for more details.

Parameters:

Returns: string - The base64 encoded Array Buffer.

Source: src/utils/base64/ArrayBufferToBase64.js#L10
Since: 3.18.0

Base64ToArrayBuffer

staticBase64ToArrayBuffer(base64)

Description:

Converts a base64 string, either with or without a data uri, into an Array Buffer.

Parameters:

Returns: ArrayBuffer - An ArrayBuffer decoded from the base64 data.

Source: src/utils/base64/Base64ToArrayBuffer.js#L18
Since: 3.18.0

Phaser.Utils.Objects

Clone

staticClone(obj)

Description:

Shallow Object Clone. Will not clone nested objects.

Parameters:

Returns: object - A new object with the same properties as the input object.

Source: src/utils/object/Clone.js#L7
Since: 3.0.0

DeepCopy

staticDeepCopy(obj)

Description:

Deep Copy the given object or array.

Parameters:

Returns: object - A deep copy of the original object.

Source: src/utils/object/DeepCopy.js#L7
Since: 3.50.0

Extend

staticExtend([args])

Description:

This is a slightly modified version of http://api.jquery.com/jQuery.extend/

Parameters:

Returns: object - The extended object.

Source: src/utils/object/Extend.js#L13
Since: 3.0.0

GetAdvancedValue

staticGetAdvancedValue(source, key, defaultValue)

Description:

Retrieves a value from an object. Allows for more advanced selection options, including:

Allowed types:

Explicit:

{

x: 4

}

From function

{

x: function ()

}

Randomly pick one element from the array

{

x: [a, b, c, d, e, f]

}

Random integer between min and max:

{

x: { randInt: [min, max] }

}

Random float between min and max:

{

x: { randFloat: [min, max] }

}

Parameters:

Returns: * - The value of the requested key.

Source: src/utils/object/GetAdvancedValue.js#L10
Since: 3.0.0

GetFastValue

staticGetFastValue(source, key, [defaultValue])

Description:

Finds the key within the top level of the source object, or returns defaultValue

Parameters:

Returns: * - The value if found; otherwise, defaultValue (null if none provided)

Source: src/utils/object/GetFastValue.js#L7
Since: 3.0.0

GetMinMaxValue

staticGetMinMaxValue(source, key, min, max, defaultValue)

Description:

Retrieves and clamps a numerical value from an object.

Parameters:

Returns: number - The clamped value from the source object.

Source: src/utils/object/GetMinMaxValue.js#L10
Since: 3.0.0

GetValue

staticGetValue(source, key, defaultValue, [altSource])

Description:

Retrieves a value from an object, or an alternative object, falling to a back-up default value if not found.

The key is a string, which can be split based on the use of the period character.

For example:

const source = {

  lives: 3,

  render: {

    screen: {

      width: 1024

    }

  }

}



const lives = GetValue(source, 'lives', 1);

const width = GetValue(source, 'render.screen.width', 800);

const height = GetValue(source, 'render.screen.height', 600);

In the code above, lives will be 3 because it's defined at the top level of source.

The width value will be 1024 because it can be found inside the render.screen object.

The height value will be 600, the default value, because it is missing from the render.screen object.

Parameters:

Returns: * - The value of the requested key.

Source: src/utils/object/GetValue.js#L7
Since: 3.0.0

HasAll

staticHasAll(source, keys)

Description:

Verifies that an object contains all requested keys

Parameters:

Returns: boolean - true if the source object contains all keys, false otherwise.

Source: src/utils/object/HasAll.js#L7
Since: 3.0.0

HasAny

staticHasAny(source, keys)

Description:

Verifies that an object contains at least one of the requested keys

Parameters:

Returns: boolean - true if the source object contains at least one of the keys, false otherwise

Source: src/utils/object/HasAny.js#L7
Since: 3.0.0

HasValue

staticHasValue(source, key)

Description:

Determine whether the source object has a property with the specified key.

Parameters:

Returns: boolean - true if the provided key exists on the source object, otherwise false.

Source: src/utils/object/HasValue.js#L7
Since: 3.0.0

IsPlainObject

staticIsPlainObject(obj)

Description:

This is a slightly modified version of jQuery.isPlainObject.

A plain object is an object whose internal class property is [object Object].

Parameters:

Returns: boolean - true if the object is plain, otherwise false.

Source: src/utils/object/IsPlainObject.js#L7
Since: 3.0.0

Merge

staticMerge(obj1, obj2)

Description:

Creates a new Object using all values from obj1 and obj2.

If a value exists in both obj1 and obj2, the value in obj1 is used.

This is only a shallow copy. Deeply nested objects are not cloned, so be sure to only use this

function on shallow objects.

Parameters:

Returns: object - A new object containing the union of obj1's and obj2's properties.

Source: src/utils/object/Merge.js#L9
Since: 3.0.0

MergeRight

staticMergeRight(obj1, obj2)

Description:

Creates a new Object using all values from obj1.

Then scans obj2. If a property is found in obj2 that also exists in obj1, the value from obj2 is used, otherwise the property is skipped.

Parameters:

Returns: object - The merged object. obj1 and obj2 are not modified.

Source: src/utils/object/MergeRight.js#L9
Since: 3.0.0

Pick

staticPick(object, keys)

Description:

Returns a new object that only contains the keys that were found on the object provided.

If no keys are found, an empty object is returned.

Parameters:

Returns: object - A new object that only contains the keys that were found on the provided object. If no keys were found, an empty object will be returned.

Source: src/utils/object/Pick.js#L9
Since: 3.18.0

SetValue

staticSetValue(source, key, value)

Description:

Sets a value in an object, allowing for dot notation to control the depth of the property.

For example:

var data = {

  world: {

    position: {

      x: 200,

      y: 100

    }

  }

};



SetValue(data, 'world.position.y', 300);



console.log(data.world.position.y); // 300

Parameters:

Returns: boolean - true if the property key was valid and the value was set, otherwise false.

Source: src/utils/object/SetValue.js#L7
Since: 3.17.0

Phaser.Utils.String

Format

staticFormat(string, values)

Description:

Takes a string and replaces instances of markers with values in the given array.

The markers take the form of %1, %2, etc. I.e.:

Format("The %1 is worth %2 gold", [ 'Sword', 500 ])

Parameters:

Returns: string - The string containing replaced values.

Source: src/utils/string/Format.js#L7
Since: 3.0.0

Pad

staticPad(str, [len], [pad], [dir])

Description:

Takes the given string and pads it out, to the length required, using the character

specified. For example if you need a string to be 6 characters long, you can call:

pad('bob', 6, '-', 2)

This would return: bob--- as it has padded it out to 6 characters, using the - on the right.

You can also use it to pad numbers (they are always returned as strings):

pad(512, 6, '0', 1)

Would return: 000512 with the string padded to the left.

If you don't specify a direction it'll pad to both sides:

pad('c64', 7, '*')

Would return: **c64**

Parameters:

Returns: string - The padded string.

Source: src/utils/string/Pad.js#L7
Since: 3.0.0

RemoveAt

staticRemoveAt(string, index)

Description:

Takes a string and removes the character at the given index.

The index is zero based.

Parameters:

Returns: string - The modified string.

Source: src/utils/string/RemoveAt.js#L7
Since: 3.50.0

Reverse

staticReverse(string)

Description:

Takes the given string and reverses it, returning the reversed string.

For example if given the string Atari 520ST it would return TS025 iratA.

Parameters:

Returns: string - The reversed string.

Source: src/utils/string/Reverse.js#L7
Since: 3.0.0

UUID

staticUUID()

Description:

Creates and returns an RFC4122 version 4 compliant UUID.

The string is in the form: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx where each x is replaced with a random

hexadecimal digit from 0 to f, and y is replaced with a random hexadecimal digit from 8 to b.

Returns: string - The UUID string.

Source: src/utils/string/UUID.js#L7
Since: 3.12.0

UppercaseFirst

staticUppercaseFirst(str)

Description:

Capitalizes the first letter of a string if there is one.

Parameters:

Returns: string - A new string, same as the first, but with the first letter capitalized.

Source: src/utils/string/UppercaseFirst.js#L7
Since: 3.0.0