All Game Objects have a new boolean property called pendingDestroy.…

… If you set this to `true` then the object will automatically destroy itself in the *next* logic update, rather than immediately. This is useful for cases when you wish to destroy an object from within one of its own callbacks, such as with buttons or other input events (thanks @alamboley #1748)

README.md

@@ -328,6 +328,7 @@ Version 2.4 - "Katar" - in dev
 * BitmapData.moveH(distance) allows you to horizontally shift the BitmapData with wrap-around the edges.
 * BitmapData.moveV(distance) allows you to vertically shift the BitmapData with wrap-around the edges.
 * Text.addStrokeColor works in the same way as `Text.addColor` but allows you to define a color stop for the stroke color instead of the fill color.
+* All Game Objects have a new boolean property called `pendingDestroy`. If you set this to `true` then the object will automatically destroy itself in the *next* logic update, rather than immediately. This is useful for cases when you wish to destroy an object from within one of its own callbacks, such as with buttons or other input events (thanks @alamboley #1748)
 
 ### Updates
 

src/gameobjects/components/Core.js

@@ -90,6 +90,12 @@ Phaser.Component.Core.init = function (game, x, y, key, frame) {
 
 Phaser.Component.Core.preUpdate = function () {
 
+    if (this.pendingDestroy)
+    {
+        this.destroy();
+        return;
+    }
+
     this.previousPosition.set(this.world.x, this.world.y);
     this.previousRotation = this.rotation;
 
@@ -232,6 +238,15 @@ Phaser.Component.Core.prototype = {
     */
     fresh: true,
 
+    /**
+    * A Game Object is that is pendingDestroy is flagged to have its destroy method called on the next logic update.
+    * This is used internally by the likes of Buttons but you can also set it directly, to allow you to flag an
+    * object to be destroyed from within one of its own callbacks (such as a Button or Input event)
+    * 
+    * @property {boolean} pendingDestroy
+    */
+    pendingDestroy: false,
+
     /**
     * @property {Phaser.Rectangle} _bounds - Internal cache var.
     * @private

src/gameobjects/components/Destroy.js

@@ -30,7 +30,7 @@ Phaser.Component.Destroy.prototype = {
     * @method
     * @param {boolean} [destroyChildren=true] - Should every child of this object have its destroy method called as well?
     */
-    destroy: function(destroyChildren) {
+    destroy: function (destroyChildren) {
 
         if (this.game === null || this.destroyPhase) { return; }
 
@@ -138,6 +138,7 @@ Phaser.Component.Destroy.prototype = {
         this._destroyCachedSprite();
 
         this.destroyPhase = false;
+        this.pendingDestroy = false;
 
     }