slotted.mjs

import { isString } from "../types/is.mjs";
import { validateString } from "../types/validate.mjs";

export { getSlottedElements, getSlottedNodes };

/**
 * @private
 * @param {String|undefined} query
 * @param {String|undefined|null} name name of the slot (if the parameter is undefined, all slots are searched, if the parameter has the value null, all slots without a name are searched. if a string is specified, the slots with this name are searched.)
 * @return {*}
 * @this CustomElement
 * @license AGPLv3
 * @since 3.33.0
 * @throws {Error} query must be a string
 */
function getSlottedNodes(query, name) {
	const result = new Set();

	if (!this.shadowRoot) {
		return result;
	}

	let selector = "slot";
	if (name !== undefined) {
		if (name === null) {
			selector += ":not([name])";
		} else {
			selector += `[name=${validateString(name)}]`;
		}
	}

	const slots = this.shadowRoot.querySelectorAll(selector);

	for (const [, slot] of Object.entries(slots)) {
		slot.assignedNodes().forEach(function (node) {
			if (node === null || node === undefined) {
				return;
			}

			if (isString(query)) {
				node.querySelectorAll(query).forEach(function (n) {
					result.add(n);
				});

				if (node.matches(query)) {
					result.add(node);
				}
			} else if (query !== undefined) {
				throw new Error("query must be a string");
			} else {
				result.add(node);
			}
		});
	}

	return result;
}

/**
 * @private
 * @param {String|undefined} query
 * @param {String|undefined|null} name name of the slot (if the parameter is undefined, all slots are searched, if the parameter has the value null, all slots without a name are searched. if a string is specified, the slots with this name are searched.)
 * @return {*}
 * @this CustomElement
 * @license AGPLv3
 * @since 1.23.0
 * @throws {Error} query must be a string
 */
function getSlottedElements(query, name) {
	const result = new Set();

	if (!(this.shadowRoot instanceof ShadowRoot)) {
		return result;
	}

	let selector = "slot";
	if (name !== undefined) {
		if (name === null) {
			selector += ":not([name])";
		} else {
			selector += `[name=${validateString(name)}]`;
		}
	}

	const slots = this.shadowRoot.querySelectorAll(selector);

	for (const [, slot] of Object.entries(slots)) {
		slot.assignedElements().forEach(function (node) {
			if (!(node instanceof HTMLElement)) return;

			if (isString(query)) {
				node.querySelectorAll(query).forEach(function (n) {
					result.add(n);
				});

				if (node.matches(query)) {
					result.add(node);
				}
			} else if (query !== undefined) {
				throw new Error("query must be a string");
			} else {
				result.add(node);
			}
		});
	}

	return result;
}