1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
import {$} from 'select-dom';
import {setFetch} from 'push-form';
// Nodes may be exactly `null`
import {type Nullable} from 'vitest';
// `content.fetch` is Firefox’s way to make fetches from the page instead of from a different context
// This will set the correct `origin` header without having to use XMLHttpRequest
// https://stackoverflow.com/questions/47356375/firefox-fetch-api-how-to-omit-the-origin-header-in-the-request
// https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#XHR_and_Fetch
if (window.content?.fetch) {
setFetch(window.content.fetch);
}
/**
* Append to an element, but before a element that might not exist.
* @param parent Element (or its selector) to which append the `child`
* @param before Selector of the element that `child` should be inserted before
* @param child Element to append
* @example
*
* <parent>
* <yes/>
* <oui/>
* <nope/>
* </parent>
*
* appendBefore('parent', 'nope', <sì/>);
*
* <parent>
* <yes/>
* <oui/>
* <sì/>
* <nope/>
* </parent>
*/
export const appendBefore = (parent: string | Element, before: string, child: Element): void => {
if (typeof parent === 'string') {
parent = $(parent)!;
}
// Select direct children only
const beforeElement = $(`:scope > :is(${before})`, parent);
if (beforeElement) {
beforeElement.before(child);
} else {
parent.append(child);
}
};
export const wrap = (target: Element | ChildNode, wrapper: Element): void => {
target.before(wrapper);
wrapper.append(target);
};
export const wrapAll = <Wrapper extends Element>(targets: Iterable<Element | ChildNode>, wrapper: Wrapper): Wrapper => {
const [first, ...rest] = targets;
first.before(wrapper);
wrapper.append(first, ...rest);
return wrapper;
};
export const isEditable = (node: unknown): boolean => node instanceof HTMLTextAreaElement
|| node instanceof HTMLInputElement
|| (node instanceof HTMLElement && node.isContentEditable);
export const frame = async (): Promise<number> => new Promise(resolve => {
requestAnimationFrame(resolve);
});
export const highlightTab = (tabElement: Element): void => {
tabElement.classList.add('selected');
tabElement.setAttribute('aria-current', 'page');
};
export const unhighlightTab = (tabElement: Element): void => {
tabElement.classList.remove('selected');
tabElement.removeAttribute('aria-current');
};
const matchString = (matcher: RegExp | string, string: string): boolean =>
typeof matcher === 'string' ? matcher === string : matcher.test(string);
const escapeMatcher = (matcher: RegExp | string): string =>
typeof matcher === 'string' ? `"${matcher}"` : String(matcher);
const isTextNode = (node: Text | ChildNode): boolean =>
node instanceof Text || ([...node.childNodes].every(childNode => childNode instanceof Text));
export const isTextNodeContaining = (node: Nullable<Text | ChildNode>, expectation: RegExp | string): boolean => {
// Make sure only text is being considered, not links, icons, etc
if (!node || !isTextNode(node)) {
console.warn('TypeError', node);
throw new TypeError(`Expected Text node, received ${String(node?.nodeName)}`);
}
const content = node.textContent.trim();
return matchString(expectation, content);
};
export const assertNodeContent = <N extends Text | ChildNode>(node: Nullable<N>, expectation: RegExp | string): N => {
if (isTextNodeContaining(node, expectation)) {
return node!;
}
console.warn('Error', node!.parentElement);
const content = node!.textContent.trim();
throw new Error(`Expected node matching ${escapeMatcher(expectation)}, found ${escapeMatcher(content)}`);
};
export const removeTextNodeContaining = (node: Text | ChildNode, expectation: RegExp | string): void => {
assertNodeContent(node, expectation);
node.remove();
};
|
