chrome-devtools-frontend 1.0.1015822 → 1.0.1017091

package/front_end/panels/application/DOMStorageModel.ts

@@ -38,13 +38,15 @@ import type * as ProtocolProxyApi from '../../generated/protocol-proxy-api.js';
 
 export class DOMStorage extends Common.ObjectWrapper.ObjectWrapper<DOMStorage.EventTypes> {
   private readonly model: DOMStorageModel;
-  private readonly securityOriginInternal: string;
+  private readonly securityOriginInternal: string|null;
+  private readonly storageKeyInternal: string|null;
   private readonly isLocalStorageInternal: boolean;
 
-  constructor(model: DOMStorageModel, securityOrigin: string, isLocalStorage: boolean) {
+  constructor(model: DOMStorageModel, securityOrigin: string, storageKey: string, isLocalStorage: boolean) {
     super();
     this.model = model;
     this.securityOriginInternal = securityOrigin;
+    this.storageKeyInternal = storageKey;
     this.isLocalStorageInternal = isLocalStorage;
   }
 
@@ -52,14 +54,46 @@ export class DOMStorage extends Common.ObjectWrapper.ObjectWrapper<DOMStorage.Ev
     return {securityOrigin: securityOrigin, isLocalStorage: isLocalStorage};
   }
 
+  static storageIdWithSecurityOrigin(securityOrigin: string, isLocalStorage: boolean): Protocol.DOMStorage.StorageId {
+    return {securityOrigin: securityOrigin, isLocalStorage: isLocalStorage};
+  }
+
+  static storageIdWithStorageKey(storageKey: string, isLocalStorage: boolean): Protocol.DOMStorage.StorageId {
+    return {storageKey: storageKey, isLocalStorage: isLocalStorage};
+  }
+
+  get idWithSecurityOrigin(): Protocol.DOMStorage.StorageId {
+    let securityOrigin = '';
+    if (this.securityOriginInternal) {
+      securityOrigin = this.securityOriginInternal;
+    }
+    return DOMStorage.storageIdWithSecurityOrigin(securityOrigin, this.isLocalStorageInternal);
+  }
+
+  get idWithStorageKey(): Protocol.DOMStorage.StorageId {
+    let storageKey = '';
+    if (this.storageKeyInternal) {
+      storageKey = this.storageKeyInternal;
+    }
+    return DOMStorage.storageIdWithStorageKey(storageKey, this.isLocalStorageInternal);
+  }
+
   get id(): Protocol.DOMStorage.StorageId {
-    return DOMStorage.storageId(this.securityOriginInternal, this.isLocalStorageInternal);
+    // TODO(crbug.com/1313434) Prioritize storageKey once everything is ready
+    if (this.securityOriginInternal) {
+      return this.idWithSecurityOrigin;
+    }
+    return this.idWithStorageKey;
   }
 
-  get securityOrigin(): string {
+  get securityOrigin(): string|null {
     return this.securityOriginInternal;
   }
 
+  get storageKey(): string|null {
+    return this.storageKeyInternal;
+  }
+
   get isLocalStorage(): boolean {
     return this.isLocalStorageInternal;
   }
@@ -116,6 +150,7 @@ export namespace DOMStorage {
 
 export class DOMStorageModel extends SDK.SDKModel.SDKModel<EventTypes> {
   private readonly securityOriginManager: SDK.SecurityOriginManager.SecurityOriginManager|null;
+  private readonly storageKeyManagerInternal: SDK.StorageKeyManager.StorageKeyManager|null;
   private storagesInternal: {
     [x: string]: DOMStorage,
   };
@@ -126,10 +161,15 @@ export class DOMStorageModel extends SDK.SDKModel.SDKModel<EventTypes> {
     super(target);
 
     this.securityOriginManager = target.model(SDK.SecurityOriginManager.SecurityOriginManager);
+    this.storageKeyManagerInternal = target.model(SDK.StorageKeyManager.StorageKeyManager);
     this.storagesInternal = {};
     this.agent = target.domstorageAgent();
   }
 
+  get storageKeyManagerForTest(): SDK.StorageKeyManager.StorageKeyManager|null {
+    return this.storageKeyManagerInternal;
+  }
+
   enable(): void {
     if (this.enabled) {
       return;
@@ -146,6 +186,16 @@ export class DOMStorageModel extends SDK.SDKModel.SDKModel<EventTypes> {
         this.addOrigin(securityOrigin);
       }
     }
+    if (this.storageKeyManagerInternal) {
+      this.storageKeyManagerInternal.addEventListener(
+          SDK.StorageKeyManager.Events.StorageKeyAdded, this.storageKeyAdded, this);
+      this.storageKeyManagerInternal.addEventListener(
+          SDK.StorageKeyManager.Events.StorageKeyRemoved, this.storageKeyRemoved, this);
+
+      for (const storageKey of this.storageKeyManagerInternal.storageKeys()) {
+        this.addStorageKey(storageKey);
+      }
+    }
     void this.agent.invoke_enable();
 
     this.enabled = true;
@@ -156,7 +206,7 @@ export class DOMStorageModel extends SDK.SDKModel.SDKModel<EventTypes> {
       return;
     }
     for (const isLocal of [true, false]) {
-      const key = this.storageKey(origin, isLocal);
+      const key = this.keyForSecurityOrigin(origin, isLocal);
       const storage = this.storagesInternal[key];
       if (!storage) {
         return;
@@ -167,10 +217,30 @@ export class DOMStorageModel extends SDK.SDKModel.SDKModel<EventTypes> {
     this.addOrigin(origin);
   }
 
+  clearForStorageKey(storageKey: string): void {
+    if (!this.enabled) {
+      return;
+    }
+    for (const isLocal of [true, false]) {
+      const key = this.keyForStorageKey(storageKey, isLocal);
+      const storage = this.storagesInternal[key];
+      if (!storage) {
+        return;
+      }
+      storage.clear();
+    }
+    this.removeStorageKey(storageKey);
+    this.addStorageKey(storageKey);
+  }
+
   private securityOriginAdded(event: Common.EventTarget.EventTargetEvent<string>): void {
     this.addOrigin(event.data);
   }
 
+  private storageKeyAdded(event: Common.EventTarget.EventTargetEvent<string>): void {
+    this.addStorageKey(event.data);
+  }
+
   private addOrigin(securityOrigin: string): void {
     const parsed = new Common.ParsedURL.ParsedURL(securityOrigin);
     // These are "opaque" origins which are not supposed to support DOM storage.
@@ -179,21 +249,67 @@ export class DOMStorageModel extends SDK.SDKModel.SDKModel<EventTypes> {
     }
 
     for (const isLocal of [true, false]) {
-      const key = this.storageKey(securityOrigin, isLocal);
+      const key = this.keyForSecurityOrigin(securityOrigin, isLocal);
       console.assert(!this.storagesInternal[key]);
-      const storage = new DOMStorage(this, securityOrigin, isLocal);
+      if (this.duplicateExists(key)) {
+        continue;
+      }
+      const storage = new DOMStorage(this, securityOrigin, '', isLocal);
+      this.storagesInternal[key] = storage;
+      this.dispatchEventToListeners(Events.DOMStorageAdded, storage);
+    }
+  }
+
+  private addStorageKey(storageKey: string): void {
+    for (const isLocal of [true, false]) {
+      const key = this.keyForStorageKey(storageKey, isLocal);
+      console.assert(!this.storagesInternal[key]);
+      if (this.duplicateExists(key)) {
+        continue;
+      }
+      const storage = new DOMStorage(this, '', storageKey, isLocal);
       this.storagesInternal[key] = storage;
       this.dispatchEventToListeners(Events.DOMStorageAdded, storage);
     }
   }
 
+  private duplicateExists(key: string): boolean {
+    const parsedKey = JSON.parse(key);
+    for (const storageInternal in this.storagesInternal) {
+      const parsedStorageInternalKey = JSON.parse(storageInternal);
+      if (parsedKey.isLocalStorage === parsedStorageInternalKey.isLocalStorage) {
+        if (parsedKey.storageKey?.slice(0, -1) === parsedStorageInternalKey.securityOrigin ||
+            parsedKey.securityOrigin === parsedStorageInternalKey.storageKey?.slice(0, -1)) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+
   private securityOriginRemoved(event: Common.EventTarget.EventTargetEvent<string>): void {
     this.removeOrigin(event.data);
   }
 
+  private storageKeyRemoved(event: Common.EventTarget.EventTargetEvent<string>): void {
+    this.removeStorageKey(event.data);
+  }
+
   private removeOrigin(securityOrigin: string): void {
     for (const isLocal of [true, false]) {
-      const key = this.storageKey(securityOrigin, isLocal);
+      const key = this.keyForSecurityOrigin(securityOrigin, isLocal);
+      const storage = this.storagesInternal[key];
+      if (!storage) {
+        continue;
+      }
+      delete this.storagesInternal[key];
+      this.dispatchEventToListeners(Events.DOMStorageRemoved, storage);
+    }
+  }
+
+  private removeStorageKey(storageKey: string): void {
+    for (const isLocal of [true, false]) {
+      const key = this.keyForStorageKey(storageKey, isLocal);
       const storage = this.storagesInternal[key];
       if (!storage) {
         continue;
@@ -203,8 +319,20 @@ export class DOMStorageModel extends SDK.SDKModel.SDKModel<EventTypes> {
     }
   }
 
-  private storageKey(securityOrigin: string, isLocalStorage: boolean): string {
-    return JSON.stringify(DOMStorage.storageId(securityOrigin, isLocalStorage));
+  private storageKey(securityOrigin: string, storageKey: string, isLocalStorage: boolean): string {
+    // TODO(crbug.com/1313434) Prioritize storageKey once everything is ready
+    if (securityOrigin) {
+      return JSON.stringify(DOMStorage.storageIdWithSecurityOrigin(securityOrigin, isLocalStorage));
+    }
+    return JSON.stringify(DOMStorage.storageIdWithStorageKey(storageKey, isLocalStorage));
+  }
+
+  private keyForSecurityOrigin(securityOrigin: string, isLocalStorage: boolean): string {
+    return this.storageKey(securityOrigin, '', isLocalStorage);
+  }
+
+  private keyForStorageKey(storageKey: string, isLocalStorage: boolean): string {
+    return this.storageKey('', storageKey, isLocalStorage);
   }
 
   domStorageItemsCleared(storageId: Protocol.DOMStorage.StorageId): void {

package/front_end/panels/application/StorageView.ts

@@ -147,6 +147,7 @@ export class StorageView extends UI.ThrottledWidget.ThrottledWidget {
   private reportView: UI.ReportView.ReportView;
   private target: SDK.Target.Target|null;
   private securityOrigin: string|null;
+  private storageKey: string|null;
   private settings: Map<Protocol.Storage.StorageType, Common.Settings.Setting<boolean>>;
   private includeThirdPartyCookiesSetting: Common.Settings.Setting<boolean>;
   private quotaRow: HTMLElement;
@@ -180,6 +181,7 @@ export class StorageView extends UI.ThrottledWidget.ThrottledWidget {
     this.reportView.show(this.contentElement);
     this.target = null;
     this.securityOrigin = null;
+    this.storageKey = null;
 
     this.settings = new Map();
     for (const type of AllStorageTypes) {
@@ -277,6 +279,11 @@ export class StorageView extends UI.ThrottledWidget.ThrottledWidget {
         securityOriginManager.mainSecurityOrigin(), securityOriginManager.unreachableMainSecurityOrigin());
     securityOriginManager.addEventListener(
         SDK.SecurityOriginManager.Events.MainSecurityOriginChanged, this.originChanged, this);
+    const storageKeyManager =
+        target.model(SDK.StorageKeyManager.StorageKeyManager) as SDK.StorageKeyManager.StorageKeyManager;
+    this.updateStorageKey(storageKeyManager.mainStorageKey());
+    storageKeyManager.addEventListener(
+        SDK.StorageKeyManager.Events.MainStorageKeyChanged, this.storageKeyChanged, this);
   }
 
   targetRemoved(target: SDK.Target.Target): void {
@@ -287,6 +294,10 @@ export class StorageView extends UI.ThrottledWidget.ThrottledWidget {
         SDK.SecurityOriginManager.SecurityOriginManager;
     securityOriginManager.removeEventListener(
         SDK.SecurityOriginManager.Events.MainSecurityOriginChanged, this.originChanged, this);
+    const storageKeyManager =
+        target.model(SDK.StorageKeyManager.StorageKeyManager) as SDK.StorageKeyManager.StorageKeyManager;
+    storageKeyManager.removeEventListener(
+        SDK.StorageKeyManager.Events.MainStorageKeyChanged, this.storageKeyChanged, this);
   }
 
   private originChanged(
@@ -295,6 +306,12 @@ export class StorageView extends UI.ThrottledWidget.ThrottledWidget {
     this.updateOrigin(mainSecurityOrigin, unreachableMainSecurityOrigin);
   }
 
+  private storageKeyChanged(
+      event: Common.EventTarget.EventTargetEvent<SDK.StorageKeyManager.MainStorageKeyChangedEvent>): void {
+    const {mainStorageKey} = event.data;
+    this.updateStorageKey(mainStorageKey);
+  }
+
   private updateOrigin(mainOrigin: string, unreachableMainOrigin: string|null): void {
     const oldOrigin = this.securityOrigin;
     if (unreachableMainOrigin) {
@@ -313,6 +330,20 @@ export class StorageView extends UI.ThrottledWidget.ThrottledWidget {
     void this.doUpdate();
   }
 
+  private updateStorageKey(mainStorageKey: string): void {
+    const oldStorageKey = this.storageKey;
+
+    this.storageKey = mainStorageKey;
+    this.reportView.setSubtitle(mainStorageKey);
+
+    if (oldStorageKey !== this.storageKey) {
+      this.quotaOverrideControlRow.classList.add('hidden');
+      this.quotaOverrideCheckbox.checkboxElement.checked = false;
+      this.quotaOverrideErrorMessage.textContent = '';
+    }
+    void this.doUpdate();
+  }
+
   private async applyQuotaOverrideFromInputField(): Promise<void> {
     if (!this.target || !this.securityOrigin) {
       this.quotaOverrideErrorMessage.textContent = i18nString(UIStrings.internalError);
@@ -375,7 +406,12 @@ export class StorageView extends UI.ThrottledWidget.ThrottledWidget {
 
     if (this.target) {
       const includeThirdPartyCookies = this.includeThirdPartyCookiesSetting.get();
-      StorageView.clear(this.target, this.securityOrigin, selectedStorageTypes, includeThirdPartyCookies);
+      // TODO(crbug.com/1313434) Prioritize storageKey once everything is ready
+      if (this.securityOrigin) {
+        StorageView.clear(this.target, this.securityOrigin, selectedStorageTypes, includeThirdPartyCookies);
+      } else if (this.storageKey) {
+        StorageView.clearByStorageKey(this.target, this.storageKey, selectedStorageTypes);
+      }
     }
 
     this.clearButton.disabled = true;
@@ -436,6 +472,20 @@ export class StorageView extends UI.ThrottledWidget.ThrottledWidget {
     }
   }
 
+  static clearByStorageKey(target: SDK.Target.Target, storageKey: string, selectedStorageTypes: string[]): void {
+    // TODO(crbug.com/1313434) Invoke protocol `clear` once it ready for storageKey
+
+    const set = new Set(selectedStorageTypes);
+    const hasAll = set.has(Protocol.Storage.StorageType.All);
+
+    if (set.has(Protocol.Storage.StorageType.Local_storage) || hasAll) {
+      const storageModel = target.model(DOMStorageModel);
+      if (storageModel) {
+        storageModel.clearForStorageKey(storageKey);
+      }
+    }
+  }
+
   async doUpdate(): Promise<void> {
     if (!this.securityOrigin || !this.target) {
       this.quotaRow.textContent = '';
@@ -556,6 +606,14 @@ export class ActionDelegate implements UI.ActionRegistration.ActionDelegate {
     return false;
   }
 
+  private async clear(target: SDK.Target.Target, resourceTreeModel: SDK.ResourceTreeModel.ResourceTreeModel):
+      Promise<void> {
+    const storageKey = await resourceTreeModel.getMainStorageKey();
+    if (storageKey) {
+      StorageView.clearByStorageKey(target, storageKey, AllStorageTypes);
+    }
+  }
+
   private handleClear(includeThirdPartyCookies: boolean): boolean {
     const target = SDK.TargetManager.TargetManager.instance().mainTarget();
     if (!target) {
@@ -566,11 +624,12 @@ export class ActionDelegate implements UI.ActionRegistration.ActionDelegate {
       return false;
     }
     const securityOrigin = resourceTreeModel.getMainSecurityOrigin();
-    if (!securityOrigin) {
-      return false;
+    // TODO(crbug.com/1313434) Prioritize storageKey functionality once everything is ready
+    if (securityOrigin) {
+      StorageView.clear(target, securityOrigin, AllStorageTypes, includeThirdPartyCookies);
+      return true;
     }
-
-    StorageView.clear(target, securityOrigin, AllStorageTypes, includeThirdPartyCookies);
+    void this.clear(target, resourceTreeModel);
     return true;
   }
 }

package/front_end/panels/elements/ElementsTreeElement.ts

@@ -294,7 +294,7 @@ export class ElementsTreeElement extends UI.TreeOutline.TreeElement {
       if (node.isAdFrameNode()) {
         const config = ElementsComponents.AdornerManager.getRegisteredAdorner(
             ElementsComponents.AdornerManager.RegisteredAdorners.AD);
-        const adorner = this.adorn(config, this.tagTypeContext);
+        const adorner = this.adorn(config);
         UI.Tooltip.Tooltip.install(adorner, i18nString(UIStrings.thisFrameWasIdentifiedAsAnAd));
       }
     }
@@ -1962,17 +1962,22 @@ export class ElementsTreeElement extends UI.TreeOutline.TreeElement {
   }
 
   // TODO: add unit tests for adorner-related methods after component and TypeScript works are done
-  adorn({name}: {name: string}, context: OpeningTagContext): Adorners.Adorner.Adorner {
-    const adornerContent = document.createElement('span');
-    adornerContent.textContent = name;
+  adorn({name}: {name: string}, content?: HTMLElement): Adorners.Adorner.Adorner {
+    let adornerContent = content;
+    if (!adornerContent) {
+      adornerContent = document.createElement('span');
+      adornerContent.textContent = name;
+    }
     const adorner = new Adorners.Adorner.Adorner();
     adorner.data = {
       name,
       content: adornerContent,
     };
-    context.adorners.push(adorner);
-    ElementsPanel.instance().registerAdorner(adorner);
-    this.updateAdorners(context);
+    if (isOpeningTag(this.tagTypeContext)) {
+      this.tagTypeContext.adorners.push(adorner);
+      ElementsPanel.instance().registerAdorner(adorner);
+      this.updateAdorners(this.tagTypeContext);
+    }
     return adorner;
   }
 
@@ -2010,14 +2015,16 @@ export class ElementsTreeElement extends UI.TreeOutline.TreeElement {
     }
   }
 
-  removeAllAdorners(context: OpeningTagContext): void {
-    for (const adorner of context.adorners) {
-      ElementsPanel.instance().deregisterAdorner(adorner);
-      adorner.remove();
-    }
+  removeAllAdorners(): void {
+    if (isOpeningTag(this.tagTypeContext)) {
+      for (const adorner of this.tagTypeContext.adorners) {
+        ElementsPanel.instance().deregisterAdorner(adorner);
+        adorner.remove();
+      }
 
-    context.adorners = [];
-    this.updateAdorners(context);
+      this.tagTypeContext.adorners = [];
+      this.updateAdorners(this.tagTypeContext);
+    }
   }
 
   private updateAdorners(context: OpeningTagContext): void {
@@ -2098,7 +2105,7 @@ export class ElementsTreeElement extends UI.TreeOutline.TreeElement {
 
     const config = ElementsComponents.AdornerManager.getRegisteredAdorner(
         ElementsComponents.AdornerManager.RegisteredAdorners.GRID);
-    const adorner = this.adorn(config, context);
+    const adorner = this.adorn(config);
     adorner.classList.add('grid');
 
     const onClick = (((): void => {
@@ -2135,7 +2142,7 @@ export class ElementsTreeElement extends UI.TreeOutline.TreeElement {
     }
     const config = ElementsComponents.AdornerManager.getRegisteredAdorner(
         ElementsComponents.AdornerManager.RegisteredAdorners.SCROLL_SNAP);
-    const adorner = this.adorn(config, context);
+    const adorner = this.adorn(config);
     adorner.classList.add('scroll-snap');
 
     const onClick = (((): void => {
@@ -2174,7 +2181,7 @@ export class ElementsTreeElement extends UI.TreeOutline.TreeElement {
     }
     const config = ElementsComponents.AdornerManager.getRegisteredAdorner(
         ElementsComponents.AdornerManager.RegisteredAdorners.FLEX);
-    const adorner = this.adorn(config, context);
+    const adorner = this.adorn(config);
     adorner.classList.add('flex');
 
     const onClick = (((): void => {
@@ -2213,7 +2220,7 @@ export class ElementsTreeElement extends UI.TreeOutline.TreeElement {
     }
     const config = ElementsComponents.AdornerManager.getRegisteredAdorner(
         ElementsComponents.AdornerManager.RegisteredAdorners.CONTAINER);
-    const adorner = this.adorn(config, context);
+    const adorner = this.adorn(config);
     adorner.classList.add('container');
 
     const onClick = (((): void => {

package/front_end/panels/elements/ElementsTreeOutline.ts

@@ -43,6 +43,7 @@ import {ElementsPanel} from './ElementsPanel.js';
 import {ElementsTreeElement, InitialChildrenLimit} from './ElementsTreeElement.js';
 import elementsTreeOutlineStyles from './elementsTreeOutline.css.js';
 import {ImagePreviewPopover} from './ImagePreviewPopover.js';
+import {TopLayerContainer} from './TopLayerContainer.js';
 
 import type {MarkerDecoratorRegistration} from './MarkerDecorator.js';
 
@@ -100,6 +101,7 @@ export class ElementsTreeOutline extends
   private treeElementBeingDragged?: ElementsTreeElement;
   private dragOverTreeElement?: ElementsTreeElement;
   private updateModifiedNodesTimeout?: number;
+  private topLayerContainer?: TopLayerContainer;
 
   constructor(omitRootDOMNode?: boolean, selectEnabled?: boolean, hideGutter?: boolean) {
     super();
@@ -1001,6 +1003,7 @@ export class ElementsTreeOutline extends
     domModel.addEventListener(SDK.DOMModel.Events.DocumentUpdated, this.documentUpdated, this);
     domModel.addEventListener(SDK.DOMModel.Events.ChildNodeCountUpdated, this.childNodeCountUpdated, this);
     domModel.addEventListener(SDK.DOMModel.Events.DistributedNodesChanged, this.distributedNodesChanged, this);
+    domModel.addEventListener(SDK.DOMModel.Events.TopLayerElementsChanged, this.topLayerElementsChanged, this);
   }
 
   unwireFromDOMModel(domModel: SDK.DOMModel.DOMModel): void {
@@ -1013,6 +1016,7 @@ export class ElementsTreeOutline extends
     domModel.removeEventListener(SDK.DOMModel.Events.DocumentUpdated, this.documentUpdated, this);
     domModel.removeEventListener(SDK.DOMModel.Events.ChildNodeCountUpdated, this.childNodeCountUpdated, this);
     domModel.removeEventListener(SDK.DOMModel.Events.DistributedNodesChanged, this.distributedNodesChanged, this);
+    domModel.removeEventListener(SDK.DOMModel.Events.TopLayerElementsChanged, this.topLayerElementsChanged, this);
     elementsTreeOutlineByDOMModel.delete(domModel);
   }
 
@@ -1164,13 +1168,41 @@ export class ElementsTreeOutline extends
       return Promise.resolve();
     }
 
-    return new Promise(resolve => {
-      treeElement.node().getChildNodes(() => {
-        populatedTreeElements.add(treeElement);
-        this.updateModifiedParentNode(treeElement.node());
-        resolve();
-      });
-    });
+    return new Promise<void>(resolve => {
+             treeElement.node().getChildNodes(() => {
+               populatedTreeElements.add(treeElement);
+               this.updateModifiedParentNode(treeElement.node());
+               resolve();
+             });
+           })
+        .then(() => {
+          if (treeElement.node().nodeName() === 'BODY') {
+            void this.createTopLayerContainer(treeElement);
+          }
+        });
+  }
+
+  async createTopLayerContainer(bodyElement: ElementsTreeElement): Promise<void> {
+    if (!this.topLayerContainer) {
+      this.topLayerContainer = new TopLayerContainer(bodyElement);
+    }
+    this.topLayerContainer.updateBody(bodyElement);
+    await this.updateTopLayerContainer();
+  }
+
+  async updateTopLayerContainer(): Promise<void> {
+    if (this.topLayerContainer) {
+      const bodyElement = this.topLayerContainer.bodyElement;
+      if (!bodyElement.children().includes(this.topLayerContainer) && !this.topLayerContainer.parent &&
+          !this.topLayerContainer.treeOutline) {
+        bodyElement.insertChild(this.topLayerContainer, bodyElement.childCount() - 1);
+      }
+      this.topLayerContainer.removeChildren();
+      const topLayerElementsExists = await this.topLayerContainer.addTopLayerElementsAsChildren();
+      if (!topLayerElementsExists) {
+        bodyElement.removeChild(this.topLayerContainer);
+      }
+    }
   }
 
   private createElementTreeElement(node: SDK.DOMModel.DOMNode, isClosingTag?: boolean): ElementsTreeElement {
@@ -1318,7 +1350,7 @@ export class ElementsTreeOutline extends
   }
 
   insertChildElement(
-      treeElement: ElementsTreeElement, child: SDK.DOMModel.DOMNode, index: number,
+      treeElement: ElementsTreeElement|TopLayerContainer, child: SDK.DOMModel.DOMNode, index: number,
       isClosingTag?: boolean): ElementsTreeElement {
     const newElement = this.createElementTreeElement(child, isClosingTag);
     treeElement.insertChild(newElement, index);
@@ -1427,6 +1459,10 @@ export class ElementsTreeOutline extends
     }
   }
 
+  private async topLayerElementsChanged(): Promise<void> {
+    await this.updateTopLayerContainer();
+  }
+
   private static treeOutlineSymbol = Symbol('treeOutline');
 }
 

package/front_end/panels/elements/TopLayerContainer.ts

@@ -0,0 +1,97 @@
+// Copyright 2022 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 * as i18n from '../../core/i18n/i18n.js';
+import * as SDK from '../../core/sdk/sdk.js';
+import * as UI from '../../ui/legacy/legacy.js';
+
+import * as ElementsComponents from './components/components.js';
+import * as ElementsTreeOutline from './ElementsTreeOutline.js';
+
+import type {ElementsTreeElement} from './ElementsTreeElement.js';
+
+const UIStrings = {
+  /**
+   * @description Top layer is rendered closest to the user within a viewport, therefore its elements always appear on top of all other content
+   */
+  topLayer: 'top-layer',
+};
+
+const str_ = i18n.i18n.registerUIStrings('panels/elements/TopLayerContainer.ts', UIStrings);
+const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
+
+export class TopLayerContainer extends UI.TreeOutline.TreeElement {
+  treeOutline: ElementsTreeOutline.ElementsTreeOutline|null;
+  domModel: SDK.DOMModel.DOMModel;
+  currentTopLayerElements: Set<ElementsTreeElement>;
+  bodyElement: ElementsTreeElement;
+
+  constructor(bodyElement: ElementsTreeElement) {
+    super('#top-layer');
+    this.bodyElement = bodyElement;
+    this.domModel = bodyElement.node().domModel();
+    this.treeOutline = null;
+    this.currentTopLayerElements = new Set();
+  }
+
+  updateBody(bodyElement: ElementsTreeElement): void {
+    this.bodyElement = bodyElement;
+  }
+
+  async addTopLayerElementsAsChildren(): Promise<boolean> {
+    this.removeCurrentTopLayerElementsAdorners();
+    this.currentTopLayerElements = new Set();
+    const newTopLayerElementsIDs = await this.domModel.getTopLayerElements();
+    if (newTopLayerElementsIDs === null) {
+      return false;
+    }
+    let topLayerElementIndex = 0;
+    if (newTopLayerElementsIDs) {
+      for (const elementID of newTopLayerElementsIDs) {
+        const topLayerDOMNode = this.domModel.idToDOMNode.get(elementID);
+        // Will need to add support for backdrop in the future.
+        if (topLayerDOMNode && topLayerDOMNode.nodeName() !== '::backdrop') {
+          topLayerElementIndex++;
+          const topLayerElementShortcut = new SDK.DOMModel.DOMNodeShortcut(
+              this.domModel.target(), topLayerDOMNode.backendNodeId(), 0, topLayerDOMNode.nodeName());
+          const topLayerTreeElement = this.treeOutline?.treeElementByNode.get(topLayerDOMNode);
+          const topLayerElementRepresentation = new ElementsTreeOutline.ShortcutTreeElement(topLayerElementShortcut);
+          if (topLayerTreeElement && !this.currentTopLayerElements.has(topLayerTreeElement)) {
+            this.appendChild(topLayerElementRepresentation);
+            this.addTopLayerAdorner(topLayerTreeElement, topLayerElementRepresentation, topLayerElementIndex);
+            this.currentTopLayerElements.add(topLayerTreeElement);
+          }
+        }
+      }
+    }
+    return topLayerElementIndex > 0;
+  }
+
+  private removeCurrentTopLayerElementsAdorners(): void {
+    for (const topLayerElement of this.currentTopLayerElements) {
+      topLayerElement.removeAllAdorners();
+    }
+  }
+
+  private addTopLayerAdorner(
+      element: ElementsTreeElement, topLayerElementRepresentation: ElementsTreeOutline.ShortcutTreeElement,
+      topLayerElementIndex: number): void {
+    const config = ElementsComponents.AdornerManager.getRegisteredAdorner(
+        ElementsComponents.AdornerManager.RegisteredAdorners.TOP_LAYER);
+    const adornerContent = document.createElement('span');
+    adornerContent.textContent = ` top-layer (${topLayerElementIndex}) `;
+    const adorner = element?.adorn(config, adornerContent);
+    if (adorner) {
+      const onClick = (((): void => {
+                         topLayerElementRepresentation.revealAndSelect();
+                       }) as EventListener);
+      adorner.addInteraction(onClick, {
+        isToggle: false,
+        shouldPropagateOnKeydown: false,
+        ariaLabelDefault: i18nString(UIStrings.topLayer),
+        ariaLabelActive: i18nString(UIStrings.topLayer),
+      });
+      adorner.addEventListener('mousedown', e => e.consume(), false);
+    }
+  }
+}