Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions config/gni/devtools_grd_files.gni
Original file line number Diff line number Diff line change
Expand Up @@ -1941,9 +1941,12 @@ grd_files_debug_sources = [
"front_end/panels/timeline/components/NetworkThrottlingSelector.js",
"front_end/panels/timeline/components/OriginMap.js",
"front_end/panels/timeline/components/RelatedInsightChips.js",
"front_end/panels/timeline/components/RNPerfIssueTypes.js",
"front_end/panels/timeline/components/Sidebar.js",
"front_end/panels/timeline/components/SidebarAnnotationsTab.js",
"front_end/panels/timeline/components/SidebarInsightsTab.js",
"front_end/panels/timeline/components/SidebarRNPerfSignalsTab.js",
"front_end/panels/timeline/components/SidebarRNPerfIssueItem.js",
"front_end/panels/timeline/components/SidebarSingleInsightSet.js",
"front_end/panels/timeline/components/TimelineSummary.js",
"front_end/panels/timeline/components/Utils.js",
Expand Down Expand Up @@ -1994,6 +1997,8 @@ grd_files_debug_sources = [
"front_end/panels/timeline/components/relatedInsightChips.css.js",
"front_end/panels/timeline/components/sidebarAnnotationsTab.css.js",
"front_end/panels/timeline/components/sidebarInsightsTab.css.js",
"front_end/panels/timeline/components/sidebarRNPerfIssuesTab.css.js",
"front_end/panels/timeline/components/sidebarRNPerfIssueItem.css.js",
"front_end/panels/timeline/components/sidebarSingleInsightSet.css.js",
"front_end/panels/timeline/components/timelineSummary.css.js",
"front_end/panels/timeline/extensions/ExtensionUI.js",
Expand Down
24 changes: 24 additions & 0 deletions front_end/panels/timeline/TimelineFlameChartView.ts
Original file line number Diff line number Diff line change
Expand Up @@ -178,6 +178,7 @@ export class TimelineFlameChartView extends Common.ObjectWrapper.eventMixin<Even
#treeRowClickDimmer = this.#registerFlameChartDimmer({inclusive: false, outline: false});
#activeInsightDimmer = this.#registerFlameChartDimmer({inclusive: false, outline: true});
#thirdPartyCheckboxDimmer = this.#registerFlameChartDimmer({inclusive: true, outline: false});
#performanceIssuesDimmer = this.#registerFlameChartDimmer({inclusive: false, outline: false});

constructor(delegate: TimelineModeViewDelegate) {
super();
Expand Down Expand Up @@ -533,6 +534,26 @@ export class TimelineFlameChartView extends Common.ObjectWrapper.eventMixin<Even
this.networkFlameChart.enableDimming(dimmer.networkChartIndices, dimmer.inclusive, networkOutline);
}

/**
* [RN] Apply highlighting/dimming to a specific Performance Issue event.
*/
updatePerfIssueFlameChartDimmer(event: Trace.Types.Events.Event): void {
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: These changes in the implementation of TimelineFlameChartView are necessary — since there aren't existing APIs for quite the same event selection + highlighting, with the Find panel working slightly differently.

this.#flameChartDimmers.forEach(dimmer => {
dimmer.active = false;
});

const mainIndex = this.mainDataProvider.indexForEvent(event);
const networkIndex = this.networkDataProvider.indexForEvent(event);
const mainChartIndices = mainIndex !== null && mainIndex >= 0 ? [mainIndex] : [];
const networkChartIndices = networkIndex !== null && networkIndex >= 0 ? [networkIndex] : [];

this.#updateFlameChartDimmerWithIndices(this.#performanceIssuesDimmer, mainChartIndices, networkChartIndices);
}

#clearPerformanceIssuesDimmer(): void {
this.#updateFlameChartDimmerWithEvents(this.#performanceIssuesDimmer, null);
}

#dimInsightRelatedEvents(relatedEvents: Trace.Types.Events.Event[]): void {
// Dim all events except those related to the active insight.
const relatedMainIndices = relatedEvents.map(event => this.mainDataProvider.indexForEvent(event) ?? -1);
Expand Down Expand Up @@ -1595,6 +1616,9 @@ export class TimelineFlameChartView extends Common.ObjectWrapper.eventMixin<Even
}
}

