abstractDebugAdapter.ts ×17

Frontier kind: Code frontier

unlabeled · c_d7003bd612a4

14 tests · 7055 LOC · 33 files · introduces 0 tests · 85 LOC · 1 file

Introduces — evidence that enters the hierarchy at this concept

Code
17 ranges85 lines · 1 files
Tests
0 tests

Contains — complete concept membership

All code (extent)
1029 ranges7055 lines · 33 files · Browse complete extent
All tests (intent)
14 testsBrowse complete intent

Neighbourhood graph

The orange circle is the focus. Violet and green circles are every ancestor and descendant, broader and narrower, at any distance; blue squares and pink diamonds are the introduced files and exact introduced tests of every visible concept, not only the focus's. Arrows point from broader to narrower concepts and bridge only concepts omitted from this view. Undirected links show source or test introduction. Concept and file size follows LOC; exact test nodes use test-count units.

Introduced files, introduced tests, and structurally relevant concept specialization

In the embedded map, ordinary wheel input scrolls the page; use the visible controls to zoom and drag to pan. Open the full-screen map for canvas navigation: wheel pans, Ctrl/Command plus wheel zooms, and arrow keys pan when this region is focused. On touch screens, open the full-screen map to pan or pinch. If JavaScript or WebGL is unavailable, use the native relationship evidence on this page.

