setText updates

BitmapText.setText will check if the value given is falsey but not a zero and set to an empty string if so.
BitmapText.setText will now cast the given value to a string before setting.
BitmapText.setText will not change the text via `setText` unless the new text is different to the old one.

Author: photonstorm

CHANGELOG.md

@@ -11,6 +11,10 @@
 ### Updates
 
 * AnimationComponent.play now calls `setSizeToFrame()` and `updateDisplayOrigin()` on the parent Game Object in order to catch situations where you've started playing an animation on a Game Object that uses a different size to the previously set frame.
+* Text.setText will check if the value given is falsey but not a zero and set to an empty string if so.
+* BitmapText.setText will check if the value given is falsey but not a zero and set to an empty string if so.
+* BitmapText.setText will now cast the given value to a string before setting.
+* BitmapText.setText will not change the text via `setText` unless the new text is different to the old one.
 
 ## Version 3.1.2 - 23rd February 2018
 

src/gameobjects/bitmaptext/dynamic/DynamicBitmapText.js

@@ -226,18 +226,26 @@ var DynamicBitmapText = new Class({
      * @method Phaser.GameObjects.DynamicBitmapText#setText
      * @since 3.0.0
      *
-     * @param {string|string[]} text - [description]
+     * @param {string|string[]} value - The string, or array of strings, to be set as the content of this BitmapText.
      *
      * @return {Phaser.GameObjects.DynamicBitmapText} This Game Object.
      */
     setText: function (value)
     {
+        if (!value && value !== 0)
+        {
+            value = '';
+        }
+
         if (Array.isArray(value))
         {
             value = value.join('\n');
         }
 
-        this.text = value;
+        if (value !== this.text)
+        {
+            this.text = value.toString();
+        }
 
         return this;
     },

src/gameobjects/bitmaptext/static/BitmapText.js

@@ -145,18 +145,26 @@ var BitmapText = new Class({
      * @method Phaser.GameObjects.BitmapText#setText
      * @since 3.0.0
      *
-     * @param {string|string[]} text - [description]
+     * @param {string|string[]} value - The string, or array of strings, to be set as the content of this BitmapText.
      *
      * @return {Phaser.GameObjects.BitmapText} This Game Object.
      */
     setText: function (value)
     {
+        if (!value && value !== 0)
+        {
+            value = '';
+        }
+
         if (Array.isArray(value))
         {
             value = value.join('\n');
         }
 
-        this.text = value;
+        if (value !== this.text)
+        {
+            this.text = value.toString();
+        }
 
         return this;
     },