Function add

source/feature-manager.tsx:156–238

(url: string, ...loaders: FeatureLoader[])

}

async function add(url: string, ...loaders: FeatureLoader[]): Promise<void> {
	const id = getFeatureId(url);

	/* Feature filtering and running */
	const options = await globalReady;

	// Skip disabled features, unless the feature is private
	if (isFeatureDisabled(options, id) && !isFeaturePrivate(id)) {
		if (loaders.length === 0) {
			// CSS-only https://github.com/refined-github/refined-github/issues/7944
			// GitHub cleans up the CSS disabling attributes after navigation.
			// https://github.com/refined-github/refined-github/issues/8172
			do {
				document.documentElement.setAttribute('rgh-OFF-' + id, '');
				log.info('↩️', 'Skipping', id);
			} while (await oneEvent(document, 'turbo:render'));
		} else {
			log.info('↩️', 'Skipping', id);
		}

		return;
	}

	if (loaders.length === 0) {
		// CSS-only
		return;
	}

	void asyncForEach(loaders, async loader => {
		// Input defaults and validation
		const {
			shortcuts = {},
			asLongAs,
			include,
			exclude,
			init,
			awaitDomReady = false,
			requiresToken = false,
			deduplicate = false,
		} = loader;

		if (include?.length === 0) {
			throw new Error(`${id}: \`include\` cannot be an empty array, it means "run nowhere"`);
		}

		let isFirstLoop = true;
		do {
			if (awaitDomReady) {
				await domLoaded;
			}

			if (isFirstLoop) {
				isFirstLoop = false;
			} else if (deduplicate !== false && elementExists(deduplicate)) {
				continue;
			}

			if (!await shouldFeatureRun({asLongAs, include, exclude})) {