Introduced files, introduced tests, and structurally relevant concept specializationdebugModel.ts ×5 · 39 introduced LOCdebugModel.ts ×5debugModel.ts ×1 · 13 introduced LOCdebugModel.ts ×1debugModel.ts ×1 · 8 introduced LOCdebugModel.ts ×1debugModel.ts ×6 · 20 introduced LOCdebugModel.ts ×6debugStorage.ts ×17 · 98 introduced LOCdebugStorage.ts ×17debugModel.ts ×3 · 29 introduced LOCdebugModel.ts ×3debugModel.ts ×2 · 11 introduced LOCdebugModel.ts ×2debugModel.ts ×2 · 12 introduced LOCdebugModel.ts ×2debugModel.ts ×2 · 13 introduced LOCdebugModel.ts ×2mockDebug.ts ×1 · 2 introduced LOCmockDebug.ts ×1mockDebug.ts ×1 · 2 introduced LOCmockDebug.ts ×1mockDebug.ts ×7 · 30 introduced LOCmockDebug.ts ×7abstractDebugAdapter.ts ×4 · 18 introduced LOCabstractDebugAdapter.ts …debugModel.ts ×1 · 1 introduced LOCdebugModel.ts ×1debugModel.ts ×185 · 988 introduced LOCdebugModel.ts ×185debugAdapter.ts ×16 · 67 introduced LOCdebugAdapter.ts ×16debugger.ts ×3 · 27 introduced LOCdebugger.ts ×3debugger.ts ×5 · 89 introduced LOCdebugger.ts ×5debugger.ts ×2 · 4 introduced LOCdebugger.ts ×2debugger.ts ×26 · 153 introduced LOCdebugger.ts ×26debugUtils.ts ×21 · 86 introduced LOCdebugUtils.ts ×21debugAdapter.ts ×2 · 4 introduced LOCdebugAdapter.ts ×2debugAdapter.ts ×2 · 4 introduced LOCdebugAdapter.ts ×2debugAdapter.ts ×9 · 88 introduced LOCdebugAdapter.ts ×9abstractDebugAdapter.ts ×5 · 31 introduced LOCabstractDebugAdapter.ts …abstractDebugAdapter.ts ×8 · 27 introduced LOCabstractDebugAdapter.ts …debugAdapter.ts ×16 · 89 introduced LOCdebugAdapter.ts ×16async.ts ×202 · 1247 introduced LOCasync.ts ×202resources.ts ×23 · 253 introduced LOCresources.ts ×23network.ts ×20 · 292 introduced LOCnetwork.ts ×20strings.test|title=Strings trimWhitespace|occurrence=1 · 0 introduced LOCstrings.test|title=Strin…extpath.ts ×17 · 91 introduced LOCextpath.ts ×17strings.ts ×101 · 542 introduced LOCstrings.ts ×101cancellation.test|title=CancellationToken None|occurrence=1 · 0 introduced LOCcancellation.test|title=…cancellation.ts ×18 · 90 introduced LOCcancellation.ts ×18event.ts ×1 · 1 introduced LOCevent.ts ×1event.ts ×4 · 9 introduced LOCevent.ts ×4event.ts ×2 · 4 introduced LOCevent.ts ×2event.ts ×2 · 6 introduced LOCevent.ts ×2event.ts ×93 · 864 introduced LOCevent.ts ×93uri.test|title=URI URI#file, win-speciale|occurrence=1, charCode.test|title=CharCode has good values|occurrence=1, +2 · 0 introduced LOCuri.test|title=URI URI#f…utils.ts ×3 · 9 introduced LOCutils.ts ×3linkedList.ts ×13 · 44 introduced LOClinkedList.ts ×13objects.ts ×13 · 65 introduced LOCobjects.ts ×13lifecycle.ts ×2 · 4 introduced LOClifecycle.ts ×2lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1lifecycle.ts ×4 · 8 introduced LOClifecycle.ts ×4lifecycle.ts ×6 · 16 introduced LOClifecycle.ts ×6lazy.ts ×1 · 2 introduced LOClazy.ts ×1lazy.ts ×3 · 37 introduced LOClazy.ts ×3lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1uint.ts ×2 · 43 introduced LOCuint.ts ×2lifecycle.ts ×1 · 3 introduced LOClifecycle.ts ×1map.ts ×97 · 3334 introduced LOCmap.ts ×97src/vs/base/common/arrays.ts · 949 LOCcommon/arrays.tssrc/vs/base/common/arraysFind.ts · 226 LOCcommon/arraysFind.tssrc/vs/base/common/assert.ts · 91 LOCcommon/assert.tssrc/vs/base/common/async.ts · 2749 LOCcommon/async.tssrc/vs/base/common/cache.ts · 153 LOCcommon/cache.tssrc/vs/base/common/cancellation.ts · 206 LOCcommon/cancellation.tssrc/vs/base/common/charCode.ts · 450 LOCcommon/charCode.tssrc/vs/base/common/collections.ts · 176 LOCcommon/collections.tssrc/vs/base/common/errors.ts · 357 LOCcommon/errors.tssrc/vs/base/common/event.ts · 1964 LOCcommon/event.tssrc/vs/base/common/extpath.ts · 433 LOCcommon/extpath.tssrc/vs/base/common/functional.ts · 32 LOCcommon/functional.tssrc/vs/base/common/iterator.ts · 194 LOCcommon/iterator.tssrc/vs/base/common/lazy.ts · 57 LOCcommon/lazy.tssrc/vs/base/common/lifecycle.ts · 974 LOCcommon/lifecycle.tssrc/vs/base/common/linkedList.ts · 151 LOCcommon/linkedList.tssrc/vs/base/common/map.ts · 1016 LOCcommon/map.tssrc/vs/base/common/marshallingIds.ts · 33 LOCcommon/marshallingIds.tssrc/vs/base/common/network.ts · 440 LOCcommon/network.tssrc/vs/base/common/objects.ts · 286 LOCcommon/objects.tssrc/vs/base/common/path.ts · 1589 LOCcommon/path.tssrc/vs/base/common/platform.ts · 281 LOCcommon/platform.tssrc/vs/base/common/process.ts · 76 LOCcommon/process.tssrc/vs/base/common/resources.ts · 444 LOCcommon/resources.tssrc/vs/base/common/stopwatch.ts · 41 LOCcommon/stopwatch.tssrc/vs/base/common/strings.ts · 1413 LOCcommon/strings.tssrc/vs/base/common/symbols.ts · 9 LOCcommon/symbols.tssrc/vs/base/common/types.ts · 410 LOCcommon/types.tssrc/vs/base/common/uint.ts · 59 LOCcommon/uint.tssrc/vs/base/common/uri.ts · 754 LOCcommon/uri.tssrc/vs/base/test/common/mock.ts · 47 LOCcommon/mock.tssrc/vs/base/test/common/utils.ts · 107 LOCcommon/utils.tssrc/vs/nls.ts · 244 LOCvs/nls.tssrc/vs/platform/configuration/test/common/testConfigurationService.ts · 91 LOCcommon/testConfiguration…src/vs/workbench/contrib/debug/common/abstractDebugAdapter.ts · 226 LOCcommon/abstractDebugAdap…src/vs/workbench/contrib/debug/common/debugModel.ts · 2158 LOCcommon/debugModel.tssrc/vs/workbench/contrib/debug/common/debugSource.ts · 165 LOCcommon/debugSource.tssrc/vs/workbench/contrib/debug/common/debugStorage.ts · 189 LOCcommon/debugStorage.tssrc/vs/workbench/contrib/debug/common/debugUtils.ts · 445 LOCcommon/debugUtils.tssrc/vs/workbench/contrib/debug/common/debugger.ts · 325 LOCcommon/debugger.tssrc/vs/workbench/contrib/debug/common/disassemblyViewInput.ts · 45 LOCcommon/disassemblyViewIn…src/vs/workbench/contrib/debug/node/debugAdapter.ts · 404 LOCnode/debugAdapter.tssrc/vs/workbench/contrib/debug/test/common/mockDebug.ts · 697 LOCcommon/mockDebug.tssrc/vs/workbench/services/configurationResolver/common/configurationResolverUtils.ts · 12 LOCcommon/configurationReso…cancellation.test|title=CancellationToken None|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/cancellation.test|title=CancellationToken None|occurrence=1cancellation.test|title=…charCode.test|title=CharCode has good values|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/charCode.test|title=CharCode has good values|occurrence=1charCode.test|title=Char…path.test|title=Paths (Node Implementation) path|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/path.test|title=Paths (Node Implementation) path|occurrence=1path.test|title=Paths (N…strings.test|title=Strings trimWhitespace|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/strings.test|title=Strings trimWhitespace|occurrence=1strings.test|title=Strin…uri.test|title=URI File paths containing apostrophes break URI parsing and cannot be opened #276075|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/uri.test|title=URI File paths containing apostrophes break URI parsing and cannot be opened #276075|occurrence=1uri.test|title=URI File …uri.test|title=URI URI#file, win-speciale|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/uri.test|title=URI URI#file, win-speciale|occurrence=1uri.test|title=URI URI#f…abstractDebugAdapter.test|title=Debug - AbstractDebugAdapter event ordering does not insert boundaries between events|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/abstractDebugAdapter.test|title=Debug - AbstractDebugAdapter event ordering does not insert boundaries between events|occurrence=1abstractDebugAdapter.tes…abstractDebugAdapter.test|title=Debug - AbstractDebugAdapter event ordering inserts task boundary after response|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/abstractDebugAdapter.test|title=Debug - AbstractDebugAdapter event ordering inserts task boundary after response|occurrence=1abstractDebugAdapter.tes…abstractDebugAdapter.test|title=Debug - AbstractDebugAdapter event ordering inserts task boundary before response|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/abstractDebugAdapter.test|title=Debug - AbstractDebugAdapter event ordering inserts task boundary before response|occurrence=1abstractDebugAdapter.tes…debugModel.test|title=DebugModel DebugModel refreshTopOfCallstack resolves all returned promises when called multiple times|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/debugModel.test|title=DebugModel DebugModel refreshTopOfCallstack resolves all returned promises when called multiple times|occurrence=1debugModel.test|title=De…debugModel.test|title=DebugModel ExceptionBreakpoint Restored matches new|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/debugModel.test|title=DebugModel ExceptionBreakpoint Restored matches new|occurrence=1debugModel.test|title=De…debugModel.test|title=DebugModel FunctionBreakpoint Id is saved|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/debugModel.test|title=DebugModel FunctionBreakpoint Id is saved|occurrence=1debugModel.test|title=De…debugModel.test|title=DebugModel InstructionBreakpoint removeInstructionBreakpoints falls back to instructionReference+offset when address not supplied|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/debugModel.test|title=DebugModel InstructionBreakpoint removeInstructionBreakpoints falls back to instructionReference+offset when address not supplied|occurrence=1debugModel.test|title=De…debugModel.test|title=DebugModel InstructionBreakpoint removeInstructionBreakpoints prefers address match when instructionReference has changed|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/debugModel.test|title=DebugModel InstructionBreakpoint removeInstructionBreakpoints prefers address match when instructionReference has changed|occurrence=1debugModel.test|title=De…debugModel.test|title=DebugModel InstructionBreakpoint removeInstructionBreakpoints with only address removes the matching entry and leaves others|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/common/debugModel.test|title=DebugModel InstructionBreakpoint removeInstructionBreakpoints with only address removes the matching entry and leaves others|occurrence=1debugModel.test|title=De…debugger.test|title=Debug - Debugger attributes|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/node/debugger.test|title=Debug - Debugger attributes|occurrence=1debugger.test|title=Debu…debugger.test|title=Debug - Debugger getSchemaAttributes logs malformed properties and ignores them|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/node/debugger.test|title=Debug - Debugger getSchemaAttributes logs malformed properties and ignores them|occurrence=1debugger.test|title=Debu…debugger.test|title=Debug - Debugger initial config file content|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/node/debugger.test|title=Debug - Debugger initial config file content|occurrence=1debugger.test|title=Debu…streamDebugAdapter.test|title=Debug - StreamDebugAdapter StreamDebugAdapter (NamedPipeDebugAdapter) can initialize a connection|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/node/streamDebugAdapter.test|title=Debug - StreamDebugAdapter StreamDebugAdapter (NamedPipeDebugAdapter) can initialize a connection|occurrence=1streamDebugAdapter.test|…streamDebugAdapter.test|title=Debug - StreamDebugAdapter StreamDebugAdapter (SocketDebugAdapter) can initialize a connection|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/workbench/contrib/debug/test/node/streamDebugAdapter.test|title=Debug - StreamDebugAdapter StreamDebugAdapter (SocketDebugAdapter) can initialize a connection|occurrence=1streamDebugAdapter.test|…Focused concept · abstractDebugAdapter.ts ×17 · 85 introduced LOCabstractDebugAdapter.ts …

