@schukai/monster 3.51.4 → 3.52.0

package/source/dom/resource/script.mjs

@@ -7,13 +7,13 @@
 
 import { extend } from "../../data/extend.mjs";
 import {
-    ATTRIBUTE_CLASS,
-    ATTRIBUTE_ID,
-    ATTRIBUTE_NONCE,
-    ATTRIBUTE_SRC,
-    ATTRIBUTE_TITLE,
-    ATTRIBUTE_TYPE,
-    TAG_SCRIPT,
+	ATTRIBUTE_CLASS,
+	ATTRIBUTE_ID,
+	ATTRIBUTE_NONCE,
+	ATTRIBUTE_SRC,
+	ATTRIBUTE_TITLE,
+	ATTRIBUTE_TYPE,
+	TAG_SCRIPT,
 } from "../constants.mjs";
 import { KEY_DOCUMENT, referenceSymbol, Resource } from "../resource.mjs";
 import { instanceSymbol } from "../../constants.mjs";
@@ -29,53 +29,53 @@ export { Script };
  * @summary A Resource class
  */
 class Script extends Resource {
-    /**
-     * @property {boolean} async=true {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-async}
-     * @property {string} crossOrigin=anonymous {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-crossorigin}
-     * @property {boolean} defer=false {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-defer}
-     * @property {string} integrity {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-integrity}
-     * @property {boolean} nomodule {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-nomodule}
-     * @property {string} nonce {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-nonce}
-     * @property {string} referrerpolicy {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-referrerpolicy}
-     * @property {string} type {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-type}
-     */
-    get defaults() {
-        return extend({}, super.defaults, {
-            async: true,
-            crossOrigin: "anonymous",
-            defer: false,
-            integrity: undefined,
-            nomodule: false,
-            nonce: undefined,
-            referrerpolicy: undefined,
-            type: "text/javascript",
-        });
-    }
+	/**
+	 * @property {boolean} async=true {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-async}
+	 * @property {string} crossOrigin=anonymous {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-crossorigin}
+	 * @property {boolean} defer=false {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-defer}
+	 * @property {string} integrity {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-integrity}
+	 * @property {boolean} nomodule {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-nomodule}
+	 * @property {string} nonce {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-nonce}
+	 * @property {string} referrerpolicy {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-referrerpolicy}
+	 * @property {string} type {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-type}
+	 */
+	get defaults() {
+		return extend({}, super.defaults, {
+			async: true,
+			crossOrigin: "anonymous",
+			defer: false,
+			integrity: undefined,
+			nomodule: false,
+			nonce: undefined,
+			referrerpolicy: undefined,
+			type: "text/javascript",
+		});
+	}
 
-    /**
-     * This method is called by the `instanceof` operator.
-     * @returns {symbol}
-     * @since 2.1.0
-     */
-    static get [instanceSymbol]() {
-        return Symbol.for("@schukai/monster/dom/resource/script");
-    }
+	/**
+	 * This method is called by the `instanceof` operator.
+	 * @returns {symbol}
+	 * @since 2.1.0
+	 */
+	static get [instanceSymbol]() {
+		return Symbol.for("@schukai/monster/dom/resource/script");
+	}
 
-    /**
-     *
-     * @return {Monster.DOM.Resource.Script}
-     */
-    create() {
-        createElement.call(this);
-        return this;
-    }
+	/**
+	 *
+	 * @return {Monster.DOM.Resource.Script}
+	 */
+	create() {
+		createElement.call(this);
+		return this;
+	}
 
-    /**
-     * @return {string}
-     */
-    static getURLAttribute() {
-        return ATTRIBUTE_SRC;
-    }
+	/**
+	 * @return {string}
+	 */
+	static getURLAttribute() {
+		return ATTRIBUTE_SRC;
+	}
 }
 
 /**
@@ -83,29 +83,27 @@ class Script extends Resource {
  * @return {Monster.DOM.Resource.Script}
  */
 function createElement() {
-    const self = this;
+	const document = this.getOption(KEY_DOCUMENT);
+	this[referenceSymbol] = document.createElement(TAG_SCRIPT);
 
-    const document = self.getOption(KEY_DOCUMENT);
-    self[referenceSymbol] = document.createElement(TAG_SCRIPT);
+	for (const key of [
+		"crossOrigin",
+		"defer",
+		"async",
+		"integrity",
+		"nomodule",
+		ATTRIBUTE_NONCE,
+		"referrerpolicy",
+		ATTRIBUTE_TYPE,
+		ATTRIBUTE_SRC,
+		ATTRIBUTE_ID,
+		ATTRIBUTE_CLASS,
+		ATTRIBUTE_TITLE,
+	]) {
+		if (this.getOption(key) !== undefined) {
+			this[referenceSymbol][key] = this.getOption(key);
+		}
+	}
 
-    for (let key of [
-        "crossOrigin",
-        "defer",
-        "async",
-        "integrity",
-        "nomodule",
-        ATTRIBUTE_NONCE,
-        "referrerpolicy",
-        ATTRIBUTE_TYPE,
-        ATTRIBUTE_SRC,
-        ATTRIBUTE_ID,
-        ATTRIBUTE_CLASS,
-        ATTRIBUTE_TITLE,
-    ]) {
-        if (self.getOption(key) !== undefined) {
-            self[referenceSymbol][key] = self.getOption(key);
-        }
-    }
-
-    return self;
+	return this;
 }

