import defaultValue from "./defaultValue.js";
import DeveloperError from "./DeveloperError.js";
function returnTrue() {
return true;
}
/**
* Destroys an object. Each of the object's functions, including functions in its prototype,
* is replaced with a function that throws a {@link DeveloperError}, except for the object's
* isDestroyed
function, which is set to a function that returns true
.
* The object's properties are removed with delete
.
*
* This function is used by objects that hold native resources, e.g., WebGL resources, which
* need to be explicitly released. Client code calls an object's destroy
function,
* which then releases the native resource and calls destroyObject
to put itself
* in a destroyed state.
*
* @function
*
* @param {object} object The object to destroy.
* @param {string} [message] The message to include in the exception that is thrown if
* a destroyed object's function is called.
*
*
* @example
* // How a texture would destroy itself.
* this.destroy = function () {
* _gl.deleteTexture(_texture);
* return Cesium.destroyObject(this);
* };
*
* @see DeveloperError
*/
function destroyObject(object, message) {
message = defaultValue(
message,
"This object was destroyed, i.e., destroy() was called."
);
function throwOnDestroyed() {
//>>includeStart('debug', pragmas.debug);
throw new DeveloperError(message);
//>>includeEnd('debug');
}
for (const key in object) {
if (typeof object[key] === "function") {
object[key] = throwOnDestroyed;
}
}
object.isDestroyed = returnTrue;
return undefined;
}
export default destroyObject;