Re-throw runtime errors when failing to parse 3D Tiles content.

CHANGES.md

@@ -9,6 +9,7 @@ Change Log
 * Improved CZML Custom Properties sandcastle example [#6086](https://github.com/AnalyticalGraphicsInc/cesium/pull/6086)
 * Added `Plane.projectPointOntoPlane` for projecting a `Cartesian3` position onto a `Plane` [#6092](https://github.com/AnalyticalGraphicsInc/cesium/pull/6092) 
 * Added `Cartesian3.projectVector` for projecting one vector to another [#6093](https://github.com/AnalyticalGraphicsInc/cesium/pull/6093) 
+* Added `Cesium3DTileset.tileFailed` event that will be raised when a tile fails to load. The object passed to the event listener will have a url and message property. If there are no event listeners, error messages will be logged to the console. [#6088](https://github.com/AnalyticalGraphicsInc/cesium/pull/6088)
 
 ### 1.41 - 2018-01-02
 

Source/Scene/Cesium3DTileset.js

@@ -408,6 +408,23 @@ define([
          */
         this.tileUnload = new Event();
 
+        /**
+         * The event fired to indicate that a tile's content failed to load.
+         * <p>
+         * If there are no event listeners, error messages will be logged to the console.
+         * </p>
+         *
+         * @type {Event}
+         * @default new Event()
+         *
+         * @example
+         * tileset.tileFailed.addEventListener(function(error) {
+         *     console.log('An error occurred loading tile: ' + error.url);
+         *     console.log('Error: ' + error.message);
+         * });
+         */
+        this.tileFailed = new Event();
+
         /**
          * This event fires once for each visible tile in a frame.  This can be used to manually
          * style a tileset.
@@ -1261,7 +1278,20 @@ define([
         tile.contentReadyPromise.then(function() {
             removeFunction();
             tileset.tileLoad.raiseEvent(tile);
-        }).otherwise(removeFunction);
+        }).otherwise(function(error) {
+            removeFunction();
+            var url = tile._contentUrl;
+            var message = defined(error.message) ? error.message : error.toString();
+            if (tileset.tileFailed.numberOfListeners > 0) {
+                tileset.tileFailed.raiseEvent({
+                    url : url,
+                    message : message
+                });
+            } else {
+                console.log('A 3D tile failed to load: ' + url);
+                console.log('Error: ' + message);
+            }
+        });
     }
 
     function requestTiles(tileset, outOfCore) {

Specs/Data/Cesium3DTiles/Tilesets/TilesetInvalid/tileset.json

@@ -0,0 +1,52 @@
+{
+  "asset": {
+    "version": "1.0",
+    "tilesetVersion": "1.2.3"
+  },
+  "properties": {
+    "id": {
+      "minimum": 0,
+      "maximum": 9
+    },
+    "Longitude": {
+      "minimum": -1.3197192952275933,
+      "maximum": -1.319644104024109
+    },
+    "Latitude": {
+      "minimum": 0.698848878034009,
+      "maximum": 0.6989046192460953
+    },
+    "Height": {
+      "minimum": 6.161747192963958,
+      "maximum": 84.83180232718587
+    }
+  },
+  "geometricError": 240,
+  "root": {
+    "boundingVolume": {
+      "region": [
+        -1.3197209591796106,
+        0.6988424218,
+        -1.3196390408203893,
+        0.6989055782,
+        0,
+        88
+      ]
+    },
+    "geometricError": 70,
+    "refine": "ADD",
+    "content": {
+      "url": "does_not_exist.b3dm",
+      "boundingVolume": {
+        "region": [
+          -1.3197004795898053,
+          0.6988582109,
+          -1.3196595204101946,
+          0.6988897891,
+          0,
+          88
+        ]
+      }
+    }
+  }
+}

Specs/Scene/Cesium3DTilesetSpec.js

@@ -125,6 +125,8 @@ defineSuite([
     var pointCloudUrl = './Data/Cesium3DTiles/PointCloud/PointCloudRGB';
     var pointCloudBatchedUrl = './Data/Cesium3DTiles/PointCloud/PointCloudBatched';
 
+    var invalidTileset = './Data/Cesium3DTiles/Tilesets/TilesetInvalid/';
+
     beforeAll(function() {
         scene = createScene();
     });
@@ -1684,6 +1686,24 @@ defineSuite([
         });
     });
 
+    it('tile failed event is raised', function() {
+        viewNothing();
+        return Cesium3DTilesTester.loadTileset(scene, invalidTileset).then(function(tileset) {
+            var spyUpdate = jasmine.createSpy('listener');
+            tileset.tileFailed.addEventListener(spyUpdate);
+            tileset.maximumMemoryUsage = 0;
+            viewRootOnly();
+            return Cesium3DTilesTester.waitForTilesLoaded(scene, tileset).then(function() {
+                expect(spyUpdate.calls.count()).toEqual(1);
+
+                var arg = spyUpdate.calls.argsFor(0)[0];
+                expect(arg).toBeDefined();
+                expect(arg.url).toContain('does_not_exist.b3dm');
+                expect(arg.message).toBeDefined();
+            });
+        });
+    });
+
     it('destroys', function() {
         return Cesium3DTilesTester.loadTileset(scene, tilesetUrl).then(function(tileset) {
             var root = tileset._root;