Phaser.Sound will now automatically check the Cache to see if the audio file it is using is still there or not. If not then it will automatically called Sound.destroy on itself. If you do not desire this result then you should ensure that you undertake all house-keeping yourself, and properly destroy Sound objects _before_ calling Cache.removeSound (phaserjs#1946)

Author: photonstorm

README.md

@@ -257,6 +257,7 @@ If you are an exceptional JavaScript developer and would like to join the Phaser
 * Cache.getFrameByIndex has a new `cache` parameter (that defaults to the Image cache, but can be changed to any other)
 * Cache.getFrameByName has a new `cache` parameter (that defaults to the Image cache, but can be changed to any other)
 * Device.canPlayVideo now checks for `ogv` as a valid file extension for OGG video files (thanks @JB-Tellez #1928)
+* Phaser.Sound will now automatically check the Cache to see if the audio file it is using is still there or not. If not then it will automatically called `Sound.destroy` on itself. If you do not desire this result then you should ensure that you undertake all house-keeping yourself, and properly destroy Sound objects _before_ calling `Cache.removeSound` (#1946)
 
 
 ### Bug Fixes

src/loader/Cache.js

@@ -1708,6 +1708,10 @@ Phaser.Cache.prototype = {
     /**
     * Removes a sound from the cache.
     *
+    * If any `Phaser.Sound` objects use the audio file in the cache that you remove with this method, they will
+    * _automatically_ destroy themselves. If you wish to have full control over when Sounds are destroyed then
+    * you must finish your house-keeping and destroy them all yourself first, before calling this method.
+    *
     * Note that this only removes it from the Phaser.Cache. If you still have references to the data elsewhere
     * then it will persist in memory.
     *

src/sound/Sound.js

@@ -404,6 +404,12 @@ Phaser.Sound.prototype = {
     */
     update: function () {
 
+        if (!this.game.cache.checkSoundKey(this.key))
+        {
+            this.destroy();
+            return;
+        }
+
         if (this.isDecoded && !this._onDecodedEventDispatched)
         {
             this.onDecoded.dispatch(this);