/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the Source EULA. See License.txt in the project root for license information. *--------------------------------------------------------------------------------------------*/ import * as nls from 'vs/nls'; import { RunOnceScheduler } from 'vs/base/common/async'; import * as dom from 'vs/base/browser/dom'; import { TPromise } from 'vs/base/common/winjs.base'; import * as errors from 'vs/base/common/errors'; import { TreeViewsViewletPanel, IViewletViewOptions, IViewOptions } from 'vs/workbench/browser/parts/views/viewsViewlet'; import { IDebugService, State, IStackFrame, IProcess, IThread } from 'vs/workbench/parts/debug/common/debug'; import { Thread, StackFrame, ThreadAndProcessIds, Process, Model } from 'vs/workbench/parts/debug/common/debugModel'; import { IContextMenuService } from 'vs/platform/contextview/browser/contextView'; import { IInstantiationService } from 'vs/platform/instantiation/common/instantiation'; import { MenuId } from 'vs/platform/actions/common/actions'; import { IKeybindingService } from 'vs/platform/keybinding/common/keybinding'; import { BaseDebugController, twistiePixels, renderViewTree } from 'vs/workbench/parts/debug/browser/baseDebugView'; import { ITree, IActionProvider, IDataSource, IRenderer, IAccessibilityProvider } from 'vs/base/parts/tree/browser/tree'; import { IAction, IActionItem } from 'vs/base/common/actions'; import { RestartAction, StopAction, ContinueAction, StepOverAction, StepIntoAction, StepOutAction, PauseAction, RestartFrameAction } from 'vs/workbench/parts/debug/browser/debugActions'; import { CopyStackTraceAction } from 'vs/workbench/parts/debug/electron-browser/electronDebugActions'; import { IWorkspaceContextService, WorkbenchState } from 'vs/platform/workspace/common/workspace'; import { IEnvironmentService } from 'vs/platform/environment/common/environment'; import { Source } from 'vs/workbench/parts/debug/common/debugSource'; import { basenameOrAuthority } from 'vs/base/common/resources'; import { TreeResourceNavigator, WorkbenchTree } from 'vs/platform/list/browser/listService'; import { IWorkbenchEditorService } from 'vs/workbench/services/editor/common/editorService'; import { IConfigurationService } from 'vs/platform/configuration/common/configuration'; const $ = dom.$; export class CallStackView extends TreeViewsViewletPanel { private static readonly MEMENTO = 'callstackview.memento'; private pauseMessage: HTMLSpanElement; private pauseMessageLabel: HTMLSpanElement; private onCallStackChangeScheduler: RunOnceScheduler; private settings: any; private needsRefresh: boolean; private ignoreSelectionChangedEvent: boolean; private treeContainer: HTMLElement; constructor( private options: IViewletViewOptions, @IContextMenuService contextMenuService: IContextMenuService, @IDebugService private debugService: IDebugService, @IKeybindingService keybindingService: IKeybindingService, @IInstantiationService private instantiationService: IInstantiationService, @IWorkbenchEditorService private editorService: IWorkbenchEditorService, @IConfigurationService configurationService: IConfigurationService, ) { super({ ...(options as IViewOptions), ariaHeaderLabel: nls.localize('callstackSection', "Call Stack Section") }, keybindingService, contextMenuService, configurationService); this.settings = options.viewletSettings; // Create scheduler to prevent unnecessary flashing of tree when reacting to changes this.onCallStackChangeScheduler = new RunOnceScheduler(() => { let newTreeInput: any = this.debugService.getModel(); const processes = this.debugService.getModel().getProcesses(); if (!this.debugService.getViewModel().isMultiProcessView() && processes.length) { const threads = processes[0].getAllThreads(); // Only show the threads in the call stack if there is more than 1 thread. newTreeInput = threads.length === 1 ? threads[0] : processes[0]; } // Only show the global pause message if we do not display threads. // Otherwise there will be a pause message per thread and there is no need for a global one. if (newTreeInput instanceof Thread && newTreeInput.stoppedDetails) { this.pauseMessageLabel.textContent = newTreeInput.stoppedDetails.description || nls.localize('debugStopped', "Paused on {0}", newTreeInput.stoppedDetails.reason); if (newTreeInput.stoppedDetails.text) { this.pauseMessageLabel.title = newTreeInput.stoppedDetails.text; } dom.toggleClass(this.pauseMessageLabel, 'exception', newTreeInput.stoppedDetails.reason === 'exception'); this.pauseMessage.hidden = false; } else { this.pauseMessage.hidden = true; } this.needsRefresh = false; (this.tree.getInput() === newTreeInput ? this.tree.refresh() : this.tree.setInput(newTreeInput)) .done(() => this.updateTreeSelection(), errors.onUnexpectedError); }, 50); } protected renderHeaderTitle(container: HTMLElement): void { const title = dom.append(container, $('.title.debug-call-stack-title')); const name = dom.append(title, $('span')); name.textContent = this.options.name; this.pauseMessage = dom.append(title, $('span.pause-message')); this.pauseMessage.hidden = true; this.pauseMessageLabel = dom.append(this.pauseMessage, $('span.label')); } public renderBody(container: HTMLElement): void { dom.addClass(container, 'debug-call-stack'); this.treeContainer = renderViewTree(container); const actionProvider = new CallStackActionProvider(this.debugService, this.keybindingService); const controller = this.instantiationService.createInstance(CallStackController, actionProvider, MenuId.DebugCallStackContext, {}); this.tree = this.instantiationService.createInstance(WorkbenchTree, this.treeContainer, { dataSource: new CallStackDataSource(), renderer: this.instantiationService.createInstance(CallStackRenderer), accessibilityProvider: this.instantiationService.createInstance(CallstackAccessibilityProvider), controller }, { ariaLabel: nls.localize({ comment: ['Debug is a noun in this context, not a verb.'], key: 'callStackAriaLabel' }, "Debug Call Stack"), twistiePixels }); const callstackNavigator = new TreeResourceNavigator(this.tree); this.disposables.push(callstackNavigator); this.disposables.push(callstackNavigator.openResource(e => { if (this.ignoreSelectionChangedEvent) { return; } const element = e.element; if (element instanceof StackFrame) { this.debugService.focusStackFrame(element, element.thread, element.thread.process, true); element.openInEditor(this.editorService, e.editorOptions.preserveFocus, e.sideBySide, e.editorOptions.pinned).done(undefined, errors.onUnexpectedError); } if (element instanceof Thread) { this.debugService.focusStackFrame(undefined, element, element.process, true); } if (element instanceof Process) { this.debugService.focusStackFrame(undefined, undefined, element, true); } if (element instanceof ThreadAndProcessIds) { const process = this.debugService.getModel().getProcesses().filter(p => p.getId() === element.processId).pop(); const thread = process && process.getThread(element.threadId); if (thread) { (thread).fetchCallStack() .done(() => this.tree.refresh(), errors.onUnexpectedError); } } })); this.disposables.push(this.debugService.getModel().onDidChangeCallStack(() => { if (!this.isVisible()) { this.needsRefresh = true; return; } if (!this.onCallStackChangeScheduler.isScheduled()) { this.onCallStackChangeScheduler.schedule(); } })); this.disposables.push(this.debugService.getViewModel().onDidFocusStackFrame(() => { if (!this.isVisible) { this.needsRefresh = true; return; } this.updateTreeSelection().done(undefined, errors.onUnexpectedError); })); // Schedule the update of the call stack tree if the viewlet is opened after a session started #14684 if (this.debugService.state === State.Stopped) { this.onCallStackChangeScheduler.schedule(); } } layoutBody(size: number): void { if (this.treeContainer) { this.treeContainer.style.height = size + 'px'; } super.layoutBody(size); } private updateTreeSelection(): TPromise { if (!this.tree.getInput()) { // Tree not initialized yet return TPromise.as(null); } const stackFrame = this.debugService.getViewModel().focusedStackFrame; const thread = this.debugService.getViewModel().focusedThread; const process = this.debugService.getViewModel().focusedProcess; const updateSelection = (element: IStackFrame | IProcess) => { this.ignoreSelectionChangedEvent = true; try { this.tree.setSelection([element]); } finally { this.ignoreSelectionChangedEvent = false; } }; if (!thread) { if (!process) { this.tree.clearSelection(); return TPromise.as(null); } updateSelection(process); return this.tree.reveal(process); } return this.tree.expandAll([thread.process, thread]).then(() => { if (!stackFrame) { return TPromise.as(null); } updateSelection(stackFrame); return this.tree.reveal(stackFrame); }); } public setVisible(visible: boolean): TPromise { return super.setVisible(visible).then(() => { if (visible && this.needsRefresh) { this.onCallStackChangeScheduler.schedule(); } }); } public shutdown(): void { this.settings[CallStackView.MEMENTO] = !this.isExpanded(); super.shutdown(); } } class CallStackController extends BaseDebugController { protected getContext(element: any): any { if (element instanceof StackFrame) { if (element.source.inMemory) { return element.source.raw.path || element.source.reference; } return element.source.uri.toString(); } if (element instanceof Thread) { return element.threadId; } } } class CallStackActionProvider implements IActionProvider { constructor(private debugService: IDebugService, private keybindingService: IKeybindingService) { // noop } public hasActions(tree: ITree, element: any): boolean { return false; } public getActions(tree: ITree, element: any): TPromise { return TPromise.as([]); } public hasSecondaryActions(tree: ITree, element: any): boolean { return element !== tree.getInput(); } public getSecondaryActions(tree: ITree, element: any): TPromise { const actions: IAction[] = []; if (element instanceof Process) { actions.push(new RestartAction(RestartAction.ID, RestartAction.LABEL, this.debugService, this.keybindingService)); actions.push(new StopAction(StopAction.ID, StopAction.LABEL, this.debugService, this.keybindingService)); } else if (element instanceof Thread) { const thread = element; if (thread.stopped) { actions.push(new ContinueAction(ContinueAction.ID, ContinueAction.LABEL, this.debugService, this.keybindingService)); actions.push(new StepOverAction(StepOverAction.ID, StepOverAction.LABEL, this.debugService, this.keybindingService)); actions.push(new StepIntoAction(StepIntoAction.ID, StepIntoAction.LABEL, this.debugService, this.keybindingService)); actions.push(new StepOutAction(StepOutAction.ID, StepOutAction.LABEL, this.debugService, this.keybindingService)); } else { actions.push(new PauseAction(PauseAction.ID, PauseAction.LABEL, this.debugService, this.keybindingService)); } } else if (element instanceof StackFrame) { if (element.thread.process.session.capabilities.supportsRestartFrame) { actions.push(new RestartFrameAction(RestartFrameAction.ID, RestartFrameAction.LABEL, this.debugService, this.keybindingService)); } actions.push(new CopyStackTraceAction(CopyStackTraceAction.ID, CopyStackTraceAction.LABEL)); } return TPromise.as(actions); } public getActionItem(tree: ITree, element: any, action: IAction): IActionItem { return null; } } class CallStackDataSource implements IDataSource { public getId(tree: ITree, element: any): string { if (typeof element === 'string') { return element; } return element.getId(); } public hasChildren(tree: ITree, element: any): boolean { return element instanceof Model || element instanceof Process || (element instanceof Thread && (element).stopped); } public getChildren(tree: ITree, element: any): TPromise { if (element instanceof Thread) { return this.getThreadChildren(element); } if (element instanceof Model) { return TPromise.as(element.getProcesses()); } const process = element; return TPromise.as(process.getAllThreads()); } private getThreadChildren(thread: Thread): TPromise { let callStack: any[] = thread.getCallStack(); let callStackPromise: TPromise = TPromise.as(null); if (!callStack || !callStack.length) { callStackPromise = thread.fetchCallStack().then(() => callStack = thread.getCallStack()); } return callStackPromise.then(() => { if (callStack.length === 1 && thread.process.session.capabilities.supportsDelayedStackTraceLoading) { // To reduce flashing of the call stack view simply append the stale call stack // once we have the correct data the tree will refresh and we will no longer display it. callStack = callStack.concat(thread.getStaleCallStack().slice(1)); } if (thread.stoppedDetails && thread.stoppedDetails.framesErrorMessage) { callStack = callStack.concat([thread.stoppedDetails.framesErrorMessage]); } if (thread.stoppedDetails && thread.stoppedDetails.totalFrames > callStack.length && callStack.length > 1) { callStack = callStack.concat([new ThreadAndProcessIds(thread.process.getId(), thread.threadId)]); } return callStack; }); } public getParent(tree: ITree, element: any): TPromise { return TPromise.as(null); } } interface IThreadTemplateData { thread: HTMLElement; name: HTMLElement; state: HTMLElement; stateLabel: HTMLSpanElement; } interface IProcessTemplateData { process: HTMLElement; name: HTMLElement; state: HTMLElement; stateLabel: HTMLSpanElement; } interface IErrorTemplateData { label: HTMLElement; } interface ILoadMoreTemplateData { label: HTMLElement; } interface IStackFrameTemplateData { stackFrame: HTMLElement; label: HTMLElement; file: HTMLElement; fileName: HTMLElement; lineNumber: HTMLElement; } class CallStackRenderer implements IRenderer { private static readonly THREAD_TEMPLATE_ID = 'thread'; private static readonly STACK_FRAME_TEMPLATE_ID = 'stackFrame'; private static readonly ERROR_TEMPLATE_ID = 'error'; private static readonly LOAD_MORE_TEMPLATE_ID = 'loadMore'; private static readonly PROCESS_TEMPLATE_ID = 'process'; constructor( @IWorkspaceContextService private contextService: IWorkspaceContextService, @IEnvironmentService private environmentService: IEnvironmentService ) { // noop } public getHeight(tree: ITree, element: any): number { return 22; } public getTemplateId(tree: ITree, element: any): string { if (element instanceof Process) { return CallStackRenderer.PROCESS_TEMPLATE_ID; } if (element instanceof Thread) { return CallStackRenderer.THREAD_TEMPLATE_ID; } if (element instanceof StackFrame) { return CallStackRenderer.STACK_FRAME_TEMPLATE_ID; } if (typeof element === 'string') { return CallStackRenderer.ERROR_TEMPLATE_ID; } return CallStackRenderer.LOAD_MORE_TEMPLATE_ID; } public renderTemplate(tree: ITree, templateId: string, container: HTMLElement): any { if (templateId === CallStackRenderer.PROCESS_TEMPLATE_ID) { let data: IProcessTemplateData = Object.create(null); data.process = dom.append(container, $('.process')); data.name = dom.append(data.process, $('.name')); data.state = dom.append(data.process, $('.state')); data.stateLabel = dom.append(data.state, $('span.label')); return data; } if (templateId === CallStackRenderer.LOAD_MORE_TEMPLATE_ID) { let data: ILoadMoreTemplateData = Object.create(null); data.label = dom.append(container, $('.load-more')); return data; } if (templateId === CallStackRenderer.ERROR_TEMPLATE_ID) { let data: ILoadMoreTemplateData = Object.create(null); data.label = dom.append(container, $('.error')); return data; } if (templateId === CallStackRenderer.THREAD_TEMPLATE_ID) { let data: IThreadTemplateData = Object.create(null); data.thread = dom.append(container, $('.thread')); data.name = dom.append(data.thread, $('.name')); data.state = dom.append(data.thread, $('.state')); data.stateLabel = dom.append(data.state, $('span.label')); return data; } let data: IStackFrameTemplateData = Object.create(null); data.stackFrame = dom.append(container, $('.stack-frame')); data.label = dom.append(data.stackFrame, $('span.label.expression')); data.file = dom.append(data.stackFrame, $('.file')); data.fileName = dom.append(data.file, $('span.file-name')); const wrapper = dom.append(data.file, $('span.line-number-wrapper')); data.lineNumber = dom.append(wrapper, $('span.line-number')); return data; } public renderElement(tree: ITree, element: any, templateId: string, templateData: any): void { if (templateId === CallStackRenderer.PROCESS_TEMPLATE_ID) { this.renderProcess(element, templateData); } else if (templateId === CallStackRenderer.THREAD_TEMPLATE_ID) { this.renderThread(element, templateData); } else if (templateId === CallStackRenderer.STACK_FRAME_TEMPLATE_ID) { this.renderStackFrame(element, templateData); } else if (templateId === CallStackRenderer.ERROR_TEMPLATE_ID) { this.renderError(element, templateData); } else if (templateId === CallStackRenderer.LOAD_MORE_TEMPLATE_ID) { this.renderLoadMore(element, templateData); } } private renderProcess(process: IProcess, data: IProcessTemplateData): void { data.process.title = nls.localize({ key: 'process', comment: ['Process is a noun'] }, "Process"); data.name.textContent = process.getName(this.contextService.getWorkbenchState() === WorkbenchState.WORKSPACE); const stoppedThread = process.getAllThreads().filter(t => t.stopped).pop(); data.stateLabel.textContent = stoppedThread ? nls.localize('paused', "Paused") : nls.localize({ key: 'running', comment: ['indicates state'] }, "Running"); } private renderThread(thread: IThread, data: IThreadTemplateData): void { data.thread.title = nls.localize('thread', "Thread"); data.name.textContent = thread.name; if (thread.stopped) { data.stateLabel.textContent = thread.stoppedDetails.description || thread.stoppedDetails.reason ? nls.localize({ key: 'pausedOn', comment: ['indicates reason for program being paused'] }, "Paused on {0}", thread.stoppedDetails.reason) : nls.localize('paused', "Paused"); } else { data.stateLabel.textContent = nls.localize({ key: 'running', comment: ['indicates state'] }, "Running"); } } private renderError(element: string, data: IErrorTemplateData) { data.label.textContent = element; data.label.title = element; } private renderLoadMore(element: any, data: ILoadMoreTemplateData): void { data.label.textContent = nls.localize('loadMoreStackFrames', "Load More Stack Frames"); } private renderStackFrame(stackFrame: IStackFrame, data: IStackFrameTemplateData): void { dom.toggleClass(data.stackFrame, 'disabled', !stackFrame.source.available || stackFrame.source.presentationHint === 'deemphasize'); dom.toggleClass(data.stackFrame, 'label', stackFrame.presentationHint === 'label'); dom.toggleClass(data.stackFrame, 'subtle', stackFrame.presentationHint === 'subtle'); data.file.title = stackFrame.source.raw.path || stackFrame.source.name; if (stackFrame.source.raw.origin) { data.file.title += `\n${stackFrame.source.raw.origin}`; } data.label.textContent = stackFrame.name; data.label.title = stackFrame.name; data.fileName.textContent = getSourceName(stackFrame.source, this.contextService, this.environmentService); if (stackFrame.range.startLineNumber !== undefined) { data.lineNumber.textContent = `${stackFrame.range.startLineNumber}`; if (stackFrame.range.startColumn) { data.lineNumber.textContent += `:${stackFrame.range.startColumn}`; } dom.removeClass(data.lineNumber, 'unavailable'); } else { dom.addClass(data.lineNumber, 'unavailable'); } } public disposeTemplate(tree: ITree, templateId: string, templateData: any): void { // noop } } class CallstackAccessibilityProvider implements IAccessibilityProvider { constructor( @IWorkspaceContextService private contextService: IWorkspaceContextService) { // noop } public getAriaLabel(tree: ITree, element: any): string { if (element instanceof Thread) { return nls.localize('threadAriaLabel', "Thread {0}, callstack, debug", (element).name); } if (element instanceof StackFrame) { return nls.localize('stackFrameAriaLabel', "Stack Frame {0} line {1} {2}, callstack, debug", (element).name, (element).range.startLineNumber, getSourceName((element).source, this.contextService)); } return null; } } function getSourceName(source: Source, contextService: IWorkspaceContextService, environmentService?: IEnvironmentService): string { if (source.name) { return source.name; } return basenameOrAuthority(source.uri); }