happy-dom 14.3.2 → 14.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of happy-dom might be problematic. Click here for more details.

Files changed (147) hide show
  1. package/cjs/browser/Browser.cjs +1 -1
  2. package/cjs/browser/Browser.cjs.map +1 -1
  3. package/cjs/browser/BrowserSettingsFactory.cjs +1 -1
  4. package/cjs/browser/BrowserSettingsFactory.cjs.map +1 -1
  5. package/cjs/browser/BrowserSettingsFactory.d.ts +1 -1
  6. package/cjs/browser/BrowserSettingsFactory.d.ts.map +1 -1
  7. package/cjs/browser/detached-browser/DetachedBrowser.cjs +1 -1
  8. package/cjs/browser/detached-browser/DetachedBrowser.cjs.map +1 -1
  9. package/cjs/browser/utilities/BrowserFrameFactory.cjs +1 -1
  10. package/cjs/browser/utilities/BrowserFrameFactory.cjs.map +1 -1
  11. package/cjs/browser/utilities/BrowserFrameFactory.d.ts +1 -1
  12. package/cjs/browser/utilities/BrowserFrameFactory.d.ts.map +1 -1
  13. package/cjs/css/declaration/element-style/CSSStyleDeclarationElementStyle.cjs +5 -3
  14. package/cjs/css/declaration/element-style/CSSStyleDeclarationElementStyle.cjs.map +1 -1
  15. package/cjs/css/declaration/element-style/CSSStyleDeclarationElementStyle.d.ts.map +1 -1
  16. package/cjs/nodes/element/{Dataset.cjs → DatasetFactory.cjs} +16 -36
  17. package/cjs/nodes/element/DatasetFactory.cjs.map +1 -0
  18. package/cjs/nodes/element/DatasetFactory.d.ts +15 -0
  19. package/cjs/nodes/element/DatasetFactory.d.ts.map +1 -0
  20. package/cjs/nodes/element/DatasetUtility.cjs +36 -0
  21. package/cjs/nodes/element/DatasetUtility.cjs.map +1 -0
  22. package/{lib/nodes/element/Dataset.d.ts → cjs/nodes/element/DatasetUtility.d.ts} +3 -14
  23. package/cjs/nodes/element/DatasetUtility.d.ts.map +1 -0
  24. package/cjs/nodes/element/Element.cjs +2 -2
  25. package/cjs/nodes/element/Element.cjs.map +1 -1
  26. package/cjs/nodes/element/IDataset.cjs +3 -0
  27. package/cjs/nodes/element/IDataset.cjs.map +1 -0
  28. package/cjs/nodes/element/IDataset.d.ts +4 -0
  29. package/cjs/nodes/element/IDataset.d.ts.map +1 -0
  30. package/cjs/nodes/html-element/HTMLElement.cjs +2 -2
  31. package/cjs/nodes/html-element/HTMLElement.cjs.map +1 -1
  32. package/cjs/nodes/html-element/HTMLElement.d.ts +2 -3
  33. package/cjs/nodes/html-element/HTMLElement.d.ts.map +1 -1
  34. package/cjs/nodes/html-iframe-element/HTMLIFrameElementPageLoader.cjs +1 -1
  35. package/cjs/nodes/html-iframe-element/HTMLIFrameElementPageLoader.cjs.map +1 -1
  36. package/cjs/nodes/svg-element/SVGElement.cjs +2 -2
  37. package/cjs/nodes/svg-element/SVGElement.cjs.map +1 -1
  38. package/cjs/nodes/svg-element/SVGElement.d.ts +2 -3
  39. package/cjs/nodes/svg-element/SVGElement.d.ts.map +1 -1
  40. package/cjs/query-selector/QuerySelector.cjs +10 -4
  41. package/cjs/query-selector/QuerySelector.cjs.map +1 -1
  42. package/cjs/query-selector/QuerySelector.d.ts +5 -1
  43. package/cjs/query-selector/QuerySelector.d.ts.map +1 -1
  44. package/cjs/query-selector/SelectorItem.cjs +9 -4
  45. package/cjs/query-selector/SelectorItem.cjs.map +1 -1
  46. package/cjs/query-selector/SelectorItem.d.ts +4 -1
  47. package/cjs/query-selector/SelectorItem.d.ts.map +1 -1
  48. package/cjs/query-selector/SelectorParser.cjs +39 -18
  49. package/cjs/query-selector/SelectorParser.cjs.map +1 -1
  50. package/cjs/query-selector/SelectorParser.d.ts +12 -2
  51. package/cjs/query-selector/SelectorParser.d.ts.map +1 -1
  52. package/cjs/storage/Storage.cjs +70 -10
  53. package/cjs/storage/Storage.cjs.map +1 -1
  54. package/cjs/storage/Storage.d.ts +10 -2
  55. package/cjs/storage/Storage.d.ts.map +1 -1
  56. package/cjs/storage/StorageFactory.cjs +93 -0
  57. package/cjs/storage/StorageFactory.cjs.map +1 -0
  58. package/cjs/storage/StorageFactory.d.ts +14 -0
  59. package/cjs/storage/StorageFactory.d.ts.map +1 -0
  60. package/cjs/window/BrowserWindow.cjs +3 -2
  61. package/cjs/window/BrowserWindow.cjs.map +1 -1
  62. package/cjs/window/BrowserWindow.d.ts.map +1 -1
  63. package/lib/browser/Browser.js +1 -1
  64. package/lib/browser/Browser.js.map +1 -1
  65. package/lib/browser/BrowserSettingsFactory.d.ts +1 -1
  66. package/lib/browser/BrowserSettingsFactory.d.ts.map +1 -1
  67. package/lib/browser/BrowserSettingsFactory.js +1 -1
  68. package/lib/browser/BrowserSettingsFactory.js.map +1 -1
  69. package/lib/browser/detached-browser/DetachedBrowser.js +1 -1
  70. package/lib/browser/detached-browser/DetachedBrowser.js.map +1 -1
  71. package/lib/browser/utilities/BrowserFrameFactory.d.ts +1 -1
  72. package/lib/browser/utilities/BrowserFrameFactory.d.ts.map +1 -1
  73. package/lib/browser/utilities/BrowserFrameFactory.js +1 -1
  74. package/lib/browser/utilities/BrowserFrameFactory.js.map +1 -1
  75. package/lib/css/declaration/element-style/CSSStyleDeclarationElementStyle.d.ts.map +1 -1
  76. package/lib/css/declaration/element-style/CSSStyleDeclarationElementStyle.js +5 -3
  77. package/lib/css/declaration/element-style/CSSStyleDeclarationElementStyle.js.map +1 -1
  78. package/lib/nodes/element/DatasetFactory.d.ts +15 -0
  79. package/lib/nodes/element/DatasetFactory.d.ts.map +1 -0
  80. package/lib/nodes/element/{Dataset.js → DatasetFactory.js} +12 -35
  81. package/lib/nodes/element/DatasetFactory.js.map +1 -0
  82. package/{cjs/nodes/element/Dataset.d.ts → lib/nodes/element/DatasetUtility.d.ts} +3 -14
  83. package/lib/nodes/element/DatasetUtility.d.ts.map +1 -0
  84. package/lib/nodes/element/DatasetUtility.js +33 -0
  85. package/lib/nodes/element/DatasetUtility.js.map +1 -0
  86. package/lib/nodes/element/Element.js +2 -2
  87. package/lib/nodes/element/Element.js.map +1 -1
  88. package/lib/nodes/element/IDataset.d.ts +4 -0
  89. package/lib/nodes/element/IDataset.d.ts.map +1 -0
  90. package/lib/nodes/element/IDataset.js +2 -0
  91. package/lib/nodes/element/IDataset.js.map +1 -0
  92. package/lib/nodes/html-element/HTMLElement.d.ts +2 -3
  93. package/lib/nodes/html-element/HTMLElement.d.ts.map +1 -1
  94. package/lib/nodes/html-element/HTMLElement.js +2 -2
  95. package/lib/nodes/html-element/HTMLElement.js.map +1 -1
  96. package/lib/nodes/html-iframe-element/HTMLIFrameElementPageLoader.js +1 -1
  97. package/lib/nodes/html-iframe-element/HTMLIFrameElementPageLoader.js.map +1 -1
  98. package/lib/nodes/svg-element/SVGElement.d.ts +2 -3
  99. package/lib/nodes/svg-element/SVGElement.d.ts.map +1 -1
  100. package/lib/nodes/svg-element/SVGElement.js +2 -2
  101. package/lib/nodes/svg-element/SVGElement.js.map +1 -1
  102. package/lib/query-selector/QuerySelector.d.ts +5 -1
  103. package/lib/query-selector/QuerySelector.d.ts.map +1 -1
  104. package/lib/query-selector/QuerySelector.js +10 -4
  105. package/lib/query-selector/QuerySelector.js.map +1 -1
  106. package/lib/query-selector/SelectorItem.d.ts +4 -1
  107. package/lib/query-selector/SelectorItem.d.ts.map +1 -1
  108. package/lib/query-selector/SelectorItem.js +9 -4
  109. package/lib/query-selector/SelectorItem.js.map +1 -1
  110. package/lib/query-selector/SelectorParser.d.ts +12 -2
  111. package/lib/query-selector/SelectorParser.d.ts.map +1 -1
  112. package/lib/query-selector/SelectorParser.js +39 -18
  113. package/lib/query-selector/SelectorParser.js.map +1 -1
  114. package/lib/storage/Storage.d.ts +10 -2
  115. package/lib/storage/Storage.d.ts.map +1 -1
  116. package/lib/storage/Storage.js +49 -11
  117. package/lib/storage/Storage.js.map +1 -1
  118. package/lib/storage/StorageFactory.d.ts +14 -0
  119. package/lib/storage/StorageFactory.d.ts.map +1 -0
  120. package/lib/storage/StorageFactory.js +64 -0
  121. package/lib/storage/StorageFactory.js.map +1 -0
  122. package/lib/window/BrowserWindow.d.ts.map +1 -1
  123. package/lib/window/BrowserWindow.js +3 -2
  124. package/lib/window/BrowserWindow.js.map +1 -1
  125. package/package.json +1 -1
  126. package/src/browser/Browser.ts +1 -1
  127. package/src/browser/BrowserSettingsFactory.ts +1 -1
  128. package/src/browser/detached-browser/DetachedBrowser.ts +1 -1
  129. package/src/browser/utilities/BrowserFrameFactory.ts +1 -1
  130. package/src/css/declaration/element-style/CSSStyleDeclarationElementStyle.ts +5 -3
  131. package/src/nodes/element/{Dataset.ts → DatasetFactory.ts} +20 -49
  132. package/src/nodes/element/DatasetUtility.ts +33 -0
  133. package/src/nodes/element/Element.ts +2 -2
  134. package/src/nodes/element/IDataset.ts +3 -0
  135. package/src/nodes/html-element/HTMLElement.ts +5 -4
  136. package/src/nodes/html-iframe-element/HTMLIFrameElementPageLoader.ts +1 -1
  137. package/src/nodes/svg-element/SVGElement.ts +5 -4
  138. package/src/query-selector/QuerySelector.ts +15 -4
  139. package/src/query-selector/SelectorItem.ts +15 -4
  140. package/src/query-selector/SelectorParser.ts +49 -18
  141. package/src/storage/Storage.ts +56 -12
  142. package/src/storage/StorageFactory.ts +66 -0
  143. package/src/window/BrowserWindow.ts +3 -2
  144. package/cjs/nodes/element/Dataset.cjs.map +0 -1
  145. package/cjs/nodes/element/Dataset.d.ts.map +0 -1
  146. package/lib/nodes/element/Dataset.d.ts.map +0 -1
  147. package/lib/nodes/element/Dataset.js.map +0 -1
