Function waitForElement

source/helpers/selector-observer.tsx:115–136

(
	selectors: Selector | readonly Selector[],
	{signal, stopOnDomReady}: Options = {},
)

}

export async function waitForElement<
	Selector extends string,
	ExpectedElement extends ParseSelector<Selector, HTMLElement | SVGElement>,
>(
	selectors: Selector | readonly Selector[],
	{signal, stopOnDomReady}: Options = {},
): Promise<ExpectedElement | void> {
	return new Promise<ExpectedElement | void>(resolve => {
		observe<Selector, ExpectedElement>(selectors, element => {
			resolve(element);
		}, {
			signal,
			stopOnDomReady,
			once: true,
			ancestor: 4,
		});

		signal?.addEventListener('abort', () => {
			resolve();
		});
	});
}