/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the MIT License. See License.txt in the project root for license information. *--------------------------------------------------------------------------------------------*/ import { Emitter, Event } from 'vs/base/common/event'; import { URI } from 'vs/base/common/uri'; import * as modes from 'vs/editor/common/modes'; import { IExtensionDescription } from 'vs/platform/extensions/common/extensions'; import { ILogService } from 'vs/platform/log/common/log'; import { IExtHostApiDeprecationService } from 'vs/workbench/api/common/extHostApiDeprecationService'; import { IExtHostWorkspace } from 'vs/workbench/api/common/extHostWorkspace'; import { asWebviewUri, WebviewInitData } from 'vs/workbench/api/common/shared/webview'; import type * as vscode from 'vscode'; import * as extHostProtocol from './extHost.protocol'; export class ExtHostWebview implements vscode.Webview { readonly #handle: extHostProtocol.WebviewHandle; readonly #proxy: extHostProtocol.MainThreadWebviewsShape; readonly #deprecationService: IExtHostApiDeprecationService; readonly #initData: WebviewInitData; readonly #workspace: IExtHostWorkspace | undefined; readonly #extension: IExtensionDescription; #html: string = ''; #options: vscode.WebviewOptions; #isDisposed: boolean = false; #hasCalledAsWebviewUri = false; constructor( handle: extHostProtocol.WebviewHandle, proxy: extHostProtocol.MainThreadWebviewsShape, options: vscode.WebviewOptions, initData: WebviewInitData, workspace: IExtHostWorkspace | undefined, extension: IExtensionDescription, deprecationService: IExtHostApiDeprecationService, ) { this.#handle = handle; this.#proxy = proxy; this.#options = options; this.#initData = initData; this.#workspace = workspace; this.#extension = extension; this.#deprecationService = deprecationService; } /* internal */ readonly _onMessageEmitter = new Emitter(); public readonly onDidReceiveMessage: Event = this._onMessageEmitter.event; readonly #onDidDisposeEmitter = new Emitter(); /* internal */ readonly _onDidDispose: Event = this.#onDidDisposeEmitter.event; public dispose() { this.#isDisposed = true; this.#onDidDisposeEmitter.fire(); this.#onDidDisposeEmitter.dispose(); this._onMessageEmitter.dispose(); } public asWebviewUri(resource: vscode.Uri): vscode.Uri { this.#hasCalledAsWebviewUri = true; return asWebviewUri(this.#initData, this.#handle, resource); } public get cspSource(): string { return this.#initData.webviewCspSource .replace('{{uuid}}', this.#handle); } public get html(): string { this.assertNotDisposed(); return this.#html; } public set html(value: string) { this.assertNotDisposed(); if (this.#html !== value) { this.#html = value; if (!this.#hasCalledAsWebviewUri && /(["'])vscode-resource:([^\s'"]+?)(["'])/i.test(value)) { this.#hasCalledAsWebviewUri = true; this.#deprecationService.report('Webview vscode-resource: uris', this.#extension, `Please migrate to use the 'webview.asWebviewUri' api instead: https://aka.ms/vscode-webview-use-aswebviewuri`); } this.#proxy.$setHtml(this.#handle, value); } } public get options(): vscode.WebviewOptions { this.assertNotDisposed(); return this.#options; } public set options(newOptions: vscode.WebviewOptions) { this.assertNotDisposed(); this.#proxy.$setOptions(this.#handle, convertWebviewOptions(this.#extension, this.#workspace, newOptions)); this.#options = newOptions; } public async postMessage(message: any): Promise { if (this.#isDisposed) { return false; } return this.#proxy.$postMessage(this.#handle, message); } private assertNotDisposed() { if (this.#isDisposed) { throw new Error('Webview is disposed'); } } } export class ExtHostWebviews implements extHostProtocol.ExtHostWebviewsShape { private readonly _webviewProxy: extHostProtocol.MainThreadWebviewsShape; private readonly _webviews = new Map(); constructor( mainContext: extHostProtocol.IMainContext, private readonly initData: WebviewInitData, private readonly workspace: IExtHostWorkspace | undefined, private readonly _logService: ILogService, private readonly _deprecationService: IExtHostApiDeprecationService, ) { this._webviewProxy = mainContext.getProxy(extHostProtocol.MainContext.MainThreadWebviews); } public $onMessage( handle: extHostProtocol.WebviewHandle, message: any ): void { const webview = this.getWebview(handle); if (webview) { webview._onMessageEmitter.fire(message); } } public $onMissingCsp( _handle: extHostProtocol.WebviewHandle, extensionId: string ): void { this._logService.warn(`${extensionId} created a webview without a content security policy: https://aka.ms/vscode-webview-missing-csp`); } public createNewWebview(handle: string, options: modes.IWebviewOptions & modes.IWebviewPanelOptions, extension: IExtensionDescription): ExtHostWebview { const webview = new ExtHostWebview(handle, this._webviewProxy, reviveOptions(options), this.initData, this.workspace, extension, this._deprecationService); this._webviews.set(handle, webview); webview._onDidDispose(() => { this._webviews.delete(handle); }); return webview; } public deleteWebview(handle: string) { this._webviews.delete(handle); } private getWebview(handle: extHostProtocol.WebviewHandle): ExtHostWebview | undefined { return this._webviews.get(handle); } } export function toExtensionData(extension: IExtensionDescription): extHostProtocol.WebviewExtensionDescription { return { id: extension.identifier, location: extension.extensionLocation }; } export function convertWebviewOptions( extension: IExtensionDescription, workspace: IExtHostWorkspace | undefined, options: vscode.WebviewPanelOptions & vscode.WebviewOptions, ): modes.IWebviewOptions { return { ...options, localResourceRoots: options.localResourceRoots || getDefaultLocalResourceRoots(extension, workspace) }; } function reviveOptions( options: modes.IWebviewOptions & modes.IWebviewPanelOptions ): vscode.WebviewOptions { return { ...options, localResourceRoots: options.localResourceRoots?.map(components => URI.from(components)), }; } function getDefaultLocalResourceRoots( extension: IExtensionDescription, workspace: IExtHostWorkspace | undefined, ): URI[] { return [ ...(workspace?.getWorkspaceFolders() || []).map(x => x.uri), extension.extensionLocation, ]; }