@cesium/engine 2.1.0 → 2.3.0

package/Source/Core/GoogleEarthEnterpriseTerrainProvider.js

@@ -1,7 +1,8 @@
+import Check from "./Check.js";
 import Credit from "./Credit.js";
 import defaultValue from "./defaultValue.js";
 import defined from "./defined.js";
-import DeveloperError from "./DeveloperError.js";
+import deprecationWarning from "./deprecationWarning.js";
 import Event from "./Event.js";
 import GeographicTilingScheme from "./GeographicTilingScheme.js";
 import GoogleEarthEnterpriseMetadata from "./GoogleEarthEnterpriseMetadata.js";
@@ -67,46 +68,42 @@ TerrainCache.prototype.tidy = function () {
 };
 
 /**
+ * @typedef {Object} GoogleEarthEnterpriseTerrainProvider.ConstructorOptions
+ *
+ * Initialization options for GoogleEarthEnterpriseTerrainProvider constructor
+ *
+ * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
+ * @property {Credit|string} [credit] A credit for the data source, which is displayed on the canvas.
+ * @property {Resource|string} [url] The url of the Google Earth Enterprise server hosting the imagery. Deprecated.
+ * @property {GoogleEarthEnterpriseMetadata} [metadata] A metadata object that can be used to share metadata requests with a GoogleEarthEnterpriseImageryProvider. Deprecated.
+ */
+
+/**
+ * <div class="notice">
+ * To construct a GoogleEarthEnterpriseTerrainProvider, call {@link  GoogleEarthEnterpriseTerrainProvider.fromMetadata}. Do not call the constructor directly.
+ * </div>
+ *
  * Provides tiled terrain using the Google Earth Enterprise REST API.
  *
  * @alias GoogleEarthEnterpriseTerrainProvider
  * @constructor
  *
- * @param {object} options Object with the following properties:
- * @param {Resource|string} options.url The url of the Google Earth Enterprise server hosting the imagery.
- * @param {GoogleEarthEnterpriseMetadata} options.metadata A metadata object that can be used to share metadata requests with a GoogleEarthEnterpriseImageryProvider.
- * @param {Ellipsoid} [options.ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
- * @param {Credit|string} [options.credit] A credit for the data source, which is displayed on the canvas.
+ * @param {GoogleEarthEnterpriseTerrainProvider.ConstructorOptions} options An object describing initialization options
  *
+ * @see GoogleEarthEnterpriseTerrainProvider.fromMetadata
+ * @see GoogleEarthEnterpriseMetadata.fromUrl
  * @see GoogleEarthEnterpriseImageryProvider
  * @see CesiumTerrainProvider
  *
  * @example
- * const geeMetadata = new GoogleEarthEnterpriseMetadata('http://www.example.com');
- * const gee = new Cesium.GoogleEarthEnterpriseTerrainProvider({
- *     metadata : geeMetadata
- * });
+ * const geeMetadata = await GoogleEarthEnterpriseMetadata.fromUrl("http://www.example.com");
+ * const gee = Cesium.GoogleEarthEnterpriseTerrainProvider.fromMetadata(geeMetadata);
  *
  * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
  */
 function GoogleEarthEnterpriseTerrainProvider(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
-  //>>includeStart('debug', pragmas.debug);
-  if (!(defined(options.url) || defined(options.metadata))) {
-    throw new DeveloperError("options.url or options.metadata is required.");
-  }
-  //>>includeEnd('debug');
-
-  let metadata;
-  if (defined(options.metadata)) {
-    metadata = options.metadata;
-  } else {
-    const resource = Resource.createIfNeeded(options.url);
-    metadata = new GoogleEarthEnterpriseMetadata(resource);
-  }
-
-  this._metadata = metadata;
   this._tilingScheme = new GeographicTilingScheme({
     numberOfLevelZeroTilesX: 2,
     numberOfLevelZeroTilesY: 2,
@@ -133,16 +130,32 @@ function GoogleEarthEnterpriseTerrainProvider(options) {
   this._terrainRequests = {};
 
   this._errorEvent = new Event();
-
   this._ready = false;
-  const that = this;
-  let metadataError;
-  this._readyPromise = metadata.readyPromise
-    .then(function (result) {
-      if (!metadata.terrainPresent) {
-        const e = new RuntimeError(
-          `The server ${metadata.url} doesn't have terrain`
-        );
+
+  if (defined(options.url)) {
+    deprecationWarning(
+      "GoogleEarthEnterpriseTerrainProvider options.url",
+      "options.url was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use GoogleEarthEnterpriseTerrainProvider.fromMetadata instead."
+    );
+    const resource = Resource.createIfNeeded(options.url);
+    const that = this;
+    let metadataError;
+    this._readyPromise = GoogleEarthEnterpriseMetadata.fromUrl(resource)
+      .then((metadata) => {
+        if (!metadata.terrainPresent) {
+          const e = new RuntimeError(
+            `The server ${metadata.url} doesn't have terrain`
+          );
+
+          return Promise.reject(e);
+        }
+
+        TileProviderError.reportSuccess(metadataError);
+        that._metadata = metadata;
+        that._ready = true;
+        return true;
+      })
+      .catch((e) => {
         metadataError = TileProviderError.reportError(
           metadataError,
           that,
@@ -153,26 +166,29 @@ function GoogleEarthEnterpriseTerrainProvider(options) {
           undefined,
           e
         );
-        return Promise.reject(e);
-      }
 
-      TileProviderError.reportSuccess(metadataError);
-      that._ready = result;
-      return result;
-    })
-    .catch(function (e) {
-      metadataError = TileProviderError.reportError(
-        metadataError,
-        that,
-        that._errorEvent,
-        e.message,
-        undefined,
-        undefined,
-        undefined,
-        e
-      );
-      return Promise.reject(e);
-    });
+        throw e;
+      });
+  } else if (defined(options.metadata)) {
+    deprecationWarning(
+      "GoogleEarthEnterpriseTerrainProvider options.metadata",
+      "options.metadata was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use GoogleEarthEnterpriseTerrainProvider.fromMetadata instead."
+    );
+    const metadata = options.metadata;
+    this._metadata = metadata;
+    const that = this;
+    this._readyPromise = Promise.resolve(this._metadata._readyPromise).then(
+      () => {
+        if (!metadata.terrainPresent) {
+          throw new RuntimeError(
+            `The server ${metadata.url} doesn't have terrain`
+          );
+        }
+
+        that._ready = true;
+      }
+    );
+  }
 }
 
 Object.defineProperties(GoogleEarthEnterpriseTerrainProvider.prototype, {
@@ -201,22 +217,13 @@ Object.defineProperties(GoogleEarthEnterpriseTerrainProvider.prototype, {
   },
 
   /**
-   * Gets the tiling scheme used by this provider.  This function should
-   * not be called before {@link GoogleEarthEnterpriseTerrainProvider#ready} returns true.
+   * Gets the tiling scheme used by this provider.
    * @memberof GoogleEarthEnterpriseTerrainProvider.prototype
    * @type {TilingScheme}
    * @readonly
    */
   tilingScheme: {
     get: function () {
-      //>>includeStart('debug', pragmas.debug);
-      if (!this._ready) {
-        throw new DeveloperError(
-          "tilingScheme must not be called before the imagery provider is ready."
-        );
-      }
-      //>>includeEnd('debug');
-
       return this._tilingScheme;
     },
   },
@@ -240,9 +247,14 @@ Object.defineProperties(GoogleEarthEnterpriseTerrainProvider.prototype, {
    * @memberof GoogleEarthEnterpriseTerrainProvider.prototype
    * @type {boolean}
    * @readonly
+   * @deprecated
    */
   ready: {
     get: function () {
+      deprecationWarning(
+        "GoogleEarthEnterpriseTerrainProvider.ready",
+        "GoogleEarthEnterpriseTerrainProvider.ready was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107."
+      );
       return this._ready;
     },
   },
@@ -252,16 +264,21 @@ Object.defineProperties(GoogleEarthEnterpriseTerrainProvider.prototype, {
    * @memberof GoogleEarthEnterpriseTerrainProvider.prototype
    * @type {Promise<boolean>}
    * @readonly
+   * @deprecated
    */
   readyPromise: {
     get: function () {
+      deprecationWarning(
+        "GoogleEarthEnterpriseTerrainProvider.readyPromise",
+        "GoogleEarthEnterpriseTerrainProvider.readyPromise was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107."
+      );
       return this._readyPromise;
     },
   },
 
   /**
    * Gets the credit to display when this terrain provider is active.  Typically this is used to credit
-   * the source of the terrain.  This function should not be called before {@link GoogleEarthEnterpriseTerrainProvider#ready} returns true.
+   * the source of the terrain.
    * @memberof GoogleEarthEnterpriseTerrainProvider.prototype
    * @type {Credit}
    * @readonly
@@ -275,8 +292,7 @@ Object.defineProperties(GoogleEarthEnterpriseTerrainProvider.prototype, {
   /**
    * Gets a value indicating whether or not the provider includes a water mask.  The water mask
    * indicates which areas of the globe are water rather than land, so they can be rendered
-   * as a reflective surface with animated waves.  This function should not be
-   * called before {@link GoogleEarthEnterpriseTerrainProvider#ready} returns true.
+   * as a reflective surface with animated waves.
    * @memberof GoogleEarthEnterpriseTerrainProvider.prototype
    * @type {boolean}
    * @readonly
@@ -289,7 +305,6 @@ Object.defineProperties(GoogleEarthEnterpriseTerrainProvider.prototype, {
 
   /**
    * Gets a value indicating whether or not the requested tiles include vertex normals.
-   * This function should not be called before {@link GoogleEarthEnterpriseTerrainProvider#ready} returns true.
    * @memberof GoogleEarthEnterpriseTerrainProvider.prototype
    * @type {boolean}
    * @readonly
@@ -302,8 +317,7 @@ Object.defineProperties(GoogleEarthEnterpriseTerrainProvider.prototype, {
 
   /**
    * Gets an object that can be used to determine availability of terrain from this provider, such as
-   * at points and in rectangles.  This function should not be called before
-   * {@link GoogleEarthEnterpriseTerrainProvider#ready} returns true.  This property may be undefined if availability
+   * at points and in rectangles. This property may be undefined if availability
    * information is not available.
    * @memberof GoogleEarthEnterpriseTerrainProvider.prototype
    * @type {TileAvailability}
@@ -316,6 +330,41 @@ Object.defineProperties(GoogleEarthEnterpriseTerrainProvider.prototype, {
   },
 });
 
+/**
+ * Creates a GoogleEarthTerrainProvider from GoogleEarthEnterpriseMetadata
+ *
+ * @param {GoogleEarthEnterpriseMetadata} metadata A metadata object that can be used to share metadata requests with a GoogleEarthEnterpriseImageryProvider.
+ * @param {GoogleEarthEnterpriseTerrainProvider.ConstructorOptions} options An object describing initialization options
+ * @returns {GoogleEarthEnterpriseTerrainProvider}
+ *
+ * @see GoogleEarthEnterpriseMetadata.fromUrl
+ *
+ * @exception {RuntimeError} metadata does not specify terrain
+ *
+ * @example
+ * const geeMetadata = await GoogleEarthEnterpriseMetadata.fromUrl("http://www.example.com");
+ * const gee = Cesium.GoogleEarthEnterpriseTerrainProvider.fromMetadata(geeMetadata);
+ */
+GoogleEarthEnterpriseTerrainProvider.fromMetadata = function (
+  metadata,
+  options
+) {
+  //>>includeStart('debug', pragmas.debug);
+  Check.defined("metadata", metadata);
+  //>>includeEnd('debug');
+
+  if (!metadata.terrainPresent) {
+    throw new RuntimeError(`The server ${metadata.url} doesn't have terrain`);
+  }
+
+  const provider = new GoogleEarthEnterpriseTerrainProvider(options);
+  provider._metadata = metadata;
+  provider._readyPromise = Promise.resolve(true);
+  provider._ready = true;
+
+  return provider;
+};
+
 const taskProcessor = new TaskProcessor("decodeGoogleEarthEnterprisePacket");
 
 // If the tile has its own terrain, then you can just use its child bitmask. If it was requested using it's parent
@@ -338,8 +387,7 @@ function computeChildMask(quadKey, info, metadata) {
 }
 
 /**
- * Requests the geometry for a given tile.  This function should not be called before
- * {@link GoogleEarthEnterpriseTerrainProvider#ready} returns true.  The result must include terrain data and
+ * Requests the geometry for a given tile.   The result must include terrain data and
  * may optionally include a water mask and an indication of which child tiles are available.
  *
  * @param {number} x The X coordinate of the tile for which to request geometry.
@@ -349,9 +397,6 @@ function computeChildMask(quadKey, info, metadata) {
  * @returns {Promise<TerrainData>|undefined} A promise for the requested geometry.  If this method
  *          returns undefined instead of a promise, it is an indication that too many requests are already
  *          pending and the request will be retried later.
- *
- * @exception {DeveloperError} This function must not be called before {@link GoogleEarthEnterpriseTerrainProvider#ready}
- *            returns true.
  */
 GoogleEarthEnterpriseTerrainProvider.prototype.requestTileGeometry = function (
   x,
@@ -359,14 +404,6 @@ GoogleEarthEnterpriseTerrainProvider.prototype.requestTileGeometry = function (
   level,
   request
 ) {
-  //>>includeStart('debug', pragmas.debug)
-  if (!this._ready) {
-    throw new DeveloperError(
-      "requestTileGeometry must not be called before the terrain provider is ready."
-    );
-  }
-  //>>includeEnd('debug');
-
   const quadKey = GoogleEarthEnterpriseMetadata.tileXYToQuadKey(x, y, level);
   const terrainCache = this._terrainCache;
   const metadata = this._metadata;

package/Source/Core/Ion.js

@@ -4,7 +4,7 @@ import Resource from "./Resource.js";
 
 let defaultTokenCredit;
 const defaultAccessToken =
-  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI4ZTMwYjM0Yy1lYTdkLTQ5YjEtOTUyYS01Y2YxMjE5OWJjMmEiLCJpZCI6MjU5LCJpYXQiOjE2Nzc2Nzk3MTZ9.OGOiqPh0He1XDVU6azp_c5w3jJcmPXcA1briVUcyrvQ";
+  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwZWQ3OWFlZC1kOTg3LTRlZjctYTAyYy0xNjFmODE1MWE2NGUiLCJpZCI6MjU5LCJpYXQiOjE2ODI5NDYzODh9.DEH4GpqliH-xsDE7h-ZCICtHgnGu32wdSjt4hFqw7lU";
 /**
  * Default settings for accessing the Cesium ion API.
  *

package/Source/Core/IonGeocoderService.js

@@ -33,7 +33,7 @@ function IonGeocoderService(options) {
 
   const defaultTokenCredit = Ion.getDefaultTokenCredit(accessToken);
   if (defined(defaultTokenCredit)) {
-    options.scene.frameState.creditDisplay.addDefaultCredit(
+    options.scene.frameState.creditDisplay.addStaticCredit(
       Credit.clone(defaultTokenCredit)
     );
   }
@@ -51,6 +51,21 @@ function IonGeocoderService(options) {
   this._pelias = new PeliasGeocoderService(searchEndpoint);
 }
 
+Object.defineProperties(IonGeocoderService.prototype, {
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof IonGeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: function () {
+      return undefined;
+    },
+  },
+});
+
 /**
  * @function
  *
@@ -58,7 +73,7 @@ function IonGeocoderService(options) {
  * @param {GeocodeType} [type=GeocodeType.SEARCH] The type of geocode to perform.
  * @returns {Promise<GeocoderService.Result[]>}
  */
-IonGeocoderService.prototype.geocode = function (query, geocodeType) {
+IonGeocoderService.prototype.geocode = async function (query, geocodeType) {
   return this._pelias.geocode(query, geocodeType);
 };
 export default IonGeocoderService;

package/Source/Core/IonResource.js

@@ -16,7 +16,7 @@ import RuntimeError from "./RuntimeError.js";
  * @augments Resource
  *
  * @param {object} endpoint The result of the Cesium ion asset endpoint service.
- * @param {Resource} endpointResource The resource used to retreive the endpoint.
+ * @param {Resource} endpointResource The resource used to retrieve the endpoint.
  *
  * @see Ion
  * @see IonImageryProvider
@@ -87,8 +87,14 @@ if (defined(Object.create)) {
  * @returns {Promise<IonResource>} A Promise to am instance representing the Cesium ion Asset.
  *
  * @example
- * //Load a Cesium3DTileset with asset ID of 124624234
- * viewer.scene.primitives.add(new Cesium.Cesium3DTileset({ url: Cesium.IonResource.fromAssetId(124624234) }));
+ * // Load a Cesium3DTileset with asset ID of 124624234
+ * try {
+ *   const resource = await Cesium.IonResource.fromAssetId(124624234);
+ *   const tileset = await Cesium.Cesium3DTileset.fromUrl(resource);
+ *   scene.primitives.add(tileset);
+ * } catch (error) {
+ *   console.error(`Error creating tileset: ${error}`);
+ * }
  *
  * @example
  * //Load a CZML file with asset ID of 10890
@@ -197,6 +203,11 @@ IonResource.prototype._makeRequest = function (options) {
     options.headers = {};
   }
   options.headers.Authorization = `Bearer ${this._ionEndpoint.accessToken}`;
+  options.headers["X-Cesium-Client"] = "CesiumJS";
+  /* global CESIUM_VERSION */
+  if (typeof CESIUM_VERSION !== "undefined") {
+    options.headers["X-Cesium-Client-Version"] = CESIUM_VERSION;
+  }
 
   return Resource.prototype._makeRequest.call(this, options);
 };

package/Source/Core/OpenCageGeocoderService.js

@@ -1,6 +1,7 @@
 import Cartesian3 from "./Cartesian3.js";
 import Check from "./Check.js";
 import combine from "./combine.js";
+import Credit from "./Credit.js";
 import defaultValue from "./defaultValue.js";
 import defined from "./defined.js";
 import Rectangle from "./Rectangle.js";
@@ -48,6 +49,10 @@ function OpenCageGeocoderService(url, apiKey, params) {
   url.setQueryParameters({ key: apiKey });
   this._url = url;
   this._params = defaultValue(params, {});
+  this._credit = new Credit(
+    `Geodata copyright <a href="https://www.openstreetmap.org/">OpenStreetMap</a> contributors`,
+    false
+  );
 }
 
 Object.defineProperties(OpenCageGeocoderService.prototype, {
@@ -73,6 +78,18 @@ Object.defineProperties(OpenCageGeocoderService.prototype, {
       return this._params;
     },
   },
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof OpenCageGeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: function () {
+      return this._credit;
+    },
+  },
 });
 
 /**
@@ -81,7 +98,7 @@ Object.defineProperties(OpenCageGeocoderService.prototype, {
  * @param {string} query The query to be sent to the geocoder service
  * @returns {Promise<GeocoderService.Result[]>}
  */
-OpenCageGeocoderService.prototype.geocode = function (query) {
+OpenCageGeocoderService.prototype.geocode = async function (query) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.string("query", query);
   //>>includeEnd('debug');

package/Source/Core/OrientedBoundingBox.js

@@ -24,7 +24,7 @@ import Rectangle from "./Rectangle.js";
  *
  * @param {Cartesian3} [center=Cartesian3.ZERO] The center of the box.
  * @param {Matrix3} [halfAxes=Matrix3.ZERO] The three orthogonal half-axes of the bounding box.
- *                                          Equivalently, the transformation matrix, to rotate and scale a 1x1x1
+ *                                          Equivalently, the transformation matrix, to rotate and scale a 2x2x2
  *                                          cube centered at the origin.
  *
  *
@@ -46,7 +46,9 @@ function OrientedBoundingBox(center, halfAxes) {
    */
   this.center = Cartesian3.clone(defaultValue(center, Cartesian3.ZERO));
   /**
-   * The transformation matrix, to rotate the box to the right position.
+   * The three orthogonal half-axes of the bounding box. Equivalently, the
+   * transformation matrix, to rotate and scale a 2x2x2 cube centered at the
+   * origin.
    * @type {Matrix3}
    * @default {@link Matrix3.ZERO}
    */

package/Source/Core/OrthographicFrustum.js

@@ -184,6 +184,19 @@ Object.defineProperties(OrthographicFrustum.prototype, {
       return this._offCenterFrustum.projectionMatrix;
     },
   },
+  /**
+   * Gets the orthographic projection matrix computed from the view frustum.
+   * @memberof OrthographicFrustum.prototype
+   * @type {OrthographicOffCenterFrustum}
+   * @readonly
+   * @private
+   */
+  offCenterFrustum: {
+    get: function () {
+      update(this);
+      return this._offCenterFrustum;
+    },
+  },
 });
 
 /**

package/Source/Core/PeliasGeocoderService.js

@@ -44,6 +44,18 @@ Object.defineProperties(PeliasGeocoderService.prototype, {
       return this._url;
     },
   },
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof PeliasGeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: function () {
+      return undefined;
+    },
+  },
 });
 
 /**
@@ -53,7 +65,7 @@ Object.defineProperties(PeliasGeocoderService.prototype, {
  * @param {GeocodeType} [type=GeocodeType.SEARCH] The type of geocode to perform.
  * @returns {Promise<GeocoderService.Result[]>}
  */
-PeliasGeocoderService.prototype.geocode = function (query, type) {
+PeliasGeocoderService.prototype.geocode = async function (query, type) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.string("query", query);
   //>>includeEnd('debug');
@@ -86,6 +98,7 @@ PeliasGeocoderService.prototype.geocode = function (query, type) {
       return {
         displayName: resultObject.properties.label,
         destination: destination,
+        attributions: results.attributions,
       };
     });
   });

package/Source/Core/PerspectiveFrustum.js

@@ -274,6 +274,20 @@ Object.defineProperties(PerspectiveFrustum.prototype, {
       return this._sseDenominator;
     },
   },
+
+  /**
+   * Gets the orthographic projection matrix computed from the view frustum.
+   * @memberof PerspectiveFrustum.prototype
+   * @type {PerspectiveOffCenterFrustum}
+   * @readonly
+   * @private
+   */
+  offCenterFrustum: {
+    get: function () {
+      update(this);
+      return this._offCenterFrustum;
+    },
+  },
 });
 
 /**

package/Source/Core/Request.js

@@ -18,6 +18,7 @@ import RequestType from "./RequestType.js";
  * @param {boolean} [options.throttle=false] Whether to throttle and prioritize the request. If false, the request will be sent immediately. If true, the request will be throttled and sent based on priority.
  * @param {boolean} [options.throttleByServer=false] Whether to throttle the request by server.
  * @param {RequestType} [options.type=RequestType.OTHER] The type of request.
+ * @param {string} [options.serverKey] A key used to identify the server that a request is going to.
  */
 function Request(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
@@ -105,7 +106,7 @@ function Request(options) {
    *
    * @private
    */
-  this.serverKey = undefined;
+  this.serverKey = options.serverKey;
 
   /**
    * The current state of the request.
@@ -166,7 +167,7 @@ Request.prototype.clone = function (result) {
   result.serverKey = this.serverKey;
 
   // These get defaulted because the cloned request hasn't been issued
-  result.state = this.RequestState.UNISSUED;
+  result.state = RequestState.UNISSUED;
   result.deferred = undefined;
   result.cancelled = false;
 

package/Source/Core/RequestScheduler.js

@@ -65,18 +65,23 @@ RequestScheduler.maximumRequests = 50;
 RequestScheduler.maximumRequestsPerServer = 6;
 
 /**
- * A per server key list of overrides to use for throttling instead of <code>maximumRequestsPerServer</code>
+ * A per server key list of overrides to use for throttling instead of <code>maximumRequestsPerServer</code>.
+ * Useful when streaming data from a known HTTP/2 or HTTP/3 server.
  * @type {object}
  *
  * @example
+ * RequestScheduler.requestsByServer["myserver.com:443"] = 18;
+ *
+ * @example
  * RequestScheduler.requestsByServer = {
- *   'api.cesium.com:443': 18,
- *   'assets.cesium.com:443': 18
+ *   "api.cesium.com:443": 18,
+ *   "assets.cesium.com:443": 18,
  * };
  */
 RequestScheduler.requestsByServer = {
   "api.cesium.com:443": 18,
-  "assets.cesium.com:443": 18,
+  "assets.ion.cesium.com:443": 18,
+  "ibasemaps-api.arcgis.com:443": 18,
 };
 
 /**
@@ -352,7 +357,7 @@ RequestScheduler.getServerKey = function (url) {
 
   let uri = new Uri(url);
   if (uri.scheme() === "") {
-    uri = new Uri(url).absoluteTo(pageUri);
+    uri = uri.absoluteTo(pageUri);
     uri.normalize();
   }