package/source/dom/resource.mjs

@@ -13,7 +13,11 @@ import { ID } from "../types/id.mjs";
 import { isString } from "../types/is.mjs";
 import { Observer } from "../types/observer.mjs";
 import { ProxyObserver } from "../types/proxyobserver.mjs";
-import { ATTRIBUTE_CLASS, ATTRIBUTE_ID, ATTRIBUTE_TITLE } from "./constants.mjs";
+import {
+	ATTRIBUTE_CLASS,
+	ATTRIBUTE_ID,
+	ATTRIBUTE_TITLE,
+} from "./constants.mjs";
 import { instanceSymbol } from "../constants.mjs";
 
 export { Resource, KEY_DOCUMENT, KEY_QUERY, referenceSymbol };
@@ -52,143 +56,143 @@ const referenceSymbol = Symbol("reference");
  * @summary A Resource class
  */
 class Resource extends BaseWithOptions {
-    /**
-     *
-     * @param {Object|undefined} options
-     */
-    constructor(options) {
-        super(options);
-
-        let uri = this.getOption(this.constructor.getURLAttribute());
-
-        if (uri === undefined) {
-            throw new Error("missing source");
-        } else if (uri instanceof URL) {
-            uri = uri.toString();
-        } else if (!isString(uri)) {
-            throw new Error("unsupported url type");
-        }
-
-        this[internalSymbol][this.constructor.getURLAttribute()] = uri;
-        this[internalStateSymbol] = new ProxyObserver({
-            loaded: false,
-            error: undefined,
-        });
-
-        this[referenceSymbol] = undefined;
-    }
-
-    /**
-     * @return {boolean}
-     */
-    isConnected() {
-        if (this[referenceSymbol] instanceof HTMLElement) {
-            return this[referenceSymbol].isConnected;
-        }
-
-        return false;
-    }
-
-    /**
-     * This method is overridden by the special classes and creates the DOM object.
-     * This method is also called implicitly, if not yet done explicitly, by calling `connect()`.
-     *
-     * @throws {Error} this method must be implemented by derived classes
-     * @return {Monster.DOM.Resource}
-     */
-    create() {
-        throw new Error("this method must be implemented by derived classes");
-    }
-
-    /**
-     * This method appends the HTMLElement to the specified document.
-     * If the element has not yet been created, `create()` is called implicitly.
-     *
-     * throws {Error} target not found
-     * @return {Monster.DOM.Resource}
-     */
-    connect() {
-        if (!(this[referenceSymbol] instanceof HTMLElement)) {
-            this.create();
-        }
-
-        appendToDocument.call(this);
-        return this;
-    }
-
-    /**
-     * @property {Document} document the document object into which the node is to be appended
-     * @property {string} src/href url to the corresponding resource
-     * @property {string} query defines the location where the resource is to be hooked into the dom.
-     * @property {string} id element attribute id
-     * @property {string} title element attribute title
-     * @property {string} class element attribute class
-     * @property {int} timeout timeout
-     */
-    get defaults() {
-        return extend({}, super.defaults, {
-            [this.constructor.getURLAttribute()]: undefined,
-            [KEY_DOCUMENT]: getGlobalObject("document"),
-            [KEY_QUERY]: "head",
-            [KEY_TIMEOUT]: 10000,
-            [ATTRIBUTE_ID]: new ID("resource").toString(),
-            [ATTRIBUTE_CLASS]: undefined,
-            [ATTRIBUTE_TITLE]: undefined,
-        });
-    }
-
-    /**
-     * With `available()` you can check if a resource is available.
-     * This is the case when the tag is included and the resource is loaded.
-     *
-     * @return {Promise}
-     */
-    available() {
-        const self = this;
-        if (!(self[referenceSymbol] instanceof HTMLElement)) {
-            return Promise.reject("no element");
-        }
-
-        if (!self.isConnected()) {
-            return Promise.reject("element not connected");
-        }
-
-        if (self[internalStateSymbol].getSubject()["loaded"] === true) {
-            if (self[internalStateSymbol].getSubject()["error"] !== undefined) {
-                return Promise.reject(self[internalStateSymbol].getSubject()["error"]);
-            }
-
-            return Promise.resolve();
-        }
-
-        return new Promise(function (resolve, reject) {
-            const timeout = setTimeout(() => {
-                reject("timeout");
-            }, self.getOption("timeout"));
-
-            const observer = new Observer(() => {
-                clearTimeout(timeout);
-                self[internalStateSymbol].detachObserver(observer);
-                resolve();
-            });
-
-            self[internalStateSymbol].attachObserver(observer);
-        });
-    }
-
-    /**
-     * @return {string}
-     */
-    static getURLAttribute() {
-        throw new Error("this method must be implemented by derived classes");
-    }
-
-    /**
-     * @return {symbol}
-     */
-    static get [instanceSymbol]() {
-        return Symbol.for("@schukai/monster/dom/resource");
-    }
+	/**
+	 *
+	 * @param {Object|undefined} options
+	 */
+	constructor(options) {
+		super(options);
+
+		let uri = this.getOption(this.constructor.getURLAttribute());
+
+		if (uri === undefined) {
+			throw new Error("missing source");
+		} else if (uri instanceof URL) {
+			uri = uri.toString();
+		} else if (!isString(uri)) {
+			throw new Error("unsupported url type");
+		}
+
+		this[internalSymbol][this.constructor.getURLAttribute()] = uri;
+		this[internalStateSymbol] = new ProxyObserver({
+			loaded: false,
+			error: undefined,
+		});
+
+		this[referenceSymbol] = undefined;
+	}
+
+	/**
+	 * @return {boolean}
+	 */
+	isConnected() {
+		if (this[referenceSymbol] instanceof HTMLElement) {
+			return this[referenceSymbol].isConnected;
+		}
+
+		return false;
+	}
+
+	/**
+	 * This method is overridden by the special classes and creates the DOM object.
+	 * This method is also called implicitly, if not yet done explicitly, by calling `connect()`.
+	 *
+	 * @throws {Error} this method must be implemented by derived classes
+	 * @return {Monster.DOM.Resource}
+	 */
+	create() {
+		throw new Error("this method must be implemented by derived classes");
+	}
+
+	/**
+	 * This method appends the HTMLElement to the specified document.
+	 * If the element has not yet been created, `create()` is called implicitly.
+	 *
+	 * throws {Error} target not found
+	 * @return {Monster.DOM.Resource}
+	 */
+	connect() {
+		if (!(this[referenceSymbol] instanceof HTMLElement)) {
+			this.create();
+		}
+
+		appendToDocument.call(this);
+		return this;
+	}
+
+	/**
+	 * @property {Document} document the document object into which the node is to be appended
+	 * @property {string} src/href url to the corresponding resource
+	 * @property {string} query defines the location where the resource is to be hooked into the dom.
+	 * @property {string} id element attribute id
+	 * @property {string} title element attribute title
+	 * @property {string} class element attribute class
+	 * @property {int} timeout timeout
+	 */
+	get defaults() {
+		return extend({}, super.defaults, {
+			[this.constructor.getURLAttribute()]: undefined,
+			[KEY_DOCUMENT]: getGlobalObject("document"),
+			[KEY_QUERY]: "head",
+			[KEY_TIMEOUT]: 10000,
+			[ATTRIBUTE_ID]: new ID("resource").toString(),
+			[ATTRIBUTE_CLASS]: undefined,
+			[ATTRIBUTE_TITLE]: undefined,
+		});
+	}
+
+	/**
+	 * With `available()` you can check if a resource is available.
+	 * This is the case when the tag is included and the resource is loaded.
+	 *
+	 * @return {Promise}
+	 */
+	available() {
+		const self = this;
+		if (!(self[referenceSymbol] instanceof HTMLElement)) {
+			return Promise.reject("no element");
+		}
+
+		if (!self.isConnected()) {
+			return Promise.reject("element not connected");
+		}
+
+		if (self[internalStateSymbol].getSubject()["loaded"] === true) {
+			if (self[internalStateSymbol].getSubject()["error"] !== undefined) {
+				return Promise.reject(self[internalStateSymbol].getSubject()["error"]);
+			}
+
+			return Promise.resolve();
+		}
+
+		return new Promise(function (resolve, reject) {
+			const timeout = setTimeout(() => {
+				reject("timeout");
+			}, self.getOption("timeout"));
+
+			const observer = new Observer(() => {
+				clearTimeout(timeout);
+				self[internalStateSymbol].detachObserver(observer);
+				resolve();
+			});
+
+			self[internalStateSymbol].attachObserver(observer);
+		});
+	}
+
+	/**
+	 * @return {string}
+	 */
+	static getURLAttribute() {
+		throw new Error("this method must be implemented by derived classes");
+	}
+
+	/**
+	 * @return {symbol}
+	 */
+	static get [instanceSymbol]() {
+		return Symbol.for("@schukai/monster/dom/resource");
+	}
 }
 
 /**
@@ -197,17 +201,15 @@ class Resource extends BaseWithOptions {
  * throws {Error} target not found
  */
 function appendToDocument() {
-    const self = this;
+	const targetNode = document.querySelector(this.getOption(KEY_QUERY, "head"));
+	if (!(targetNode instanceof HTMLElement)) {
+		throw new Error("target not found");
+	}
 
-    const targetNode = document.querySelector(self.getOption(KEY_QUERY, "head"));
-    if (!(targetNode instanceof HTMLElement)) {
-        throw new Error("target not found");
-    }
+	addEvents.call(this);
+	targetNode.appendChild(this[referenceSymbol]);
 
-    addEvents.call(self);
-    targetNode.appendChild(self[referenceSymbol]);
-
-    return self;
+	return this;
 }
 
 /**
@@ -215,29 +217,29 @@ function appendToDocument() {
  * @return {addEvents}
  */
 function addEvents() {
-    const self = this;
-
-    const onError = () => {
-        self[referenceSymbol].removeEventListener("error", onError);
-        self[referenceSymbol].removeEventListener("load", onLoad);
-
-        self[internalStateSymbol].setSubject({
-            loaded: true,
-            error: `${self[referenceSymbol][self.constructor.getURLAttribute()]} is not available`,
-        });
-
-        return;
-    };
-
-    const onLoad = () => {
-        self[referenceSymbol].removeEventListener("error", onError);
-        self[referenceSymbol].removeEventListener("load", onLoad);
-        self[internalStateSymbol].getSubject()["loaded"] = true;
-        return;
-    };
-
-    self[referenceSymbol].addEventListener("load", onLoad, false);
-    self[referenceSymbol].addEventListener("error", onError, false);
-
-    return self;
+	const onError = () => {
+		this[referenceSymbol].removeEventListener("error", onError);
+		this[referenceSymbol].removeEventListener("load", onLoad);
+
+		this[internalStateSymbol].setSubject({
+			loaded: true,
+			error: `${
+				this[referenceSymbol][this.constructor.getURLAttribute()]
+			} is not available`,
+		});
+
+		return;
+	};
+
+	const onLoad = () => {
+		this[referenceSymbol].removeEventListener("error", onError);
+		this[referenceSymbol].removeEventListener("load", onLoad);
+		this[internalStateSymbol].getSubject()["loaded"] = true;
+		return;
+	};
+
+	this[referenceSymbol].addEventListener("load", onLoad, false);
+	this[referenceSymbol].addEventListener("error", onError, false);
+
+	return this;
 }