happy-dom 14.3.3 → 14.3.5

package/src/query-selector/SelectorItem.ts

@@ -18,6 +18,7 @@ export default class SelectorItem {
 	public pseudos: ISelectorPseudo[] | null;
 	public isPseudoElement: boolean;
 	public combinator: SelectorCombinatorEnum;
+	public ignoreErrors: boolean;
 
 	/**
 	 * Constructor.
@@ -30,6 +31,7 @@ export default class SelectorItem {
 	 * @param [options.attributes] Attributes.
 	 * @param [options.pseudos] Pseudos.
 	 * @param [options.isPseudoElement] Is pseudo element.
+	 * @param [options.ignoreErrors] Ignore errors.
 	 */
 	constructor(options?: {
 		tagName?: string;
@@ -39,6 +41,7 @@ export default class SelectorItem {
 		pseudos?: ISelectorPseudo[];
 		isPseudoElement?: boolean;
 		combinator?: SelectorCombinatorEnum;
+		ignoreErrors?: boolean;
 	}) {
 		this.tagName = options?.tagName || null;
 		this.id = options?.id || null;
@@ -47,6 +50,7 @@ export default class SelectorItem {
 		this.pseudos = options?.pseudos || null;
 		this.isPseudoElement = options?.isPseudoElement || false;
 		this.combinator = options?.combinator || SelectorCombinatorEnum.descendant;
+		this.ignoreErrors = options?.ignoreErrors || false;
 	}
 
 	/**
@@ -98,7 +102,7 @@ export default class SelectorItem {
 
 		// Pseudo match
 		if (this.pseudos) {
-			const result = this.matchPsuedo(element);
+			const result = this.matchPseudo(element);
 			if (!result) {
 				return null;
 			}
@@ -114,7 +118,7 @@ export default class SelectorItem {
 	 * @param element Element.
 	 * @returns Result.
 	 */
-	private matchPsuedo(element: Element): ISelectorMatch | null {
+	private matchPseudo(element: Element): ISelectorMatch | null {
 		const parent = <Element>element[PropertySymbol.parentNode];
 		const parentChildren = element[PropertySymbol.parentNode]
 			? (<Element>element[PropertySymbol.parentNode])[PropertySymbol.children]
@@ -135,7 +139,14 @@ export default class SelectorItem {
 				case 'nth-last-child':
 				case 'nth-last-of-type':
 					if (!pseudo.arguments) {
-						throw new DOMException(`The selector "${this.getSelectorString()}" is not valid.`);
+						if (this.ignoreErrors) {
+							return null;
+						}
+						throw new DOMException(
+							`Failed to execute 'matches' on '${
+								element.constructor.name
+							}': '${this.getSelectorString()}' is not a valid selector.`
+						);
 					}
 					break;
 			}
@@ -357,7 +368,7 @@ export default class SelectorItem {
 	 * @returns Selector string.
 	 */
 	private getSelectorString(): string {
-		return `${this.tagName || ''}${this.id ? `#${this.id}` : ''}${
+		return `${this.tagName ? this.tagName.toLowerCase() : ''}${this.id ? `#${this.id}` : ''}${
 			this.classNames ? `.${this.classNames.join('.')}` : ''
 		}${
 			this.attributes

package/src/query-selector/SelectorParser.ts

@@ -63,38 +63,52 @@ export default class SelectorParser {
 	 * Parses a selector string and returns an instance of SelectorItem.
 	 *
 	 * @param selector Selector.
+	 * @param [options] Options.
+	 * @param [options.ignoreErrors] Ignores errors.
 	 * @returns Selector item.
 	 */
-	public static getSelectorItem(selector: string): SelectorItem {
-		return this.getSelectorGroups(selector)[0][0];
+	public static getSelectorItem(
+		selector: string,
+		options?: { ignoreErrors?: boolean }
+	): SelectorItem {
+		return this.getSelectorGroups(selector, options)[0][0];
 	}
 
 	/**
 	 * Parses a selector string and returns groups with SelectorItem instances.
 	 *
 	 * @param selector Selector.
+	 * @param [options] Options.
+	 * @param [options.ignoreErrors] Ignores errors.
 	 * @returns Selector groups.
 	 */
-	public static getSelectorGroups(selector: string): Array<Array<SelectorItem>> {
+	public static getSelectorGroups(
+		selector: string,
+		options?: { ignoreErrors?: boolean }
+	): Array<Array<SelectorItem>> {
+		const ignoreErrors = options?.ignoreErrors;
 		if (selector === '*') {
-			return [[new SelectorItem({ tagName: '*' })]];
+			return [[new SelectorItem({ tagName: '*', ignoreErrors })]];
 		}
 
 		const simpleMatch = selector.match(SIMPLE_SELECTOR_REGEXP);
 
 		if (simpleMatch) {
 			if (simpleMatch[1]) {
-				return [[new SelectorItem({ tagName: selector.toUpperCase() })]];
+				return [[new SelectorItem({ tagName: selector.toUpperCase(), ignoreErrors })]];
 			} else if (simpleMatch[2]) {
-				return [[new SelectorItem({ classNames: selector.replace('.', '').split('.') })]];
+				return [
+					[new SelectorItem({ classNames: selector.replace('.', '').split('.'), ignoreErrors })]
+				];
 			} else if (simpleMatch[3]) {
-				return [[new SelectorItem({ id: selector.replace('#', '') })]];
+				return [[new SelectorItem({ id: selector.replace('#', ''), ignoreErrors })]];
 			}
 		}
 
 		const regexp = new RegExp(SELECTOR_REGEXP);
 		let currentSelectorItem: SelectorItem = new SelectorItem({
-			combinator: SelectorCombinatorEnum.descendant
+			combinator: SelectorCombinatorEnum.descendant,
+			ignoreErrors
 		});
 		let currentGroup: SelectorItem[] = [currentSelectorItem];
 		const groups: Array<Array<SelectorItem>> = [currentGroup];
@@ -147,34 +161,40 @@ export default class SelectorParser {
 					});
 				} else if (match[13] && match[14]) {
 					currentSelectorItem.pseudos = currentSelectorItem.pseudos || [];
-					currentSelectorItem.pseudos.push(this.getPseudo(match[13], match[14]));
+					currentSelectorItem.pseudos.push(this.getPseudo(match[13], match[14], options));
 				} else if (match[15]) {
 					currentSelectorItem.pseudos = currentSelectorItem.pseudos || [];
-					currentSelectorItem.pseudos.push(this.getPseudo(match[15]));
+					currentSelectorItem.pseudos.push(this.getPseudo(match[15], null, options));
 				} else if (match[16]) {
 					currentSelectorItem.isPseudoElement = true;
 				} else if (match[17]) {
 					switch (match[17].trim()) {
 						case ',':
 							currentSelectorItem = new SelectorItem({
-								combinator: SelectorCombinatorEnum.descendant
+								combinator: SelectorCombinatorEnum.descendant,
+								ignoreErrors
 							});
 							currentGroup = [currentSelectorItem];
 							groups.push(currentGroup);
 							break;
 						case '>':
-							currentSelectorItem = new SelectorItem({ combinator: SelectorCombinatorEnum.child });
+							currentSelectorItem = new SelectorItem({
+								combinator: SelectorCombinatorEnum.child,
+								ignoreErrors
+							});
 							currentGroup.push(currentSelectorItem);
 							break;
 						case '+':
 							currentSelectorItem = new SelectorItem({
-								combinator: SelectorCombinatorEnum.adjacentSibling
+								combinator: SelectorCombinatorEnum.adjacentSibling,
+								ignoreErrors
 							});
 							currentGroup.push(currentSelectorItem);
 							break;
 						case '':
 							currentSelectorItem = new SelectorItem({
-								combinator: SelectorCombinatorEnum.descendant
+								combinator: SelectorCombinatorEnum.descendant,
+								ignoreErrors
 							});
 							currentGroup.push(currentSelectorItem);
 							break;
@@ -186,6 +206,9 @@ export default class SelectorParser {
 		}
 
 		if (!isValid) {
+			if (options?.ignoreErrors) {
+				return [];
+			}
 			throw new DOMException(`Invalid selector: "${selector}"`);
 		}
 
@@ -241,9 +264,15 @@ export default class SelectorParser {
 	 *
 	 * @param name Pseudo name.
 	 * @param args Pseudo arguments.
+	 * @param [options] Options.
+	 * @param [options.ignoreErrors] Ignores errors.
 	 * @returns Pseudo.
 	 */
-	private static getPseudo(name: string, args?: string): ISelectorPseudo {
+	private static getPseudo(
+		name: string,
+		args?: string,
+		options?: { ignoreErrors?: boolean }
+	): ISelectorPseudo {
 		const lowerName = name.toLowerCase();
 
 		if (!args) {
@@ -256,7 +285,9 @@ export default class SelectorParser {
 				const nthOfIndex = args.indexOf(' of ');
 				const nthFunction = nthOfIndex !== -1 ? args.substring(0, nthOfIndex) : args;
 				const selectorItem =
-					nthOfIndex !== -1 ? this.getSelectorItem(args.substring(nthOfIndex + 4).trim()) : null;
+					nthOfIndex !== -1
+						? this.getSelectorItem(args.substring(nthOfIndex + 4).trim(), options)
+						: null;
 				return {
 					name: lowerName,
 					arguments: args,
@@ -275,12 +306,12 @@ export default class SelectorParser {
 				return {
 					name: lowerName,
 					arguments: args,
-					selectorItems: [this.getSelectorItem(args)],
+					selectorItems: [this.getSelectorItem(args, options)],
 					nthFunction: null
 				};
 			case 'is':
 			case 'where':
-				const selectorGroups = this.getSelectorGroups(args);
+				const selectorGroups = this.getSelectorGroups(args, options);
 				const selectorItems = [];
 				for (const group of selectorGroups) {
 					selectorItems.push(group[0]);