Graph controls are ready.

Interactive rendering requires JavaScript and WebGL. Use the native relationship evidence on this page while the interactive map is unavailable.

Native relationship evidence

Every exact file and test below is linked only from the concept that introduces it.

Introduced tests

Every collected test enters the hierarchy at exactly one concept.

No tests are introduced at this concept. Its intent tests are introduced by other concepts.

Introduced code

Every collected source range enters the hierarchy at exactly one concept.

1 file ranked by introduced lines: 85 introduced LOC across 17 ranges. Expand a file to inspect source; the > gutter marks introduced lines.

src/vs/workbench/contrib/debug/common/abstractDebugAdapter.ts 85 introduced LOC · 17 ranges

Open complete file

1 > /*--------------------------------------------------------------------------------------------- abstractDebugAdapter.ts
2 > * Copyright (c) Microsoft Corporation. All rights reserved.
3 > * Licensed under the MIT License. See License.txt in the project root for license information.
4 > *--------------------------------------------------------------------------------------------*/
5 >
6 > import { Emitter, Event } from '../../../../base/common/event.js';
7 > import { IDebugAdapter } from './debug.js';
8 > import { timeout } from '../../../../base/common/async.js';
9 > import { localize } from '../../../../nls.js';
10 >
11 > /**
12 > * Abstract implementation of the low level API for a debug adapter.
13 > * Missing is how this API communicates with the debug adapter.
14 > */
15 > export abstract class AbstractDebugAdapter implements IDebugAdapter {
16 > private sequence: number;
17 > private pendingRequests = new Map<number, (e: DebugProtocol.Response) => void>();
18 > private pendingRequestTimers = new Map<number, Timeout>();
19 > private requestCallback: ((request: DebugProtocol.Request) => void) | undefined;
20 > private eventCallback: ((request: DebugProtocol.Event) => void) | undefined;
21 > private messageCallback: ((message: DebugProtocol.ProtocolMessage) => void) | undefined;
22 > private queue: DebugProtocol.ProtocolMessage[] = [];
23 > protected readonly _onError = new Emitter<Error>();
24 > protected readonly _onExit = new Emitter<number | null>();
25 >
26 > constructor() {
27 this.sequence = 1;
28 }
30 > abstract startSession(): Promise<void>;
31 >
32 > abstract stopSession(): Promise<void>;
33 >
34 > abstract sendMessage(message: DebugProtocol.ProtocolMessage): void;
35 >
36 > get onError(): Event<Error> {
37 return this._onError.event;
38 }
40 > get onExit(): Event<number | null> {
41 return this._onExit.event;
42 }
44 > onMessage(callback: (message: DebugProtocol.ProtocolMessage) => void): void {
45 if (this.messageCallback) {
46 this._onError.fire(new Error(`attempt to set more than one 'Message' callback`));
48 this.messageCallback = callback;
49 }
51 > onEvent(callback: (event: DebugProtocol.Event) => void): void {
52 if (this.eventCallback) {
53 this._onError.fire(new Error(`attempt to set more than one 'Event' callback`));
55 this.eventCallback = callback;
56 }
58 > onRequest(callback: (request: DebugProtocol.Request) => void): void {
59 if (this.requestCallback) {
60 this._onError.fire(new Error(`attempt to set more than one 'Request' callback`));
62 this.requestCallback = callback;
63 }
65 > sendResponse(response: DebugProtocol.Response): void {
66 if (response.seq > 0) {
67 this._onError.fire(new Error(`attempt to send more than one response for command ${response.command}`));
70 }
71 }
73 > sendRequest(command: string, args: any, clb: (result: DebugProtocol.Response) => void, timeout?: number): number {
74 const request: any = {
75 command: command
105 return request.seq;
106 }
108 > acceptMessage(message: DebugProtocol.ProtocolMessage): void {
109 if (this.messageCallback) {
110 this.messageCallback(message);
117 }
118 }
120 > /**
121 > * Returns whether we should insert a timeout between processing messageA
122 > * and messageB. Artificially queueing protocol messages guarantees that any
123 > * microtasks for previous message finish before next message is processed.
124 > * This is essential ordering when using promises anywhere along the call path.
125 > *
126 > * For example, take the following, where `chooseAndSendGreeting` returns
127 > * a person name and then emits a greeting event:
128 > *
129 > * ```
130 > * let person: string;
131 > * adapter.onGreeting(() => console.log('hello', person));
132 > * person = await adapter.chooseAndSendGreeting();
133 > * ```
134 > *
135 > * Because the event is dispatched synchronously, it may fire before person
136 > * is assigned if they're processed in the same task. Inserting a task
137 > * boundary avoids this issue.
138 > */
139 > protected needsTaskBoundaryBetween(messageA: DebugProtocol.ProtocolMessage, messageB: DebugProtocol.ProtocolMessage) {
140 return messageA.type !== 'event' || messageB.type !== 'event';
141 }
143 > /**
144 > * Reads and dispatches items from the queue until it is empty.
145 > */
146 > private async processQueue() {
147 let message: DebugProtocol.ProtocolMessage | undefined;
148 while (this.queue.length) {
176 }
177 }
179 > private internalSend(typ: 'request' | 'response' | 'event', message: DebugProtocol.ProtocolMessage): void {
180 message.type = typ;
181 message.seq = this.sequence++;
182 this.sendMessage(message);
183 }
185 > protected async cancelPendingRequests(): Promise<void> {
186 if (this.pendingRequests.size === 0) {
187 return Promise.resolve();
205 });
206 }
208 > private clearPendingRequestTimer(requestSeq: number): void {
209 clearTimeout(this.pendingRequestTimers.get(requestSeq));
210 this.pendingRequestTimers.delete(requestSeq);
211 }
213 > getPendingRequestIds(): number[] {
214 return Array.from(this.pendingRequests.keys());
215 }
217 > dispose(): void {
218 for (const timer of this.pendingRequestTimers.values()) {
219 clearTimeout(timer);