Method destroy

packages/melonjs/src/application/application.ts:760–807

* Destroy this application instance and release all associated resources. * Removes the canvas from the DOM, destroys the world, and unregisters * all event listeners. * @param removeCanvas - if true, the canvas element is removed from the DOM (default: true) * @example * // clean up when

(removeCanvas: boolean = true)

	 * app.destroy();
	 */
	destroy(removeCanvas: boolean = true): void {
		// stop the render loop and remove all event listeners
		/* eslint-disable @typescript-eslint/unbound-method */
		off(TICK, this._tick, this);
		off(BLUR, this._onBlur, this);
		off(FOCUS, this._onFocus, this);
		off(STATE_CHANGE, this.repaint, this);
		off(STATE_RESTART, this.repaint, this);
		off(STATE_RESUME, this.repaint, this);
		off(STAGE_RESET, this.reset, this);
		/* eslint-enable @typescript-eslint/unbound-method */

		// remove DOM event listeners
		if (this._onResize) {
			globalThis.removeEventListener("resize", this._onResize);
			globalThis.removeEventListener(
				"orientationchange",
				this._onOrientationChange!,
			);
			globalThis.removeEventListener("scroll", this._onScroll!);
			if (device.screenOrientation) {
				globalThis.screen.orientation.onchange = null;
			}
		}

		// destroy the world and all its children
		if (this.world) {
			this.world.destroy();
		}

		// tear down the renderer's batchers so their `event.on(...)`
		// subscriptions (e.g. `GPU_TEXTURE_CACHE_RESET` on
		// `MaterialBatcher`) don't leak across the disposal — every
		// otherwise-discarded `Application` would otherwise keep the
		// batchers (and their renderer reference) alive for the rest
		// of the page's lifetime.
		this.renderer?.destroy();

		// remove the canvas from the DOM
		if (removeCanvas && this.renderer) {
			const canvas = this.renderer.getCanvas();
			if (canvas.parentElement) {
				canvas.parentElement.removeChild(canvas);
			}
		}

		this.isInitialized = false;
	}

	/**
	 * force the redraw (not update) of all objects