Method launch

src/test/dart_debug_client.ts:147–235

(launchArgs: DartVsCodeLaunchArgs & DebugProtocol.LaunchRequestArguments)

	}

	public async launch(launchArgs: DartVsCodeLaunchArgs & DebugProtocol.LaunchRequestArguments): Promise<void> {
		const configuration = Object.assign(
			{
				name: "Dart & Flutter",
				request: "launch",
				type: "dart",
			},
			launchArgs,
		);
		const currentSession = this.currentSession = {
			configuration,
			customRequest: async (cmd, args) => (await this.customRequest(cmd, args)).body as unknown,
			getDebugProtocolBreakpoint: () => { throw new Error("Not implemented for tests"); },
			id: `INTEGRATION-TEST-${getRandomInt(0x1000, 0x10000).toString(16)}`,
			name: configuration.name,
			type: configuration.type,
			workspaceFolder: undefined,
		};

		// The new DAP doesn't default to breaking on any exceptions so to simplify tests
		// set it based on whether we'd in debug mode or not.
		const isDebugging = !(launchArgs.noDebug ?? false);
		if (isDebugging)
			await this.setExceptionBreakpointsRequest({ filters: ["Unhandled"] });

		// Set up logging.
		for (const trackerFactory of this.debugTrackerFactories) {
			const tracker = await trackerFactory.createDebugAdapterTracker(currentSession);
			if (tracker) {
				this.currentTrackers.push(tracker);
				if (tracker.onWillStartSession)
					tracker.onWillStartSession();
			}
		}
		this.on("terminated", () => {
			for (const tracker of this.currentTrackers) {
				if (tracker.onWillStopSession)
					tracker.onWillStopSession();
			}
		});

		this.debugCommands.handleDebugSessionStart(currentSession);
		this.waitForEvent("terminated", "for handleDebugSessionEnd", tenMinutesInMs)
			.then(() => {
				this.debugCommands.handleDebugSessionEnd(currentSession);
				privateApi.testController?.handleDebugSessionEnd(currentSession);
			})
			.catch((e) => console.error(`Error while waiting for termination: ${e}`));

		// We override the base method to swap for attachRequest when required, so that
		// all the existing methods that provide useful functionality but assume launching
		// (for ex. hitBreakpoint) can be used in attach tests.
		const response = await watchPromise("launch->initializeRequest", this.initializeRequest());
		if (response.body?.supportsConfigurationDoneRequest) {
			this._supportsConfigurationDoneRequest = true;
		}
		// Attach will be paused by default and issue a step when we connect; but our tests
		// generally assume we will automatically resume.