chrome-devtools-frontend
Version:
Chrome DevTools UI
918 lines (861 loc) • 38 kB
text/typescript
// Copyright 2021 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.
/* eslint-disable rulesdir/no-lit-render-outside-of-view */
import '../../../ui/components/expandable_list/expandable_list.js';
import '../../../ui/components/report_view/report_view.js';
import './StackTrace.js';
import * as Common from '../../../core/common/common.js';
import * as i18n from '../../../core/i18n/i18n.js';
import * as Platform from '../../../core/platform/platform.js';
import * as Root from '../../../core/root/root.js';
import * as SDK from '../../../core/sdk/sdk.js';
import * as Protocol from '../../../generated/protocol.js';
import * as Bindings from '../../../models/bindings/bindings.js';
import * as Workspace from '../../../models/workspace/workspace.js';
import * as NetworkForward from '../../../panels/network/forward/forward.js';
import * as CspEvaluator from '../../../third_party/csp_evaluator/csp_evaluator.js';
import * as Buttons from '../../../ui/components/buttons/buttons.js';
import type * as ExpandableList from '../../../ui/components/expandable_list/expandable_list.js';
import * as LegacyWrapper from '../../../ui/components/legacy_wrapper/legacy_wrapper.js';
import * as RenderCoordinator from '../../../ui/components/render_coordinator/render_coordinator.js';
import type * as ReportView from '../../../ui/components/report_view/report_view.js';
import * as Components from '../../../ui/legacy/components/utils/utils.js';
import * as Lit from '../../../ui/lit/lit.js';
import * as VisualLogging from '../../../ui/visual_logging/visual_logging.js';
import frameDetailsReportViewStyles from './frameDetailsReportView.css.js';
import {OriginTrialTreeView} from './OriginTrialTreeView.js';
import {
type PermissionsPolicySectionData,
renderIconLink,
} from './PermissionsPolicySection.js';
import type {StackTraceData} from './StackTrace.js';
const {html} = Lit;
const UIStrings = {
/**
*@description Section header in the Frame Details view
*/
additionalInformation: 'Additional Information',
/**
*@description Explanation for why the additional information section is being shown
*/
thisAdditionalDebugging:
'This additional (debugging) information is shown because the \'Protocol Monitor\' experiment is enabled.',
/**
*@description Label for subtitle of frame details view
*/
frameId: 'Frame ID',
/**
*@description Name of a network resource type
*/
document: 'Document',
/**
*@description A web URL (for a lot of languages this does not need to be translated, please translate only where necessary)
*/
url: 'URL',
/**
/**
*@description Title for a link to the Sources panel
*/
clickToOpenInSourcesPanel: 'Click to open in Sources panel',
/**
*@description Title for a link to the Network panel
*/
clickToOpenInNetworkPanel: 'Click to open in Network panel',
/**
*@description Title for unreachable URL field
*/
unreachableUrl: 'Unreachable URL',
/**
*@description Title for a link that applies a filter to the network panel
*/
clickToOpenInNetworkPanelMight: 'Click to open in Network panel (might require page reload)',
/**
*@description The origin of a URL (https://web.dev/same-site-same-origin/#origin)
*(for a lot of languages this does not need to be translated, please translate only where necessary)
*/
origin: 'Origin',
/**
/**
*@description Related node label in Timeline UIUtils of the Performance panel
*/
ownerElement: 'Owner Element',
/**
*@description Title for a link to the Elements panel
*/
clickToOpenInElementsPanel: 'Click to open in Elements panel',
/**
*@description Title for ad frame type field
*/
adStatus: 'Ad Status',
/**
*@description Description for ad frame type
*/
rootDescription: 'This frame has been identified as the root frame of an ad',
/**
*@description Value for ad frame type
*/
root: 'root',
/**
*@description Description for ad frame type
*/
childDescription: 'This frame has been identified as a child frame of an ad',
/**
*@description Value for ad frame type
*/
child: 'child',
/**
*@description Section header in the Frame Details view
*/
securityIsolation: 'Security & Isolation',
/**
*@description Section header in the Frame Details view
*/
contentSecurityPolicy: 'Content Security Policy (CSP)',
/**
*@description Row title for in the Frame Details view
*/
secureContext: 'Secure Context',
/**
*@description Text in Timeline indicating that input has happened recently
*/
yes: 'Yes',
/**
*@description Text in Timeline indicating that input has not happened recently
*/
no: 'No',
/**
*@description Label for whether a frame is cross-origin isolated
*(https://developer.chrome.com/docs/extensions/mv3/cross-origin-isolation/)
*(for a lot of languages this does not need to be translated, please translate only where necessary)
*/
crossoriginIsolated: 'Cross-Origin Isolated',
/**
*@description Explanatory text in the Frame Details view
*/
localhostIsAlwaysASecureContext: '`Localhost` is always a secure context',
/**
*@description Explanatory text in the Frame Details view
*/
aFrameAncestorIsAnInsecure: 'A frame ancestor is an insecure context',
/**
*@description Explanatory text in the Frame Details view
*/
theFramesSchemeIsInsecure: 'The frame\'s scheme is insecure',
/**
*@description This label specifies the server endpoints to which the server is reporting errors
*and warnings through the Report-to API. Following this label will be the URL of the server.
*/
reportingTo: 'reporting to',
/**
*@description Section header in the Frame Details view
*/
apiAvailability: 'API availability',
/**
*@description Explanation of why cross-origin isolation is important
*(https://web.dev/why-coop-coep/)
*(for a lot of languages 'cross-origin isolation' does not need to be translated, please translate only where necessary)
*/
availabilityOfCertainApisDepends: 'Availability of certain APIs depends on the document being cross-origin isolated.',
/**
*@description Description of the SharedArrayBuffer status
*/
availableTransferable: 'available, transferable',
/**
*@description Description of the SharedArrayBuffer status
*/
availableNotTransferable: 'available, not transferable',
/**
*@description Explanation for the SharedArrayBuffer availability status
*/
unavailable: 'unavailable',
/**
*@description Tooltip for the SharedArrayBuffer availability status
*/
sharedarraybufferConstructorIs:
'`SharedArrayBuffer` constructor is available and `SABs` can be transferred via `postMessage`',
/**
*@description Tooltip for the SharedArrayBuffer availability status
*/
sharedarraybufferConstructorIsAvailable:
'`SharedArrayBuffer` constructor is available but `SABs` cannot be transferred via `postMessage`',
/**
*@description Explanation why SharedArrayBuffer will not be available in the future
*(https://developer.chrome.com/docs/extensions/mv3/cross-origin-isolation/)
*(for a lot of languages 'cross-origin isolation' does not need to be translated, please translate only where necessary)
*/
willRequireCrossoriginIsolated: '⚠️ will require cross-origin isolated context in the future',
/**
*@description Explanation why SharedArrayBuffer is not available
*(https://developer.chrome.com/docs/extensions/mv3/cross-origin-isolation/)
*(for a lot of languages 'cross-origin isolation' does not need to be translated, please translate only where necessary).
*/
requiresCrossoriginIsolated: 'requires cross-origin isolated context',
/**
*@description Explanation for the SharedArrayBuffer availability status in case the transfer of a SAB requires the
* permission policy `cross-origin-isolated` to be enabled (e.g. because the message refers to the situation in an iframe).
*/
transferRequiresCrossoriginIsolatedPermission:
'`SharedArrayBuffer` transfer requires enabling the permission policy:',
/**
*@description Explanation for the Measure Memory availability status
*/
available: 'available',
/**
*@description Tooltip for the Measure Memory availability status
*/
thePerformanceAPI: 'The `performance.measureUserAgentSpecificMemory()` API is available',
/**
*@description Tooltip for the Measure Memory availability status
*/
thePerformancemeasureuseragentspecificmemory:
'The `performance.measureUserAgentSpecificMemory()` API is not available',
/**
*@description Entry in the API availability section of the frame details view
*/
measureMemory: 'Measure Memory',
/**
*@description Text that is usually a hyperlink to more documentation
*/
learnMore: 'Learn more',
/**
*@description Label for a stack trace. If a frame is created programmatically (i.e. via JavaScript), there is a
* stack trace for the line of code which caused the creation of the iframe. This is the stack trace we are showing here.
*/
creationStackTrace: 'Frame Creation `Stack Trace`',
/**
*@description Tooltip for 'Frame Creation Stack Trace' explaining that the stack
*trace shows where in the code the frame has been created programmatically
*/
creationStackTraceExplanation:
'This frame was created programmatically. The `stack trace` shows where this happened.',
/**
*@description Text descripting why a frame has been indentified as an advertisement.
*/
parentIsAdExplanation: 'This frame is considered an ad frame because its parent frame is an ad frame.',
/**
*@description Text descripting why a frame has been indentified as an advertisement.
*/
matchedBlockingRuleExplanation:
'This frame is considered an ad frame because its current (or previous) main document is an ad resource.',
/**
*@description Text descripting why a frame has been indentified as an advertisement.
*/
createdByAdScriptExplanation:
'There was an ad script in the `(async) stack` when this frame was created. Examining the creation `stack trace` of this frame might provide more insight.',
/**
*@description Label for the link(s) to the ad script(s) that led to this frame's creation.
*/
creatorAdScriptAncestry: 'Creator Ad Script Ancestry',
/**
*@description Label for the filterlist rule that identified the root script in 'Creator Ad Script Ancestry' as an ad.
*/
rootScriptFilterlistRule: 'Root Script Filterlist Rule',
/**
*@description Text describing the absence of a value.
*/
none: 'None',
/**
*@description Explanation of what origin trials are
*(https://developer.chrome.com/docs/web-platform/origin-trials/)
*(please don't translate 'origin trials').
*/
originTrialsExplanation: 'Origin trials give you access to a new or experimental feature.',
} as const;
const str_ = i18n.i18n.registerUIStrings('panels/application/components/FrameDetailsView.ts', UIStrings);
const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
export interface FrameDetailsReportViewData {
frame: SDK.ResourceTreeModel.ResourceTreeFrame;
target?: SDK.Target.Target;
adScriptAncestry: Protocol.Page.AdScriptAncestry|null;
}
export class FrameDetailsReportView extends LegacyWrapper.LegacyWrapper.WrappableComponent {
readonly #shadow = this.attachShadow({mode: 'open'});
#frame?: SDK.ResourceTreeModel.ResourceTreeFrame;
#target: SDK.Target.Target|null = null;
#protocolMonitorExperimentEnabled = false;
#permissionsPolicies: Promise<Protocol.Page.PermissionsPolicyFeatureState[]|null>|null = null;
#permissionsPolicySectionData: PermissionsPolicySectionData = {policies: [], showDetails: false};
#originTrialTreeView: OriginTrialTreeView = new OriginTrialTreeView();
#linkifier = new Components.Linkifier.Linkifier();
#adScriptAncestry: Protocol.Page.AdScriptAncestry|null = null;
constructor(frame: SDK.ResourceTreeModel.ResourceTreeFrame) {
super();
this.#frame = frame;
void this.render();
}
connectedCallback(): void {
this.parentElement?.classList.add('overflow-auto');
this.#protocolMonitorExperimentEnabled = Root.Runtime.experiments.isEnabled('protocol-monitor');
}
override async render(): Promise<void> {
const result = await this.#frame?.parentFrame()?.getAdScriptAncestry(this.#frame?.id);
if (result && result.ancestryChain.length > 0) {
this.#adScriptAncestry = result;
// Obtain the Target associated with the first ad script, because in most scenarios all
// scripts share the same debuggerId. However, discrepancies might arise when content scripts
// from browser extensions are involved. We will monitor the debugging experiences and revisit
// this approach if it proves problematic.
const firstScript = this.#adScriptAncestry.ancestryChain[0];
const debuggerModel = firstScript?.debuggerId ?
await SDK.DebuggerModel.DebuggerModel.modelForDebuggerId(firstScript.debuggerId) :
null;
this.#target = debuggerModel?.target() ?? null;
}
if (!this.#permissionsPolicies && this.#frame) {
this.#permissionsPolicies = this.#frame.getPermissionsPolicyState();
}
await RenderCoordinator.write('FrameDetailsView render', () => {
if (!this.#frame) {
return;
}
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
Lit.render(html`
<style>${frameDetailsReportViewStyles}</style>
<devtools-report .data=${{reportTitle: this.#frame.displayName()} as ReportView.ReportView.ReportData}
jslog=${VisualLogging.pane('frames')}>
${this.#renderDocumentSection()}
${this.#renderIsolationSection()}
${this.#renderApiAvailabilitySection()}
${this.#renderOriginTrial()}
${Lit.Directives.until(this.#permissionsPolicies?.then(policies => {
this.#permissionsPolicySectionData.policies = policies || [];
return html`
<devtools-resources-permissions-policy-section
.data=${this.#permissionsPolicySectionData}
>
</devtools-resources-permissions-policy-section>
`;
}), Lit.nothing)}
${this.#protocolMonitorExperimentEnabled ? this.#renderAdditionalInfoSection() : Lit.nothing}
</devtools-report>
`, this.#shadow, {host: this});
// clang-format on
});
}
#renderOriginTrial(): Lit.LitTemplate {
if (!this.#frame) {
return Lit.nothing;
}
this.#originTrialTreeView.classList.add('span-cols');
void this.#frame.getOriginTrials().then(trials => {
this.#originTrialTreeView.data = {trials};
});
// clang-format off
return html`
<devtools-report-section-header>
${i18n.i18n.lockedString('Origin trials')}
</devtools-report-section-header>
<devtools-report-section>
<span class="report-section">
${i18nString(UIStrings.originTrialsExplanation)}
<x-link href="https://developer.chrome.com/docs/web-platform/origin-trials/" class="link"
jslog=${VisualLogging.link('learn-more.origin-trials').track({click: true})}>
${i18nString(UIStrings.learnMore)}
</x-link>
</span>
</devtools-report-section>
${this.#originTrialTreeView}
<devtools-report-divider></devtools-report-divider>`;
// clang-format on
}
#renderDocumentSection(): Lit.LitTemplate {
if (!this.#frame) {
return Lit.nothing;
}
return html`
<devtools-report-section-header>${i18nString(UIStrings.document)}</devtools-report-section-header>
<devtools-report-key>${i18nString(UIStrings.url)}</devtools-report-key>
<devtools-report-value>
<div class="inline-items">
${this.#maybeRenderSourcesLinkForURL()}
${this.#maybeRenderNetworkLinkForURL()}
<div class="text-ellipsis" title=${this.#frame.url}>${this.#frame.url}</div>
</div>
</devtools-report-value>
${this.#maybeRenderUnreachableURL()}
${this.#maybeRenderOrigin()}
${Lit.Directives.until(this.#renderOwnerElement(), Lit.nothing)}
${this.#maybeRenderCreationStacktrace()}
${this.#maybeRenderAdStatus()}
${this.#maybeRenderCreatorAdScriptAncestry()}
<devtools-report-divider></devtools-report-divider>
`;
}
#maybeRenderSourcesLinkForURL(): Lit.LitTemplate {
if (!this.#frame || this.#frame.unreachableUrl()) {
return Lit.nothing;
}
const sourceCode = this.#uiSourceCodeForFrame(this.#frame);
return renderIconLink(
'label',
i18nString(UIStrings.clickToOpenInSourcesPanel),
() => Common.Revealer.reveal(sourceCode),
'reveal-in-sources',
);
}
#maybeRenderNetworkLinkForURL(): Lit.LitTemplate {
if (this.#frame) {
const resource = this.#frame.resourceForURL(this.#frame.url);
if (resource?.request) {
const request = resource.request;
return renderIconLink('arrow-up-down-circle', i18nString(UIStrings.clickToOpenInNetworkPanel), () => {
const requestLocation = NetworkForward.UIRequestLocation.UIRequestLocation.tab(
request, NetworkForward.UIRequestLocation.UIRequestTabs.HEADERS_COMPONENT);
return Common.Revealer.reveal(requestLocation);
}, 'reveal-in-network');
}
}
return Lit.nothing;
}
#uiSourceCodeForFrame(frame: SDK.ResourceTreeModel.ResourceTreeFrame): Workspace.UISourceCode.UISourceCode|null {
for (const project of Workspace.Workspace.WorkspaceImpl.instance().projects()) {
const projectTarget = Bindings.NetworkProject.NetworkProject.getTargetForProject(project);
if (projectTarget && projectTarget === frame.resourceTreeModel().target()) {
const uiSourceCode = project.uiSourceCodeForURL(frame.url);
if (uiSourceCode) {
return uiSourceCode;
}
}
}
return null;
}
#maybeRenderUnreachableURL(): Lit.LitTemplate {
if (!this.#frame || !this.#frame.unreachableUrl()) {
return Lit.nothing;
}
return html`
<devtools-report-key>${i18nString(UIStrings.unreachableUrl)}</devtools-report-key>
<devtools-report-value>
<div class="inline-items">
${this.#renderNetworkLinkForUnreachableURL()}
<div class="text-ellipsis" title=${this.#frame.unreachableUrl()}>${this.#frame.unreachableUrl()}</div>
</div>
</devtools-report-value>
`;
}
#renderNetworkLinkForUnreachableURL(): Lit.LitTemplate {
if (this.#frame) {
const unreachableUrl = Common.ParsedURL.ParsedURL.fromString(this.#frame.unreachableUrl());
if (unreachableUrl) {
return renderIconLink(
'arrow-up-down-circle',
i18nString(UIStrings.clickToOpenInNetworkPanelMight),
():
void => {
void Common.Revealer.reveal(NetworkForward.UIFilter.UIRequestFilter.filters([
{
filterType: NetworkForward.UIFilter.FilterType.Domain,
filterValue: unreachableUrl.domain(),
},
{
filterType: null,
filterValue: unreachableUrl.path,
},
]));
},
'unreachable-url.reveal-in-network',
);
}
}
return Lit.nothing;
}
#maybeRenderOrigin(): Lit.LitTemplate {
if (this.#frame && this.#frame.securityOrigin && this.#frame.securityOrigin !== '://') {
return html`
<devtools-report-key>${i18nString(UIStrings.origin)}</devtools-report-key>
<devtools-report-value>
<div class="text-ellipsis" title=${this.#frame.securityOrigin}>${this.#frame.securityOrigin}</div>
</devtools-report-value>
`;
}
return Lit.nothing;
}
async #renderOwnerElement(): Promise<Lit.LitTemplate> {
if (this.#frame) {
const linkTargetDOMNode = await this.#frame.getOwnerDOMNodeOrDocument();
if (linkTargetDOMNode) {
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
return html`
<devtools-report-key>${i18nString(UIStrings.ownerElement)}</devtools-report-key>
<devtools-report-value class="without-min-width">
<div class="inline-items">
<button class="link text-link" role="link" tabindex=0 title=${i18nString(UIStrings.clickToOpenInElementsPanel)}
@mouseenter=${() => this.#frame?.highlight()}
@mouseleave=${() => SDK.OverlayModel.OverlayModel.hideDOMNodeHighlight()}
@click=${() => Common.Revealer.reveal(linkTargetDOMNode)}
jslog=${VisualLogging.action('reveal-in-elements').track({click: true})}
>
<${linkTargetDOMNode.nodeName().toLocaleLowerCase()}>
</button>
</div>
</devtools-report-value>
`;
// clang-format on
}
}
return Lit.nothing;
}
#maybeRenderCreationStacktrace(): Lit.LitTemplate {
const creationStackTraceData = this.#frame?.getCreationStackTraceData();
if (creationStackTraceData?.creationStackTrace) {
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
return html`
<devtools-report-key title=${i18nString(UIStrings.creationStackTraceExplanation)}>${
i18nString(UIStrings.creationStackTrace)}</devtools-report-key>
<devtools-report-value
jslog=${VisualLogging.section('frame-creation-stack-trace')}
>
<devtools-resources-stack-trace .data=${{
frame: this.#frame,
buildStackTraceRows: Components.JSPresentationUtils.buildStackTraceRows,
} as StackTraceData}>
</devtools-resources-stack-trace>
</devtools-report-value>
`;
// clang-format on
}
return Lit.nothing;
}
#getAdFrameTypeStrings(type: Protocol.Page.AdFrameType.Child|Protocol.Page.AdFrameType.Root):
{value: Platform.UIString.LocalizedString, description: Platform.UIString.LocalizedString} {
switch (type) {
case Protocol.Page.AdFrameType.Child:
return {value: i18nString(UIStrings.child), description: i18nString(UIStrings.childDescription)};
case Protocol.Page.AdFrameType.Root:
return {value: i18nString(UIStrings.root), description: i18nString(UIStrings.rootDescription)};
}
}
#getAdFrameExplanationString(explanation: Protocol.Page.AdFrameExplanation): Platform.UIString.LocalizedString {
switch (explanation) {
case Protocol.Page.AdFrameExplanation.CreatedByAdScript:
return i18nString(UIStrings.createdByAdScriptExplanation);
case Protocol.Page.AdFrameExplanation.MatchedBlockingRule:
return i18nString(UIStrings.matchedBlockingRuleExplanation);
case Protocol.Page.AdFrameExplanation.ParentIsAd:
return i18nString(UIStrings.parentIsAdExplanation);
}
}
#maybeRenderAdStatus(): Lit.LitTemplate {
if (!this.#frame) {
return Lit.nothing;
}
const adFrameType = this.#frame.adFrameType();
if (adFrameType === Protocol.Page.AdFrameType.None) {
return Lit.nothing;
}
const typeStrings = this.#getAdFrameTypeStrings(adFrameType);
const rows = [html`<div title=${typeStrings.description}>${typeStrings.value}</div>`];
for (const explanation of this.#frame.adFrameStatus()?.explanations || []) {
rows.push(html`<div>${this.#getAdFrameExplanationString(explanation)}</div>`);
}
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
return html`
<devtools-report-key>${i18nString(UIStrings.adStatus)}</devtools-report-key>
<devtools-report-value class="ad-status-list" jslog=${VisualLogging.section('ad-status')}>
<devtools-expandable-list .data=${
{rows, title: i18nString(UIStrings.adStatus)} as ExpandableList.ExpandableList.ExpandableListData}>
</devtools-expandable-list>
</devtools-report-value>`;
// clang-format on
}
#maybeRenderCreatorAdScriptAncestry(): Lit.LitTemplate {
if (!this.#frame) {
return Lit.nothing;
}
const adFrameType = this.#frame.adFrameType();
if (adFrameType === Protocol.Page.AdFrameType.None) {
return Lit.nothing;
}
if (!this.#target || !this.#adScriptAncestry || this.#adScriptAncestry.ancestryChain.length === 0) {
return Lit.nothing;
}
const rows = this.#adScriptAncestry.ancestryChain.map(adScriptId => {
const adScriptLinkElement = this.#linkifier.linkifyScriptLocation(
this.#target,
adScriptId.scriptId || null,
Platform.DevToolsPath.EmptyUrlString,
undefined,
undefined,
);
adScriptLinkElement?.setAttribute('jslog', `${VisualLogging.link('ad-script').track({click: true})}`);
return html`<div>${adScriptLinkElement}</div>`;
});
const shouldRenderFilterlistRule = (this.#adScriptAncestry.rootScriptFilterlistRule !== undefined);
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
return html`
<devtools-report-key>${i18nString(UIStrings.creatorAdScriptAncestry)}</devtools-report-key>
<devtools-report-value class="creator-ad-script-ancestry-list" jslog=${VisualLogging.section('creator-ad-script-ancestry')}>
<devtools-expandable-list .data=${
{rows, title: i18nString(UIStrings.creatorAdScriptAncestry)} as ExpandableList.ExpandableList.ExpandableListData}>
</devtools-expandable-list>
</devtools-report-value>
${shouldRenderFilterlistRule ? html`
<devtools-report-key>${i18nString(UIStrings.rootScriptFilterlistRule)}</devtools-report-key>
<devtools-report-value jslog=${VisualLogging.section('root-script-filterlist-rule')}>${this.#adScriptAncestry.rootScriptFilterlistRule}</devtools-report-value>
` : Lit.nothing}
`;
// clang-format on
}
#renderIsolationSection(): Lit.LitTemplate {
if (!this.#frame) {
return Lit.nothing;
}
return html`
<devtools-report-section-header>${i18nString(UIStrings.securityIsolation)}</devtools-report-section-header>
<devtools-report-key>${i18nString(UIStrings.secureContext)}</devtools-report-key>
<devtools-report-value>
${this.#frame.isSecureContext() ? i18nString(UIStrings.yes) : i18nString(UIStrings.no)}\xA0${
this.#maybeRenderSecureContextExplanation()}
</devtools-report-value>
<devtools-report-key>${i18nString(UIStrings.crossoriginIsolated)}</devtools-report-key>
<devtools-report-value>
${this.#frame.isCrossOriginIsolated() ? i18nString(UIStrings.yes) : i18nString(UIStrings.no)}
</devtools-report-value>
${Lit.Directives.until(this.#maybeRenderCoopCoepCSPStatus(), Lit.nothing)}
<devtools-report-divider></devtools-report-divider>
`;
}
#maybeRenderSecureContextExplanation(): Lit.LitTemplate {
const explanation = this.#getSecureContextExplanation();
if (explanation) {
return html`<span class="inline-comment">${explanation}</span>`;
}
return Lit.nothing;
}
#getSecureContextExplanation(): Platform.UIString.LocalizedString|null {
switch (this.#frame?.getSecureContextType()) {
case Protocol.Page.SecureContextType.Secure:
return null;
case Protocol.Page.SecureContextType.SecureLocalhost:
return i18nString(UIStrings.localhostIsAlwaysASecureContext);
case Protocol.Page.SecureContextType.InsecureAncestor:
return i18nString(UIStrings.aFrameAncestorIsAnInsecure);
case Protocol.Page.SecureContextType.InsecureScheme:
return i18nString(UIStrings.theFramesSchemeIsInsecure);
}
return null;
}
async #maybeRenderCoopCoepCSPStatus(): Promise<Lit.LitTemplate> {
if (this.#frame) {
const model = this.#frame.resourceTreeModel().target().model(SDK.NetworkManager.NetworkManager);
const info = model && await model.getSecurityIsolationStatus(this.#frame.id);
if (info) {
return html`
${
this.#maybeRenderCrossOriginStatus(
info.coep, i18n.i18n.lockedString('Cross-Origin Embedder Policy (COEP)'),
Protocol.Network.CrossOriginEmbedderPolicyValue.None)}
${
this.#maybeRenderCrossOriginStatus(
info.coop, i18n.i18n.lockedString('Cross-Origin Opener Policy (COOP)'),
Protocol.Network.CrossOriginOpenerPolicyValue.UnsafeNone)}
${this.#renderCSPSection(info.csp)}
`;
}
}
return Lit.nothing;
}
#maybeRenderCrossOriginStatus(
info: Protocol.Network.CrossOriginEmbedderPolicyStatus|Protocol.Network.CrossOriginOpenerPolicyStatus|undefined,
policyName: string,
noneValue: Protocol.Network.CrossOriginEmbedderPolicyValue|
Protocol.Network.CrossOriginOpenerPolicyValue): Lit.LitTemplate {
if (!info) {
return Lit.nothing;
}
const isEnabled = info.value !== noneValue;
const isReportOnly = (!isEnabled && info.reportOnlyValue !== noneValue);
const endpoint = isEnabled ? info.reportingEndpoint : info.reportOnlyReportingEndpoint;
return html`
<devtools-report-key>${policyName}</devtools-report-key>
<devtools-report-value>
${isEnabled ? info.value : info.reportOnlyValue}
${isReportOnly ? html`<span class="inline-comment">report-only</span>` : Lit.nothing}
${
endpoint ? html`<span class="inline-name">${i18nString(UIStrings.reportingTo)}</span>${endpoint}` : Lit.nothing}
</devtools-report-value>
`;
}
#renderEffectiveDirectives(directives: string): Lit.LitTemplate[] {
const parsedDirectives = new CspEvaluator.CspParser.CspParser(directives).csp.directives;
const result = [];
for (const directive in parsedDirectives) {
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
result.push(html`
<div>
<span class="bold">${directive}</span>
${': ' + parsedDirectives[directive]?.join(', ')}
</div>`);
// clang-format on
}
return result;
}
#renderSingleCSP(cspInfo: Protocol.Network.ContentSecurityPolicyStatus, divider: boolean): Lit.LitTemplate {
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
return html`
<devtools-report-key>
${cspInfo.isEnforced ? i18n.i18n.lockedString('Content-Security-Policy') : html`
${i18n.i18n.lockedString('Content-Security-Policy-Report-Only')}
<devtools-button
.iconName=${'help'}
class='help-button'
.variant=${Buttons.Button.Variant.ICON}
.size=${Buttons.Button.Size.SMALL}
@click=${()=> {window.location.href = 'https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy-Report-Only';}}
jslog=${VisualLogging.link('learn-more.csp-report-only').track({click: true})}
></devtools-button>`}
</devtools-report-key>
<devtools-report-value>
${cspInfo.source === Protocol.Network.ContentSecurityPolicySource.HTTP ?
i18n.i18n.lockedString('HTTP header') : i18n.i18n.lockedString('Meta tag')}
${this.#renderEffectiveDirectives(cspInfo.effectiveDirectives)}
</devtools-report-value>
${divider ? html`<devtools-report-divider class="subsection-divider"></devtools-report-divider>` : Lit.nothing}
`;
// clang-format on
}
#renderCSPSection(cspInfos: Protocol.Network.ContentSecurityPolicyStatus[]|undefined): Lit.LitTemplate {
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
return html`
<devtools-report-divider></devtools-report-divider>
<devtools-report-section-header>
${i18nString(UIStrings.contentSecurityPolicy)}
</devtools-report-section-header>
${(cspInfos?.length) ? cspInfos.map((cspInfo, index) => this.#renderSingleCSP(cspInfo, index < cspInfos?.length - 1)) : html`
<devtools-report-key>
${i18n.i18n.lockedString('Content-Security-Policy')}
</devtools-report-key>
<devtools-report-value>
${i18nString(UIStrings.none)}
</devtools-report-value>
`}
`;
// clang-format on
}
#renderApiAvailabilitySection(): Lit.LitTemplate {
if (!this.#frame) {
return Lit.nothing;
}
// Disabled until https://crbug.com/1079231 is fixed.
// clang-format off
return html`
<devtools-report-section-header>
${i18nString(UIStrings.apiAvailability)}
</devtools-report-section-header>
<devtools-report-section>
<span class="report-section">
${i18nString(UIStrings.availabilityOfCertainApisDepends)}
<x-link
href="https://web.dev/why-coop-coep/" class="link"
jslog=${VisualLogging.link('learn-more.coop-coep').track({click: true})}>
${i18nString(UIStrings.learnMore)}
</x-link>
</span>
</devtools-report-section>
${this.#renderSharedArrayBufferAvailability()}
${this.#renderMeasureMemoryAvailability()}
<devtools-report-divider></devtools-report-divider>`;
// clang-format on
}
#renderSharedArrayBufferAvailability(): Lit.LitTemplate {
if (this.#frame) {
const features = this.#frame.getGatedAPIFeatures();
if (features) {
const sabAvailable = features.includes(Protocol.Page.GatedAPIFeatures.SharedArrayBuffers);
const sabTransferAvailable =
sabAvailable && features.includes(Protocol.Page.GatedAPIFeatures.SharedArrayBuffersTransferAllowed);
const availabilityText = sabTransferAvailable ?
i18nString(UIStrings.availableTransferable) :
(sabAvailable ? i18nString(UIStrings.availableNotTransferable) : i18nString(UIStrings.unavailable));
const tooltipText = sabTransferAvailable ?
i18nString(UIStrings.sharedarraybufferConstructorIs) :
(sabAvailable ? i18nString(UIStrings.sharedarraybufferConstructorIsAvailable) : '');
function renderHint(frame: SDK.ResourceTreeModel.ResourceTreeFrame): Lit.LitTemplate {
switch (frame.getCrossOriginIsolatedContextType()) {
case Protocol.Page.CrossOriginIsolatedContextType.Isolated:
return Lit.nothing;
case Protocol.Page.CrossOriginIsolatedContextType.NotIsolated:
if (sabAvailable) {
// clang-format off
return html`
<span class="inline-comment">
${i18nString(UIStrings.willRequireCrossoriginIsolated)}
</span>`;
// clang-format on
}
return html`<span class="inline-comment">${i18nString(UIStrings.requiresCrossoriginIsolated)}</span>`;
case Protocol.Page.CrossOriginIsolatedContextType.NotIsolatedFeatureDisabled:
if (!sabTransferAvailable) {
// clang-format off
return html`
<span class="inline-comment">
${i18nString(UIStrings.transferRequiresCrossoriginIsolatedPermission)}
<code> cross-origin-isolated</code>
</span>`;
// clang-format on
}
break;
}
return Lit.nothing;
}
// SharedArrayBuffer is an API name, so we don't translate it.
return html`
<devtools-report-key>SharedArrayBuffers</devtools-report-key>
<devtools-report-value title=${tooltipText}>
${availabilityText}\xA0${renderHint(this.#frame)}
</devtools-report-value>
`;
}
}
return Lit.nothing;
}
#renderMeasureMemoryAvailability(): Lit.LitTemplate {
if (this.#frame) {
const measureMemoryAvailable = this.#frame.isCrossOriginIsolated();
const availabilityText =
measureMemoryAvailable ? i18nString(UIStrings.available) : i18nString(UIStrings.unavailable);
const tooltipText = measureMemoryAvailable ? i18nString(UIStrings.thePerformanceAPI) :
i18nString(UIStrings.thePerformancemeasureuseragentspecificmemory);
return html`
<devtools-report-key>${i18nString(UIStrings.measureMemory)}</devtools-report-key>
<devtools-report-value>
<span title=${tooltipText}>${
availabilityText}</span>\xA0<x-link class="link" href="https://web.dev/monitor-total-page-memory-usage/" jslog=${
VisualLogging.link('learn-more.monitor-memory-usage').track({click: true})}>${
i18nString(UIStrings.learnMore)}</x-link>
</devtools-report-value>
`;
}
return Lit.nothing;
}
#renderAdditionalInfoSection(): Lit.LitTemplate {
if (!this.#frame) {
return Lit.nothing;
}
return html`
<devtools-report-section-header
title=${i18nString(UIStrings.thisAdditionalDebugging)}
>${i18nString(UIStrings.additionalInformation)}</devtools-report-section-header>
<devtools-report-key>${i18nString(UIStrings.frameId)}</devtools-report-key>
<devtools-report-value>
<div class="text-ellipsis" title=${this.#frame.id}>${this.#frame.id}</div>
</devtools-report-value>
<devtools-report-divider></devtools-report-divider>
`;
}
}
customElements.define('devtools-resources-frame-details-view', FrameDetailsReportView);
declare global {
interface HTMLElementTagNameMap {
'devtools-resources-frame-details-view': FrameDetailsReportView;
}
}