1
>
/*---------------------------------------------------------------------------------------------
extensions.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 { Event } from '../../../../base/common/event.js';
7
>
import { Disposable, IDisposable, toDisposable } from '../../../../base/common/lifecycle.js';
8
>
import { raceTimeout } from '../../../../base/common/async.js';
9
>
import Severity from '../../../../base/common/severity.js';
10
>
import { URI } from '../../../../base/common/uri.js';
11
>
import { IMessagePassingProtocol } from '../../../../base/parts/ipc/common/ipc.js';
12
>
import { IAssignmentService } from '../../../../platform/assignment/common/assignment.js';
13
>
import { getExtensionId, getGalleryExtensionId } from '../../../../platform/extensionManagement/common/extensionManagementUtil.js';
14
>
import { ImplicitActivationEvents } from '../../../../platform/extensionManagement/common/implicitActivationEvents.js';
15
>
import { ExtensionIdentifier, ExtensionIdentifierMap, ExtensionIdentifierSet, ExtensionType, IExtension, IExtensionContributions, IExtensionDescription, TargetPlatform } from '../../../../platform/extensions/common/extensions.js';
16
>
import { ApiProposalName } from '../../../../platform/extensions/common/extensionsApiProposals.js';
17
>
import { createDecorator } from '../../../../platform/instantiation/common/instantiation.js';
18
>
import { IV8Profile } from '../../../../platform/profiling/common/profiling.js';
19
>
import { ExtensionHostKind } from './extensionHostKind.js';
20
>
import { IExtensionDescriptionDelta, IExtensionDescriptionSnapshot } from './extensionHostProtocol.js';
21
>
import { ExtensionRunningLocation } from './extensionRunningLocation.js';
22
>
import { IExtensionPoint } from './extensionsRegistry.js';
23
>
24
>
export const nullExtensionDescription = Object.freeze<IExtensionDescription>({
25
>
identifier: new ExtensionIdentifier('nullExtensionDescription'),
26
>
name: 'Null Extension Description',
27
>
version: '0.0.0',
28
>
publisher: 'vscode',
29
>
engines: { vscode: '' },
30
>
extensionLocation: URI.parse('void:location'),
31
>
isBuiltin: false,
32
>
targetPlatform: TargetPlatform.UNDEFINED,
33
>
isUserBuiltin: false,
34
>
isUnderDevelopment: false,
35
>
preRelease: false,
36
>
});
37
>
38
>
export type WebWorkerExtHostConfigValue = boolean | 'auto';
39
>
export const webWorkerExtHostConfig = 'extensions.webWorker';
40
>
41
>
export const IExtensionService = createDecorator<IExtensionService>('extensionService');
42
>
43
>
export interface IMessage {
44
>
type: Severity;
45
>
message: string;
46
>
extensionId: ExtensionIdentifier;
47
>
extensionPointId: string;
48
>
}
49
>
50
>
export interface IExtensionsStatus {
51
>
id: ExtensionIdentifier;
52
>
messages: IMessage[];
53
>
activationStarted: boolean;
54
>
activationTimes: ActivationTimes | undefined;
55
>
runtimeErrors: Error[];
56
>
runningLocation: ExtensionRunningLocation | null;
57
>
}
58
>
59
>
export class MissingExtensionDependency {
60
>
constructor(readonly dependency: string) { }
61
>
}
62
>
63
>
/**
64
>
* e.g.
65
>
* ```
66
>
* {
67
>
* startTime: 1511954813493000,
68
>
* endTime: 1511954835590000,
69
>
* deltas: [ 100, 1500, 123456, 1500, 100000 ],
70
>
* ids: [ 'idle', 'self', 'extension1', 'self', 'idle' ]
71
>
* }
72
>
* ```
73
>
*/
74
>
export interface IExtensionHostProfile {
75
>
/**
76
>
* Profiling start timestamp in microseconds.
77
>
*/
78
>
startTime: number;
79
>
/**
80
>
* Profiling end timestamp in microseconds.
81
>
*/
82
>
endTime: number;
83
>
/**
84
>
* Duration of segment in microseconds.
85
>
*/
86
>
deltas: number[];
87
>
/**
88
>
* Segment identifier: extension id or one of the four known strings.
89
>
*/
90
>
ids: ProfileSegmentId[];
91
>
92
>
/**
93
>
* Get the information as a .cpuprofile.
94
>
*/
95
>
data: IV8Profile;
96
>
97
>
/**
98
>
* Get the aggregated time per segmentId
99
>
*/
100
>
getAggregatedTimes(): Map<ProfileSegmentId, number>;
101
>
}
102
>
103
>
export const enum ExtensionHostStartup {
104
>
/**
105
>
* The extension host should be launched immediately and doesn't require a `$startExtensionHost` call.
106
>
*/
107
>
EagerAutoStart = 1,
108
>
/**
109
>
* The extension host should be launched immediately and needs a `$startExtensionHost` call.
110
>
*/
111
>
EagerManualStart = 2,
112
>
/**
113
>
* The extension host should be launched lazily and only when it has extensions it needs to host. It doesn't require a `$startExtensionHost` call.
114
>
*/
115
>
LazyAutoStart = 3,
116
>
}
117
>
118
>
export interface IExtensionInspectInfo {
119
>
readonly port: number;
120
>
readonly host: string;
121
>
readonly devtoolsUrl?: string;
122
>
readonly devtoolsLabel?: string;
123
>
}
124
>
125
>
export interface IExtensionHost {
126
>
readonly pid: number | null;
127
>
readonly runningLocation: ExtensionRunningLocation;
128
>
readonly remoteAuthority: string | null;
129
>
readonly startup: ExtensionHostStartup;
130
>
/**
131
>
* A collection of extensions which includes information about which
132
>
* extension will execute or is executing on this extension host.
133
>
* **NOTE**: this will reflect extensions correctly only after `start()` resolves.
134
>
*/
135
>
readonly extensions: ExtensionHostExtensions | null;
136
>
readonly onExit: Event<[number, string | null]>;
137
>
138
>
start(): Promise<IMessagePassingProtocol>;
139
>
getInspectPort(): IExtensionInspectInfo | undefined;
140
>
enableInspectPort(): Promise<boolean>;
141
>
disconnect?(): Promise<void>;
142
>
dispose(): void;
143
>
}
144
>
145
>
export class ExtensionHostExtensions {
146
>
private _versionId: number;
147
>
private _allExtensions: IExtensionDescription[];
148
>
private _myExtensions: ExtensionIdentifier[];
149
>
private _myActivationEvents: Set<string> | null;
150
>
151
>
public get versionId(): number {
152
return this._versionId;
153
}
155
>
public get allExtensions(): IExtensionDescription[] {
156
return this._allExtensions;
157
}
159
>
public get myExtensions(): ExtensionIdentifier[] {
160
return this._myExtensions;
161
}
163
>
constructor(versionId: number, allExtensions: readonly IExtensionDescription[], myExtensions: ExtensionIdentifier[]) {
164
this._versionId = versionId;
165
this._allExtensions = allExtensions.slice(0);