happy-dom-without-node/src/mutation-observer/MutationListener.ts

Happy DOM is a JavaScript implementation of a web browser without its graphical user interface. It includes many web standards from WHATWG DOM and HTML.

import IMutationObserverInit from './IMutationObserverInit.js';
import MutationObserver from './MutationObserver.js';
import MutationRecord from './MutationRecord.js';
import Node from '../nodes/node/Node.js';
import BrowserWindow from '../window/BrowserWindow.js';

/**
 * Mutation Observer Listener.
 */
export default class MutationListener {
	public readonly target: Node;
	public options: IMutationObserverInit;
	#window: BrowserWindow;
	#observer: MutationObserver;
	#callback: (record: MutationRecord[], observer: MutationObserver) => void;
	#records: MutationRecord[] | null = [];
	#immediate: NodeJS.Immediate | null = null;

	/**
	 * Constructor.
	 *
	 * @param init Options.
	 * @param init.window Window.
	 * @param init.options Options.
	 * @param init.target Target.
	 * @param init.observer Observer.
	 * @param init.callback Callback.
	 */
	constructor(init: {
		window: BrowserWindow;
		options: IMutationObserverInit;
		target: Node;
		observer: MutationObserver;
		callback: (record: MutationRecord[], observer: MutationObserver) => void;
	}) {
		this.options = init.options;
		this.target = init.target;
		this.#window = init.window;
		this.#observer = init.observer;
		this.#callback = init.callback;
	}

	/**
	 * Reports mutations.
	 *
	 * @param record Record.
	 */
	public report(record: MutationRecord): void {
		if (!this.#records) {
			return;
		}

		this.#records.push(record);

		if (this.#immediate) {
			this.#window.cancelAnimationFrame(this.#immediate);
		}

		this.#immediate = this.#window.requestAnimationFrame(() => {
			const records = this.#records;
			if (records?.length > 0) {
				this.#records = [];
				this.#callback(records, this.#observer);
			}
		});
	}

	/**
	 * Destroys the listener.
	 */
	public takeRecords(): MutationRecord[] {
		if (this.#immediate) {
			this.#window.cancelAnimationFrame(this.#immediate);
		}
		const records = this.#records;
		this.#records = [];
		return records;
	}

	/**
	 * Destroys the listener.
	 */
	public destroy(): void {
		if (this.#immediate) {
			this.#window.cancelAnimationFrame(this.#immediate);
		}
		(<null>this.options) = null;
		(<null>this.target) = null;
		(<null>this.#observer) = null;
		(<null>this.#callback) = null;
		(<null>this.#immediate) = null;
		(<null>this.#records) = null;
	}
}