// [RN] Clear Performance Issues dimmer when clicking directly on the timeline
this.#clearPerformanceIssuesDimmer();

dataProvider.buildFlowForInitiator(entryIndex);
this.delegate.select(dataProvider.createSelection(entryIndex));
}
Expand Down
11 changes: 7 additions & 4 deletions front_end/panels/timeline/TimelinePanel.ts
Original file line number Diff line number Diff line change
Expand Up @@ -623,6 +623,13 @@ export class TimelinePanel extends UI.Panel.Panel implements Client, TimelineMod
this.#splitWidget.enableShowModeSaving();
this.#splitWidget.show(this.element);

// [RN] Set up callback for Performance Issue selection
this.#sideBar.setSelectTimelineEventCallback((event: Trace.Types.Events.Event) => {
const selection = selectionFromEvent(event);
this.flameChart.setSelectionAndReveal(selection);
this.flameChart.updatePerfIssueFlameChartDimmer(event);
});

this.flameChart.overlays().addEventListener(Overlays.Overlays.TimeRangeMouseOverEvent.eventName, event => {
const {overlay} = event as Overlays.Overlays.TimeRangeMouseOverEvent;
const overlayBounds = Overlays.Overlays.traceWindowContainingOverlays([overlay]);
Expand Down Expand Up @@ -2185,10 +2192,6 @@ export class TimelinePanel extends UI.Panel.Panel implements Client, TimelineMod
// Used in interaction tests & screenshot tests.
return;
}
// [RN] Keep sidebar collapsed by default
if (Root.Runtime.experiments.isEnabled(Root.Runtime.ExperimentName.REACT_NATIVE_SPECIFIC_UI)) {
return;
}
const needToRestore = this.#restoreSidebarVisibilityOnTraceLoad;
const userHasSeenSidebar = this.#sideBar.userHasOpenedSidebarOnce();

Expand Down
5 changes: 5 additions & 0 deletions front_end/panels/timeline/components/BUILD.gn
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ generate_css("css_files") {
"relatedInsightChips.css",
"sidebarAnnotationsTab.css",
"sidebarInsightsTab.css",
"sidebarRNPerfIssueItem.css",
"sidebarRNPerfIssuesTab.css",
"sidebarSingleInsightSet.css",
"timelineSummary.css",
]
Expand All @@ -48,9 +50,12 @@ devtools_module("components") {
"NetworkThrottlingSelector.ts",
"OriginMap.ts",
"RelatedInsightChips.ts",
"RNPerfIssueTypes.ts",
"Sidebar.ts",
"SidebarAnnotationsTab.ts",
"SidebarInsightsTab.ts",
"SidebarRNPerfIssueItem.ts",
"SidebarRNPerfSignalsTab.ts",
"SidebarSingleInsightSet.ts",
"TimelineSummary.ts",
"Utils.ts",
Expand Down
29 changes: 29 additions & 0 deletions front_end/panels/timeline/components/RNPerfIssueTypes.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
// Copyright 2024 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

import type * as Trace from '../../../models/trace/trace.js';

export type PerfIssueSeverity = 'info' | 'warning' | 'error';

export interface RNPerfIssueDetail {
name: string;
description?: string;
severity?: PerfIssueSeverity;
learnMoreUrl?: string;
}

export interface PerfIssueEvent {
event: Trace.Types.Events.Event;
timestampMs: number;
}

export interface AggregatedPerfIssue {
name: string;
description?: string;
severity: PerfIssueSeverity;
learnMoreUrl?: string;
events: PerfIssueEvent[];
count: number;
}
49 changes: 49 additions & 0 deletions front_end/panels/timeline/components/Sidebar.ts
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ import * as UI from '../../../ui/legacy/legacy.js';

import {SidebarAnnotationsTab} from './SidebarAnnotationsTab.js';
import {SidebarInsightsTab} from './SidebarInsightsTab.js';
import {SidebarRNPerfSignalsTab} from './SidebarRNPerfSignalsTab.js';

export interface ActiveInsight {
model: Trace.Insights.Types.InsightModel;
Expand Down Expand Up @@ -40,6 +41,7 @@ declare global {
export const enum SidebarTabs {
INSIGHTS = 'insights',
ANNOTATIONS = 'annotations',
PERF_SIGNALS = 'perf-signals',
}
export const DEFAULT_SIDEBAR_TAB = SidebarTabs.INSIGHTS;

Expand All @@ -52,6 +54,9 @@ export class SidebarWidget extends UI.Widget.VBox {
#insightsView = new InsightsView();
#annotationsView = new AnnotationsView();

#perfIssuesTabEnabled = false;
#rnPerfSignalsView = new RNPerfSignalsView();

/**
* Track if the user has opened the sidebar before. We do this so that the
* very first time they record/import a trace after the sidebar ships, we can
Expand All @@ -72,6 +77,8 @@ export class SidebarWidget extends UI.Widget.VBox {

// [RN] Disable Insights tab
const showInsightsTab = !Root.Runtime.experiments.isEnabled(Root.Runtime.ExperimentName.REACT_NATIVE_SPECIFIC_UI);
// [RN] Show experimental Performance Issues tab
this.#perfIssuesTabEnabled = Root.Runtime.experiments.isEnabled(Root.Runtime.ExperimentName.REACT_NATIVE_SPECIFIC_UI);

if (showInsightsTab) {
this.#tabbedPane.appendTab(
Expand Down Expand Up @@ -114,6 +121,25 @@ export class SidebarWidget extends UI.Widget.VBox {

setParsedTrace(parsedTrace: Trace.Handlers.Types.ParsedTrace|null, metadata: Trace.Types.File.MetaData|null): void {
this.#insightsView.setParsedTrace(parsedTrace, metadata);
this.#rnPerfSignalsView.setParsedTrace(parsedTrace);

// [RN] Show or remove the Perf Issues tab if there are issues present
if (this.#perfIssuesTabEnabled) {
const hasIssues = this.#rnPerfSignalsView.hasIssues();
const tabExists = this.#tabbedPane.hasTab(SidebarTabs.PERF_SIGNALS);

if (hasIssues && !tabExists) {
this.#tabbedPane.appendTab(
SidebarTabs.PERF_SIGNALS, 'Performance Signals', this.#rnPerfSignalsView, undefined, undefined, false, true);
this.#tabbedPane.selectTab(SidebarTabs.PERF_SIGNALS);
} else if (!hasIssues && tabExists) {
this.#tabbedPane.closeTab(SidebarTabs.PERF_SIGNALS);
}
}
}

setSelectTimelineEventCallback(callback: (event: Trace.Types.Events.Event) => void): void {
this.#rnPerfSignalsView.setSelectTimelineEventCallback(callback);
}

setInsights(insights: Trace.Insights.Types.TraceInsightSets|null): void {
Expand Down Expand Up @@ -185,3 +211,26 @@ class AnnotationsView extends UI.Widget.VBox {
return this.#component.deduplicatedAnnotations();
}
}

/** [RN] Experimental view for Performance Signals. */
class RNPerfSignalsView extends UI.Widget.VBox {
#component = new SidebarRNPerfSignalsTab();

constructor() {
super();
this.element.classList.add('sidebar-perf-signals');
this.element.appendChild(this.#component);
}

setParsedTrace(parsedTrace: Trace.Handlers.Types.ParsedTrace|null): void {
this.#component.parsedTrace = parsedTrace;
}

setSelectTimelineEventCallback(callback: (event: Trace.Types.Events.Event) => void): void {
this.#component.setSelectTimelineEventCallback(callback);
}

hasIssues(): boolean {
return this.#component.hasIssues();
}
}
136 changes: 136 additions & 0 deletions front_end/panels/timeline/components/SidebarRNPerfIssueItem.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
// Copyright 2024 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

import '../../../ui/components/buttons/buttons.js';
import '../../../ui/components/icon_button/icon_button.js';

import type * as Platform from '../../../core/platform/platform.js';
import type * as Trace from '../../../models/trace/trace.js';
import * as Buttons from '../../../ui/components/buttons/buttons.js';
import * as UI from '../../../ui/legacy/legacy.js';
import * as Lit from '../../../ui/lit/lit.js';

import type {AggregatedPerfIssue, PerfIssueEvent, PerfIssueSeverity} from './RNPerfIssueTypes.js';
import styles from './sidebarRNPerfIssueItem.css.js';

const {html} = Lit;

interface SidebarRNPerfIssueItemData {
issue: AggregatedPerfIssue;
onEventSelected?: (event: Trace.Types.Events.Event) => void;
}

export class SidebarRNPerfIssueItem extends HTMLElement {
readonly #shadow = this.attachShadow({mode: 'open'});

#issue: AggregatedPerfIssue|null = null;
#onEventSelected?: (event: Trace.Types.Events.Event) => void;
#isOpen = false;

set data(data: SidebarRNPerfIssueItemData) {
this.#issue = data.issue;
this.#onEventSelected = data.onEventSelected;
this.#render();
}

#toggleOpen(event: Event): void {
event.preventDefault();
this.#isOpen = !this.#isOpen;
this.#render();
}

#onEventClick(issueEvent: PerfIssueEvent): void {
if (this.#onEventSelected) {
this.#onEventSelected(issueEvent.event);
}
}

#onEventKeyDown(event: KeyboardEvent, issueEvent: PerfIssueEvent): void {
if (event.key === 'Enter' || event.key === ' ') {
event.preventDefault();
this.#onEventClick(issueEvent);
}
}

#renderDropdownIcon(isOpen: boolean): Lit.TemplateResult {
return html`
<devtools-button .data=${{
variant: Buttons.Button.Variant.ICON,
iconName: 'chevron-right',
size: Buttons.Button.Size.SMALL,
} as Buttons.Button.ButtonData} class="dropdown-icon ${isOpen ? 'open' : ''}"></devtools-button>
`;
}

#renderSeverityIcon(severity: PerfIssueSeverity): Lit.TemplateResult {
const iconData = {
error: {iconName: 'issue-cross-filled', color: 'var(--icon-error)'},
warning: {iconName: 'issue-exclamation-filled', color: 'var(--icon-warning)'},
info: {iconName: 'issue-text-filled', color: 'var(--icon-info)'},
} as const;
const {iconName, color} = iconData[severity];
return html`
<devtools-icon .data=${{iconName, color, width: '16px', height: '16px'}}></devtools-icon>
`;
}

#render(): void {
const issue = this.#issue;
if (!issue) {
Lit.render(Lit.nothing, this.#shadow, {host: this});
return;
}

const formatter = new Intl.NumberFormat(undefined, {
minimumFractionDigits: 1,
maximumFractionDigits: 1,
style: 'decimal',
});
const contents = html`
<style>${styles.cssText}</style>
<details ?open=${this.#isOpen}>
<summary @click=${(e: Event) => this.#toggleOpen(e)} class="issue-summary">
${this.#renderDropdownIcon(this.#isOpen)}
${this.#renderSeverityIcon(issue.severity)}
<span class="event-count-pill">${issue.count}</span>
<div class="issue-info">
<div class="issue-name">${issue.name}</div>
${issue.description ? html`<div class="issue-description">${issue.description}</div>` : ''}
${issue.learnMoreUrl ? html`
<div class="issue-learn-more">
${UI.XLink.XLink.create(issue.learnMoreUrl as Platform.DevToolsPath.UrlString, 'Learn more')}
</div>
` : ''}
</div>
</summary>
<div class="issue-content">
<div class="event-list event-list-${issue.severity}">
${issue.events.map((issueEvent, i) => {
return html`
<div class="event-item"
tabindex="0"
role="button"
aria-label="Navigate to item ${i + 1} in timeline"
@click=${() => this.#onEventClick(issueEvent)}
@keydown=${(event: KeyboardEvent) => this.#onEventKeyDown(event, issueEvent)}>
<div class="event-name">${issueEvent.event.name}</div>
<div class="event-timestamp">${formatter.format(issueEvent.timestampMs)} ms</div>
</div>`;
})}
</div>
</div>
</details>
`;
Lit.render(contents, this.#shadow, {host: this});
}
}

customElements.define('devtools-performance-sidebar-perf-issue-item', SidebarRNPerfIssueItem);

declare global {
interface HTMLElementTagNameMap {
'devtools-performance-sidebar-perf-issue-item': SidebarRNPerfIssueItem;
}
}
Loading
Loading