Method hitBreakpoint

src/test/debug_client_ms.ts:497–542

* Returns a promise that will resolve if a configurable breakpoint has been hit within some time * and the event's reason and line number was asserted. * The promise will be rejected if a timeout occurs, the assertions fail, or if the requests fails.

(launchArgs: any, location: ILocation, expectedStopLocation?: IPartialLocation, expectedBPLocation?: IPartialLocation, skipWaiting = false)

	 * The promise will be rejected if a timeout occurs, the assertions fail, or if the requests fails.
	 */
	public hitBreakpoint(launchArgs: any, location: ILocation, expectedStopLocation?: IPartialLocation, expectedBPLocation?: IPartialLocation, skipWaiting = false): Promise<any> {

		// If we're an attach request, we'll automatically pause at startup, so we need to wait for that then resume before asserting
		// the stop.
		const setupBreakpointWait = launchArgs.request === "attach"
			? async () => {
				const event = await this.waitForEvent("stopped", "hitBreakpoint") as DebugProtocol.StoppedEvent;
				// Allow either step (old DC DA) or entry (SDK DA).
				if (event.body.reason !== "step")
					assert.equal(event.body.reason, "entry");

				// We don't need to send a resume, as this is done in the launch method; we can just wait.
				return this.assertStoppedLocation('breakpoint', expectedStopLocation || location);
			}
			: () => this.assertStoppedLocation('breakpoint', expectedStopLocation || location);

		return Promise.all([

			this.waitForEvent('initialized', 'hitBreakpoint').then(event => {
				return this.setBreakpointsRequest({
					lines: [location.line],
					breakpoints: [{ line: location.line, column: location.column }],
					source: { path: location.path }
				});
			}).then(response => {

				const bp = response.body.breakpoints[0];

				if (typeof location.verified === 'boolean')
					assert.equal(bp.verified, location.verified, 'breakpoint verification mismatch: verified');

				const actualLocation: ILocation = {
					column: bp.column,
					line: bp.line!,
					path: bp.source && bp.source.path
				};
				this.assertPartialLocationsEqual(actualLocation, expectedBPLocation || location);

				return this.configurationDone();
			}),

			skipWaiting ? Promise.resolve(undefined) : setupBreakpointWait(),

			this.launch(launchArgs),
		]);
	}
}