@@ -1,42 +1,39 @@
1
1
  import Element from './Element.js';
2
2
  import * as PropertySymbol from '../../PropertySymbol.js';
3
3
  import HTMLElementNamedNodeMap from '../html-element/HTMLElementNamedNodeMap.js';
4
+ import DatasetUtility from './DatasetUtility.js';
5
+ import IDataset from './IDataset.js';
4
6
 
5
7
  /**
6
- * Storage type for a dataset proxy.
7
- */
8
- type DatasetRecord = Record<string, string>;
9
-
10
- /**
11
- * Dataset helper proxy.
8
+ * Dataset factory.
12
9
  *
13
10
  * Reference:
14
11
  * https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset
15
12
  */
16
- export default class Dataset {
17
- public readonly proxy: DatasetRecord;
18
-
13
+ export default class DatasetFactory {
19
14
  /**
20
15
  * @param element The parent element.
21
16
  */
22
- constructor(element: Element) {
17
+ public static createDataset(element: Element): IDataset {
23
18
  // Build the initial dataset record from all data attributes.
24
- const dataset: DatasetRecord = {};
19
+ const dataset: IDataset = {};
25
20
 
26
21
  for (let i = 0, max = element[PropertySymbol.attributes].length; i < max; i++) {
27
22
  const attribute = element[PropertySymbol.attributes][i];
28
23
  if (attribute[PropertySymbol.name].startsWith('data-')) {
29
- const key = Dataset.kebabToCamelCase(attribute[PropertySymbol.name].replace('data-', ''));
24
+ const key = DatasetUtility.kebabToCamelCase(
25
+ attribute[PropertySymbol.name].replace('data-', '')
26
+ );
30
27
  dataset[key] = attribute[PropertySymbol.value];
31
28
  }
32
29
  }
33
30
 
34
31
  // Documentation for Proxy:
35
32
  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy
36
- this.proxy = new Proxy(dataset, {
37
- get(dataset: DatasetRecord, key: string): string {
33
+ return new Proxy(dataset, {
34
+ get(dataset: IDataset, key: string): string {
38
35
  const attribute = element[PropertySymbol.attributes].getNamedItem(
39
- 'data-' + Dataset.camelCaseToKebab(key)
36
+ 'data-' + DatasetUtility.camelCaseToKebab(key)
40
37
  );
41
38
  if (attribute) {
42
39
  return (dataset[key] = attribute[PropertySymbol.value]);
@@ -44,18 +41,18 @@ export default class Dataset {
44
41
  delete dataset[key];
45
42
  return undefined;
46
43
  },
47
- set(dataset: DatasetRecord, key: string, value: string): boolean {
48
- element.setAttribute('data-' + Dataset.camelCaseToKebab(key), value);
44
+ set(dataset: IDataset, key: string, value: string): boolean {
45
+ element.setAttribute('data-' + DatasetUtility.camelCaseToKebab(key), value);
49
46
  dataset[key] = value;
50
47
  return true;
51
48
  },
52
- deleteProperty(dataset: DatasetRecord, key: string): boolean {
49
+ deleteProperty(dataset: IDataset, key: string): boolean {
53
50
  (<HTMLElementNamedNodeMap>element[PropertySymbol.attributes])[
54
51
  PropertySymbol.removeNamedItem
55
- ]('data-' + Dataset.camelCaseToKebab(key));
52
+ ]('data-' + DatasetUtility.camelCaseToKebab(key));
56
53
  return delete dataset[key];
57
54
  },
58
- ownKeys(dataset: DatasetRecord): string[] {
55
+ ownKeys(dataset: IDataset): string[] {
59
56
  // According to Mozilla we have to update the dataset object (target) to contain the same keys as what we return:
60
57
  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/ownKeys
61
58
  // "The result List must contain the keys of all non-configurable own properties of the target object."
@@ -64,7 +61,7 @@ export default class Dataset {
64
61
  for (let i = 0, max = element[PropertySymbol.attributes].length; i < max; i++) {
65
62
  const attribute = element[PropertySymbol.attributes][i];
66
63
  if (attribute[PropertySymbol.name].startsWith('data-')) {
67
- const key = Dataset.kebabToCamelCase(
64
+ const key = DatasetUtility.kebabToCamelCase(
68
65
  attribute[PropertySymbol.name].replace('data-', '')
69
66
  );
70
67
  keys.push(key);
@@ -79,37 +76,11 @@ export default class Dataset {
79
76
  }
80
77
  return keys;
81
78
  },
82
- has(_dataset: DatasetRecord, key: string): boolean {
79
+ has(_dataset: IDataset, key: string): boolean {
83
80
  return !!element[PropertySymbol.attributes].getNamedItem(
84
- 'data-' + Dataset.camelCaseToKebab(key)
81
+ 'data-' + DatasetUtility.camelCaseToKebab(key)
85
82
  );
86
83
  }
87
84
  });
88
85
  }
89
-
90
- /**
91
- * Transforms a kebab cased string to camel case.
92
- *
93
- * @param text Text string.
94
- * @returns Camel cased string.
95
- */
96
- public static kebabToCamelCase(text: string): string {
97
- const parts = text.split('-');
98
- for (let i = 0, max = parts.length; i < max; i++) {
99
- parts[i] = i > 0 ? parts[i].charAt(0).toUpperCase() + parts[i].slice(1) : parts[i];
100
- }
101
- return parts.join('');
102
- }
103
-
104
- /**
105
- * Transforms a camel cased string to kebab case.
106
- *
107
- * @param text Text string.
108
- * @returns Kebab cased string.
109
- */
110
- public static camelCaseToKebab(text: string): string {
111
- return text
112
- .toString()
113
- .replace(/[A-Z]+(?![a-z])|[A-Z]/g, ($, ofs) => (ofs ? '-' : '') + $.toLowerCase());
114
- }
115
86
  }
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Dataset utility.
3
+ *
4
+ * Reference:
5
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset
6
+ */
7
+ export default class DatasetUtility {
8
+ /**
9
+ * Transforms a kebab cased string to camel case.
10
+ *
11
+ * @param text Text string.
12
+ * @returns Camel cased string.
13
+ */
14
+ public static kebabToCamelCase(text: string): string {
15
+ const parts = text.split('-');
16
+ for (let i = 0, max = parts.length; i < max; i++) {
17
+ parts[i] = i > 0 ? parts[i].charAt(0).toUpperCase() + parts[i].slice(1) : parts[i];
18
+ }
19
+ return parts.join('');
20
+ }
21
+
22
+ /**
23
+ * Transforms a camel cased string to kebab case.
24
+ *
25
+ * @param text Text string.
26
+ * @returns Kebab cased string.
27
+ */
28
+ public static camelCaseToKebab(text: string): string {
29
+ return text
30
+ .toString()
31
+ .replace(/[A-Z]+(?![a-z])|[A-Z]/g, ($, ofs) => (ofs ? '-' : '') + $.toLowerCase());
32
+ }
33
+ }
@@ -851,7 +851,7 @@ export default class Element
851
851
  * @returns "true" if matching.
852
852
  */
853
853
  public matches(selector: string): boolean {
854
- return !!QuerySelector.match(this, selector);
854
+ return !!QuerySelector.matches(this, selector);
855
855
  }
856
856
 
857
857
  /**
@@ -865,7 +865,7 @@ export default class Element
865
865
  let parent: Element = this;
866
866
 
867
867
  while (parent) {
868
- if (QuerySelector.match(parent, selector)) {
868
+ if (QuerySelector.matches(parent, selector)) {
869
869
  return parent;
870
870
  }
871
871
  parent = parent.parentElement;
@@ -0,0 +1,3 @@
1
+ export default interface IDataset {
2
+ [key: string]: string;
3
+ }
@@ -2,7 +2,6 @@ import Element from '../element/Element.js';
2
2
  import * as PropertySymbol from '../../PropertySymbol.js';
3
3
  import CSSStyleDeclaration from '../../css/declaration/CSSStyleDeclaration.js';
4
4
  import PointerEvent from '../../event/events/PointerEvent.js';
5
- import Dataset from '../element/Dataset.js';
6
5
  import NodeTypeEnum from '../node/NodeTypeEnum.js';
7
6
  import DOMException from '../../exception/DOMException.js';
8
7
  import Event from '../../event/Event.js';
@@ -12,6 +11,8 @@ import HTMLElementNamedNodeMap from './HTMLElementNamedNodeMap.js';
12
11
  import NodeList from '../node/NodeList.js';
13
12
  import Node from '../node/Node.js';
14
13
  import HTMLCollection from '../element/HTMLCollection.js';
14
+ import DatasetFactory from '../element/DatasetFactory.js';
15
+ import IDataset from '../element/IDataset.js';
15
16
 
16
17
  /**
17
18
  * HTML Element.
@@ -63,7 +64,7 @@ export default class HTMLElement extends Element {
63
64
  public [PropertySymbol.style]: CSSStyleDeclaration = null;
64
65
 
65
66
  // Private properties
66
- #dataset: Dataset = null;
67
+ #dataset: IDataset = null;
67
68
  #customElementDefineCallback: () => void = null;
68
69
 
69
70
  /**
@@ -353,8 +354,8 @@ export default class HTMLElement extends Element {
353
354
  *
354
355
  * @returns Data set.
355
356
  */
356
- public get dataset(): { [key: string]: string } {
357
- return (this.#dataset ??= new Dataset(this)).proxy;
357
+ public get dataset(): IDataset {
358
+ return (this.#dataset ??= DatasetFactory.createDataset(this));
358
359
  }
359
360
 
360
361
  /**
@@ -76,7 +76,7 @@ export default class HTMLIFrameElementPageLoader {
76
76
  const parentWindow = isSameOrigin ? window : new CrossOriginBrowserWindow(window);
77
77
 
78
78
  this.#browserIFrame =
79
- this.#browserIFrame ?? BrowserFrameFactory.newChildFrame(this.#browserParentFrame);
79
+ this.#browserIFrame ?? BrowserFrameFactory.createChildFrame(this.#browserParentFrame);
80
80
 
81
81
  (<BrowserWindow | CrossOriginBrowserWindow>(<unknown>this.#browserIFrame.window.top)) =
82
82
  parentWindow;
@@ -3,10 +3,11 @@ import * as PropertySymbol from '../../PropertySymbol.js';
3
3
  import Element from '../element/Element.js';
4
4
  import SVGSVGElement from './SVGSVGElement.js';
5
5
  import Event from '../../event/Event.js';
6
- import Dataset from '../element/Dataset.js';
7
6
  import HTMLElementUtility from '../html-element/HTMLElementUtility.js';
8
7
  import NamedNodeMap from '../../named-node-map/NamedNodeMap.js';
9
8
  import SVGElementNamedNodeMap from './SVGElementNamedNodeMap.js';
9
+ import DatasetFactory from '../element/DatasetFactory.js';
10
+ import IDataset from '../element/IDataset.js';
10
11
 
11
12
  /**
12
13
  * SVG Element.
@@ -28,7 +29,7 @@ export default class SVGElement extends Element {
28
29
  public [PropertySymbol.style]: CSSStyleDeclaration | null = null;
29
30
 
30
31
  // Private properties
31
- #dataset: Dataset = null;
32
+ #dataset: IDataset = null;
32
33
 
33
34
  /**
34
35
  * Returns viewport.
@@ -61,8 +62,8 @@ export default class SVGElement extends Element {
61
62
  *
62
63
  * @returns Data set.
63
64
  */
64
- public get dataset(): { [key: string]: string } {
65
- return (this.#dataset ??= new Dataset(this)).proxy;
65
+ public get dataset(): IDataset {
66
+ return (this.#dataset ??= DatasetFactory.createDataset(this));
66
67
  }
67
68
 
68
69
  /**
@@ -198,9 +198,15 @@ export default class QuerySelector {
198
198
  *
199
199
  * @param element Element to match.
200
200
  * @param selector Selector to match with.
201
+ * @param [options] Options.
202
+ * @param [options.ignoreErrors] Ignores errors.
201
203
  * @returns Result.
202
204
  */
203
- public static match(element: Element, selector: string): ISelectorMatch | null {
205
+ public static matches(
206
+ element: Element,
207
+ selector: string,
208
+ options?: { ignoreErrors?: boolean }
209
+ ): ISelectorMatch | null {
204
210
  if (!selector) {
205
211
  return null;
206
212
  }
@@ -211,14 +217,19 @@ export default class QuerySelector {
211
217
  };
212
218
  }
213
219
 
220
+ const ignoreErrors = options?.ignoreErrors;
221
+
214
222
  if (INVALID_SELECTOR_REGEXP.test(selector)) {
223
+ if (ignoreErrors) {
224
+ return null;
225
+ }
215
226
  throw new Error(
216
- `Failed to execute 'match' on '${element.constructor.name}': '${selector}' is not a valid selector.`
227
+ `Failed to execute 'matches' on '${element.constructor.name}': '${selector}' is not a valid selector.`
217
228
  );
218
229
  }
219
230
 
220
- for (const items of SelectorParser.getSelectorGroups(selector)) {
221
- const result = this.matchSelector(element, element, items.reverse());
231
+ for (const items of SelectorParser.getSelectorGroups(selector, options)) {
232
+ const result = this.matchSelector(element, element, items.reverse(), 0);
222
233
 
223
234
  if (result) {
224
235
  return result;
@@ -18,6 +18,7 @@ export default class SelectorItem {
18
18
  public pseudos: ISelectorPseudo[] | null;
19
19
  public isPseudoElement: boolean;
20
20
  public combinator: SelectorCombinatorEnum;
21
+ public ignoreErrors: boolean;
21
22
 
22
23
  /**
23
24
  * Constructor.
@@ -30,6 +31,7 @@ export default class SelectorItem {
30
31
  * @param [options.attributes] Attributes.
31
32
  * @param [options.pseudos] Pseudos.
32
33
  * @param [options.isPseudoElement] Is pseudo element.
34
+ * @param [options.ignoreErrors] Ignore errors.
33
35
  */
34
36
  constructor(options?: {
35
37
  tagName?: string;
@@ -39,6 +41,7 @@ export default class SelectorItem {
39
41
  pseudos?: ISelectorPseudo[];
40
42
  isPseudoElement?: boolean;
41
43
  combinator?: SelectorCombinatorEnum;
44
+ ignoreErrors?: boolean;
42
45
  }) {
43
46
  this.tagName = options?.tagName || null;
44
47
  this.id = options?.id || null;
@@ -47,6 +50,7 @@ export default class SelectorItem {
47
50
  this.pseudos = options?.pseudos || null;
48
51
  this.isPseudoElement = options?.isPseudoElement || false;
49
52
  this.combinator = options?.combinator || SelectorCombinatorEnum.descendant;
53
+ this.ignoreErrors = options?.ignoreErrors || false;
50
54
  }
51
55
 
52
56
  /**
@@ -98,7 +102,7 @@ export default class SelectorItem {
98
102
 
99
103
  // Pseudo match
100
104
  if (this.pseudos) {
101
- const result = this.matchPsuedo(element);
105
+ const result = this.matchPseudo(element);
102
106
  if (!result) {
103
107
  return null;
104
108
  }
@@ -114,7 +118,7 @@ export default class SelectorItem {
114
118
  * @param element Element.
115
119
  * @returns Result.
116
120
  */
117
- private matchPsuedo(element: Element): ISelectorMatch | null {
121
+ private matchPseudo(element: Element): ISelectorMatch | null {
118
122
  const parent = <Element>element[PropertySymbol.parentNode];
119
123
  const parentChildren = element[PropertySymbol.parentNode]
120
124
  ? (<Element>element[PropertySymbol.parentNode])[PropertySymbol.children]
@@ -135,7 +139,14 @@ export default class SelectorItem {
135
139
  case 'nth-last-child':
136
140
  case 'nth-last-of-type':
137
141
  if (!pseudo.arguments) {
138
- throw new DOMException(`The selector "${this.getSelectorString()}" is not valid.`);
142
+ if (this.ignoreErrors) {
143
+ return null;
144
+ }
145
+ throw new DOMException(
146
+ `Failed to execute 'matches' on '${
147
+ element.constructor.name
148
+ }': '${this.getSelectorString()}' is not a valid selector.`
149
+ );
139
150
  }
140
151
  break;
141
152
  }
@@ -357,7 +368,7 @@ export default class SelectorItem {
357
368
  * @returns Selector string.
358
369
  */
359
370
  private getSelectorString(): string {
360
- return `${this.tagName || ''}${this.id ? `#${this.id}` : ''}${
371
+ return `${this.tagName ? this.tagName.toLowerCase() : ''}${this.id ? `#${this.id}` : ''}${
361
372
  this.classNames ? `.${this.classNames.join('.')}` : ''
362
373
  }${
363
374
  this.attributes
@@ -63,38 +63,52 @@ export default class SelectorParser {
63
63
  * Parses a selector string and returns an instance of SelectorItem.
64
64
  *
65
65
  * @param selector Selector.
66
+ * @param [options] Options.
67
+ * @param [options.ignoreErrors] Ignores errors.
66
68
  * @returns Selector item.
67
69
  */
68
- public static getSelectorItem(selector: string): SelectorItem {
69
- return this.getSelectorGroups(selector)[0][0];
70
+ public static getSelectorItem(
71
+ selector: string,
72
+ options?: { ignoreErrors?: boolean }
73
+ ): SelectorItem {
74
+ return this.getSelectorGroups(selector, options)[0][0];
70
75
  }
71
76
 
72
77
  /**
73
78
  * Parses a selector string and returns groups with SelectorItem instances.
74
79
  *
75
80
  * @param selector Selector.
81
+ * @param [options] Options.
82
+ * @param [options.ignoreErrors] Ignores errors.
76
83
  * @returns Selector groups.
77
84
  */
78
- public static getSelectorGroups(selector: string): Array<Array<SelectorItem>> {
85
+ public static getSelectorGroups(
86
+ selector: string,
87
+ options?: { ignoreErrors?: boolean }
88
+ ): Array<Array<SelectorItem>> {
89
+ const ignoreErrors = options?.ignoreErrors;
79
90
  if (selector === '*') {
80
- return [[new SelectorItem({ tagName: '*' })]];
91
+ return [[new SelectorItem({ tagName: '*', ignoreErrors })]];
81
92
  }
82
93
 
83
94
  const simpleMatch = selector.match(SIMPLE_SELECTOR_REGEXP);
84
95
 
85
96
  if (simpleMatch) {
86
97
  if (simpleMatch[1]) {
87
- return [[new SelectorItem({ tagName: selector.toUpperCase() })]];
98
+ return [[new SelectorItem({ tagName: selector.toUpperCase(), ignoreErrors })]];
88
99
  } else if (simpleMatch[2]) {
89
- return [[new SelectorItem({ classNames: selector.replace('.', '').split('.') })]];
100
+ return [
101
+ [new SelectorItem({ classNames: selector.replace('.', '').split('.'), ignoreErrors })]
102
+ ];
90
103
  } else if (simpleMatch[3]) {
91
- return [[new SelectorItem({ id: selector.replace('#', '') })]];
104
+ return [[new SelectorItem({ id: selector.replace('#', ''), ignoreErrors })]];
92
105
  }
93
106
  }
94
107
 
95
108
  const regexp = new RegExp(SELECTOR_REGEXP);
96
109
  let currentSelectorItem: SelectorItem = new SelectorItem({
97
- combinator: SelectorCombinatorEnum.descendant
110
+ combinator: SelectorCombinatorEnum.descendant,
111
+ ignoreErrors
98
112
  });
99
113
  let currentGroup: SelectorItem[] = [currentSelectorItem];
100
114
  const groups: Array<Array<SelectorItem>> = [currentGroup];
@@ -147,34 +161,40 @@ export default class SelectorParser {
147
161
  });
148
162
  } else if (match[13] && match[14]) {
149
163
  currentSelectorItem.pseudos = currentSelectorItem.pseudos || [];
150
- currentSelectorItem.pseudos.push(this.getPseudo(match[13], match[14]));
164
+ currentSelectorItem.pseudos.push(this.getPseudo(match[13], match[14], options));
151
165
  } else if (match[15]) {
152
166
  currentSelectorItem.pseudos = currentSelectorItem.pseudos || [];
153
- currentSelectorItem.pseudos.push(this.getPseudo(match[15]));
167
+ currentSelectorItem.pseudos.push(this.getPseudo(match[15], null, options));
154
168
  } else if (match[16]) {
155
169
  currentSelectorItem.isPseudoElement = true;
156
170
  } else if (match[17]) {
157
171
  switch (match[17].trim()) {
158
172
  case ',':
159
173
  currentSelectorItem = new SelectorItem({
160
- combinator: SelectorCombinatorEnum.descendant
174
+ combinator: SelectorCombinatorEnum.descendant,
175
+ ignoreErrors
161
176
  });
162
177
  currentGroup = [currentSelectorItem];
163
178
  groups.push(currentGroup);
164
179
  break;
165
180
  case '>':
166
- currentSelectorItem = new SelectorItem({ combinator: SelectorCombinatorEnum.child });
181
+ currentSelectorItem = new SelectorItem({
182
+ combinator: SelectorCombinatorEnum.child,
183
+ ignoreErrors
184
+ });
167
185
  currentGroup.push(currentSelectorItem);
168
186
  break;
169
187
  case '+':
170
188
  currentSelectorItem = new SelectorItem({
171
- combinator: SelectorCombinatorEnum.adjacentSibling
189
+ combinator: SelectorCombinatorEnum.adjacentSibling,
190
+ ignoreErrors
172
191
  });
173
192
  currentGroup.push(currentSelectorItem);
174
193
  break;
175
194
  case '':
176
195
  currentSelectorItem = new SelectorItem({
177
- combinator: SelectorCombinatorEnum.descendant
196
+ combinator: SelectorCombinatorEnum.descendant,
197
+ ignoreErrors
178
198
  });
179
199
  currentGroup.push(currentSelectorItem);
180
200
  break;
@@ -186,6 +206,9 @@ export default class SelectorParser {
186
206
  }
187
207
 
188
208
  if (!isValid) {
209
+ if (options?.ignoreErrors) {
210
+ return [];
211
+ }
189
212
  throw new DOMException(`Invalid selector: "${selector}"`);
190
213
  }
191
214
 
@@ -241,9 +264,15 @@ export default class SelectorParser {
241
264
  *
242
265
  * @param name Pseudo name.
243
266
  * @param args Pseudo arguments.
267
+ * @param [options] Options.
268
+ * @param [options.ignoreErrors] Ignores errors.
244
269
  * @returns Pseudo.
245
270
  */
246
- private static getPseudo(name: string, args?: string): ISelectorPseudo {
271
+ private static getPseudo(
272
+ name: string,
273
+ args?: string,
274
+ options?: { ignoreErrors?: boolean }
275
+ ): ISelectorPseudo {
247
276
  const lowerName = name.toLowerCase();
248
277
 
249
278
  if (!args) {
@@ -256,7 +285,9 @@ export default class SelectorParser {
256
285
  const nthOfIndex = args.indexOf(' of ');
257
286
  const nthFunction = nthOfIndex !== -1 ? args.substring(0, nthOfIndex) : args;
258
287
  const selectorItem =
259
- nthOfIndex !== -1 ? this.getSelectorItem(args.substring(nthOfIndex + 4).trim()) : null;
288
+ nthOfIndex !== -1
289
+ ? this.getSelectorItem(args.substring(nthOfIndex + 4).trim(), options)
290
+ : null;
260
291
  return {
261
292
  name: lowerName,
262
293
  arguments: args,
@@ -275,12 +306,12 @@ export default class SelectorParser {
275
306
  return {
276
307
  name: lowerName,
277
308
  arguments: args,
278
- selectorItems: [this.getSelectorItem(args)],
309
+ selectorItems: [this.getSelectorItem(args, options)],
279
310
  nthFunction: null
280
311
  };
281
312
  case 'is':
282
313
  case 'where':
283
- const selectorGroups = this.getSelectorGroups(args);
314
+ const selectorGroups = this.getSelectorGroups(args, options);
284
315
  const selectorItems = [];
285
316
  for (const group of selectorGroups) {
286
317
  selectorItems.push(group[0]);
@@ -1,16 +1,63 @@
1
+ import * as PropertySymbol from '../PropertySymbol.js';
2
+
1
3
  /**
2
4
  * Storage.
3
5
  *
4
6
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Storage
5
7
  */
6
8
  export default class Storage {
9
+ public [PropertySymbol.data]: { [key: string]: string } = {};
10
+
11
+ /**
12
+ *
13
+ */
14
+ constructor() {
15
+ const descriptors = Object.getOwnPropertyDescriptors(Storage.prototype);
16
+
17
+ Object.defineProperty(this, 'length', {
18
+ enumerable: false,
19
+ configurable: true,
20
+ get: descriptors['length'].get.bind(this)
21
+ });
22
+
23
+ Object.defineProperty(this, 'key', {
24
+ enumerable: false,
25
+ configurable: true,
26
+ value: descriptors['key'].value.bind(this)
27
+ });
28
+
29
+ Object.defineProperty(this, 'setItem', {
30
+ enumerable: false,
31
+ configurable: true,
32
+ value: descriptors['setItem'].value.bind(this)
33
+ });
34
+
35
+ Object.defineProperty(this, 'getItem', {
36
+ enumerable: false,
37
+ configurable: true,
38
+ value: descriptors['getItem'].value.bind(this)
39
+ });
40
+
41
+ Object.defineProperty(this, 'removeItem', {
42
+ enumerable: false,
43
+ configurable: true,
44
+ value: descriptors['removeItem'].value.bind(this)
45
+ });
46
+
47
+ Object.defineProperty(this, 'clear', {
48
+ enumerable: false,
49
+ configurable: true,
50
+ value: descriptors['clear'].value.bind(this)
51
+ });
52
+ }
53
+
7
54
  /**
8
55
  * Returns length.
9
56
  *
10
57
  * @returns Length.
11
58
  */
12
59
  public get length(): number {
13
- return Object.keys(this).length;
60
+ return Object.keys(this[PropertySymbol.data]).length;
14
61
  }
15
62
 
16
63
  /**
@@ -19,9 +66,9 @@ export default class Storage {
19
66
  * @param index Index.
20
67
  * @returns Name.
21
68
  */
22
- public key(index: number): string {
23
- const name = Object.keys(this)[index];
24
- return name === undefined ? null : name;
69
+ public key(index: number): string | null {
70
+ const name = Object.keys(this[PropertySymbol.data])[index];
71
+ return name !== undefined ? name : null;
25
72
  }
26
73
 
27
74
  /**
@@ -31,7 +78,7 @@ export default class Storage {
31
78
  * @param item Item.
32
79
  */
33
80
  public setItem(name: string, item: string): void {
34
- this[name] = String(item);
81
+ this[PropertySymbol.data][name] = String(item);
35
82
  }
36
83
 
37
84
  /**
@@ -40,8 +87,8 @@ export default class Storage {
40
87
  * @param name Name.
41
88
  * @returns Item.
42
89
  */
43
- public getItem(name: string): string {
44
- return this[name] === undefined ? null : this[name];
90
+ public getItem(name: string): string | null {
91
+ return this[PropertySymbol.data][name] !== undefined ? this[PropertySymbol.data][name] : null;
45
92
  }
46
93
 
47
94
  /**
@@ -50,16 +97,13 @@ export default class Storage {
50
97
  * @param name Name.
51
98
  */
52
99
  public removeItem(name: string): void {
53
- delete this[name];
100
+ delete this[PropertySymbol.data][name];
54
101
  }
55
102
 
56
103
  /**
57
104
  * Clears storage.
58
105
  */
59
106
  public clear(): void {
60
- const keys = Object.keys(this);
61
- for (const key of keys) {
62
- delete this[key];
63
- }
107
+ this[PropertySymbol.data] = {};
64
108
  }
65
109
  }