Method executeUserScript

src/engine/MacroChoiceEngine.ts:328–376

(command: IUserScript)

	// Slightly modified from Templater's user script engine:
	// https://github.com/SilentVoid13/Templater/blob/master/src/UserTemplates/UserTemplateParser.ts
	protected async executeUserScript(command: IUserScript) {
		// Member-aware key: preloaded values are DRILLED exports, so a command
		// drilling a different `::` member of the same file must never consume
		// another command's entry (see getUserScriptPreloadKey).
		const cacheKey = getUserScriptPreloadKey(command);
		let userScript: unknown;
		if (cacheKey !== undefined) {
			const cached = this.preloadedUserScripts.get(cacheKey);
			if (cached !== undefined) {
				userScript = cached;
				this.preloadedUserScripts.delete(cacheKey);
			}
		}

		if (userScript === undefined) {
			userScript = await getUserScript(command, this.app);
		}

		if (!userScript) {
			log.logError(`failed to load user script ${command.path}.`);
			return;
		}

		if (!command.settings) {
			command.settings = {};
		}

		const userScriptSettings = getUserScriptSettings(userScript);
		if (userScriptSettings) {
			// Initialize default values for settings before executing the script
			initializeUserScriptSettings(command.settings, userScriptSettings);
		}
		this.userScriptCommand = command;
		this.userScriptSettingsDefinition = userScriptSettings;

		try {
			await this.userScriptDelegator(userScript);
		} catch (err) {
			if (err instanceof MacroAbortError) {
				throw err;
			}
			// Report and re-throw script errors so users can debug them
			reportError(err, `Failed to run user script ${command.name}`);
			throw err;
		} finally {
			this.userScriptCommand = null;
			this.userScriptSettingsDefinition = undefined;
		}
	}

	private async getResolvedUserScriptSettings(command: IUserScript) {
		if (