Method spawn

src/extension/sdk/dev_tools/manager.ts:218–263

(session: (DartDebugSessionInformation & { vmServiceUri: string }) | undefined, options: DevToolsOptions, forceShow: boolean)

	/// Spawns DevTools and returns the full URL to open for that session
	///   eg. http://127.0.0.1:8123/?port=8543
	public async spawn(session: (DartDebugSessionInformation & { vmServiceUri: string }) | undefined, options: DevToolsOptions, forceShow: boolean): Promise<{ url: string; dispose: () => void } | undefined> {
		this.analytics.logDevToolsOpened(options?.commandSource);

		const url = await this.start();
		if (!url)
			return;

		if (options.location === undefined)
			options.location = this.getDevToolsLocation(options.pageId);
		if (options.reuseWindows === undefined)
			options.reuseWindows = config.devToolsReuseWindows;

		// When we're running embedded and were asked to open without a page, we should prompt for a page (plus give an option
		// to open non-embedded view).
		if (options.location !== "external" && !options.pageId) {
			const choice = await this.promptForDevToolsPage(!!session);
			if (!choice) // User cancelled
				return;
			else if (choice === "EXTERNAL")
				options.location = "external";
			else
				options.pageId = choice.page.id;
		}

		try {
			await vs.window.withProgress({
				location: vs.ProgressLocation.Notification,
				title: "Opening DevTools...",
			}, async () => {
				const debugCommands = this.debugCommands;
				const canLaunchDevToolsThroughService = isRunningLocally
					&& session
					&& debugCommands
					&& options.location === "external"
					&& !isDartCodeTestRun
					&& config.devToolsBrowser === "chrome"
					&& await waitFor(() => debugCommands.vmServices.serviceIsRegistered(VmService.LaunchDevTools), 500);

				await this.launch(!!canLaunchDevToolsThroughService, session, options, forceShow);
			});

			return { url, dispose: () => this.dispose() };
		} catch (e) {
			this.showError(e);
		}
	}

	private async promptForDevToolsPage(hasSession: boolean): Promise<{ page: DevToolsPage } | "EXTERNAL" | undefined> {
		const choices: Array<vs.QuickPickItem & { page?: DevToolsPage; isExternal?: boolean }> = [