chrome-devtools-frontend 1.0.1506453 → 1.0.1510180

package/front_end/testing/UISourceCodeHelpers.ts

@@ -1,157 +0,0 @@
-// 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 Common from '../core/common/common.js';
-import * as Platform from '../core/platform/platform.js';
-import type * as SDK from '../core/sdk/sdk.js';
-import * as Bindings from '../models/bindings/bindings.js';
-import * as Persistence from '../models/persistence/persistence.js';
-import * as TextUtils from '../models/text_utils/text_utils.js';
-import * as Workspace from '../models/workspace/workspace.js';
-
-const {urlString} = Platform.DevToolsPath;
-
-export function createContentProviderUISourceCodes(options: {
-  items: Array<{
-    url: Platform.DevToolsPath.UrlString,
-    mimeType: string,
-    content?: string,
-    resourceType?: Common.ResourceType.ResourceType,
-    metadata?: Workspace.UISourceCode.UISourceCodeMetadata,
-  }>,
-  projectType?: Workspace.Workspace.projectTypes,
-  projectId?: string,
-  target?: SDK.Target.Target,
-}): {
-  project: Bindings.ContentProviderBasedProject.ContentProviderBasedProject,
-  uiSourceCodes: Workspace.UISourceCode.UISourceCode[],
-} {
-  const workspace = Workspace.Workspace.WorkspaceImpl.instance();
-  const projectType = options.projectType || Workspace.Workspace.projectTypes.Formatter;
-  assert.notEqual(
-      projectType, Workspace.Workspace.projectTypes.FileSystem,
-      'For creating file system UISourceCodes use \'createFileSystemUISourceCode\' helper.');
-  const project = new Bindings.ContentProviderBasedProject.ContentProviderBasedProject(
-      workspace, options.projectId || 'PROJECT_ID', projectType, 'Test project', false /* isServiceProject*/);
-  if (options.target) {
-    Bindings.NetworkProject.NetworkProject.setTargetForProject(project, options.target);
-  }
-  const uiSourceCodes: Workspace.UISourceCode.UISourceCode[] = [];
-  for (const item of options.items) {
-    const resourceType = item.resourceType || Common.ResourceType.ResourceType.fromMimeType(item.mimeType);
-    const uiSourceCode = project.createUISourceCode(item.url, resourceType);
-    const contentProvider =
-        TextUtils.StaticContentProvider.StaticContentProvider.fromString(item.url, resourceType, item.content || '');
-    const metadata = item.metadata || new Workspace.UISourceCode.UISourceCodeMetadata(null, null);
-    project.addUISourceCodeWithProvider(uiSourceCode, contentProvider, metadata, item.mimeType);
-    uiSourceCodes.push(uiSourceCode);
-  }
-  return {project, uiSourceCodes};
-}
-
-export function createContentProviderUISourceCode(options: {
-  url: Platform.DevToolsPath.UrlString,
-  mimeType: string,
-  content?: string,
-  projectType?: Workspace.Workspace.projectTypes,
-  projectId?: string,
-  metadata?: Workspace.UISourceCode.UISourceCodeMetadata,
-  target?: SDK.Target.Target,
-}): {
-  project: Bindings.ContentProviderBasedProject.ContentProviderBasedProject,
-  uiSourceCode: Workspace.UISourceCode.UISourceCode,
-} {
-  const {url, content, mimeType, metadata, projectType, projectId, target} = options;
-  const {project, uiSourceCodes} =
-      createContentProviderUISourceCodes({items: [{url, content, mimeType, metadata}], projectType, projectId, target});
-  return {project, uiSourceCode: uiSourceCodes[0]};
-}
-
-class TestPlatformFileSystem extends Persistence.PlatformFileSystem.PlatformFileSystem {
-  readonly #mimeType: string;
-  readonly #autoMapping: boolean;
-
-  constructor(
-      path: Platform.DevToolsPath.UrlString, type: Persistence.PlatformFileSystem.PlatformFileSystemType,
-      mimeType: string, autoMapping: boolean) {
-    super(path, type, false);
-    this.#mimeType = mimeType;
-    this.#autoMapping = autoMapping;
-  }
-  override tooltipForURL(_url: Platform.DevToolsPath.UrlString): string {
-    return 'tooltip-for-url';
-  }
-  override supportsAutomapping(): boolean {
-    return this.#autoMapping;
-  }
-  override mimeFromPath(_path: Platform.DevToolsPath.UrlString): string {
-    return this.#mimeType;
-  }
-}
-
-class TestFileSystem extends Persistence.FileSystemWorkspaceBinding.FileSystem {
-  readonly #content: string;
-  readonly #metadata: Workspace.UISourceCode.UISourceCodeMetadata;
-
-  constructor(options: {
-    fileSystemWorkspaceBinding: Persistence.FileSystemWorkspaceBinding.FileSystemWorkspaceBinding,
-    platformFileSystem: Persistence.PlatformFileSystem.PlatformFileSystem,
-    workspace: Workspace.Workspace.WorkspaceImpl,
-    content: string,
-    metadata: Workspace.UISourceCode.UISourceCodeMetadata,
-  }) {
-    super(options.fileSystemWorkspaceBinding, options.platformFileSystem, options.workspace);
-    this.#content = options.content;
-    this.#metadata = options.metadata;
-  }
-
-  override requestFileContent(_uiSourceCode: Workspace.UISourceCode.UISourceCode):
-      Promise<TextUtils.ContentData.ContentDataOrError> {
-    return Promise.resolve(new TextUtils.ContentData.ContentData(this.#content, /* isBase64 */ false, 'text/plain'));
-  }
-
-  override requestMetadata(_uiSourceCode: Workspace.UISourceCode.UISourceCode):
-      Promise<Workspace.UISourceCode.UISourceCodeMetadata|null> {
-    return Promise.resolve(this.#metadata);
-  }
-}
-
-export function createFileSystemUISourceCode(options: {
-  url: Platform.DevToolsPath.UrlString,
-  mimeType: string,
-  content?: string,
-  fileSystemPath?: string,
-  autoMapping?: boolean,
-  type?: Persistence.PlatformFileSystem.PlatformFileSystemType,
-  metadata?: Workspace.UISourceCode.UISourceCodeMetadata,
-}): {uiSourceCode: Workspace.UISourceCode.UISourceCode, project: Persistence.FileSystemWorkspaceBinding.FileSystem} {
-  const workspace = Workspace.Workspace.WorkspaceImpl.instance();
-  const isolatedFileSystemManager = Persistence.IsolatedFileSystemManager.IsolatedFileSystemManager.instance();
-  const fileSystemWorkspaceBinding =
-      new Persistence.FileSystemWorkspaceBinding.FileSystemWorkspaceBinding(isolatedFileSystemManager, workspace);
-  const fileSystemPath = urlString`${options.fileSystemPath || ''}`;
-  const type = options.type || '';
-  const content = options.content || '';
-  const platformFileSystem = new TestPlatformFileSystem(
-      fileSystemPath, type || Persistence.PlatformFileSystem.PlatformFileSystemType.WORKSPACE_PROJECT, options.mimeType,
-      Boolean(options.autoMapping));
-  const metadata = options.metadata || new Workspace.UISourceCode.UISourceCodeMetadata(null, null);
-
-  const project = new TestFileSystem({fileSystemWorkspaceBinding, platformFileSystem, workspace, content, metadata});
-
-  const uiSourceCode =
-      project.createUISourceCode(options.url, Common.ResourceType.ResourceType.fromMimeType(options.mimeType));
-  project.addUISourceCode(uiSourceCode);
-  return {uiSourceCode, project};
-}
-
-export function setupMockedUISourceCode(url = 'https://example.com/') {
-  const projectStub = sinon.createStubInstance(Bindings.ContentProviderBasedProject.ContentProviderBasedProject);
-  const urlStringTagExample = urlString`${url}`;
-  const contentTypeStub = sinon.createStubInstance(Common.ResourceType.ResourceType);
-
-  const uiSourceCode = new Workspace.UISourceCode.UISourceCode(projectStub, urlStringTagExample, contentTypeStub);
-
-  return {sut: uiSourceCode, projectStub, contentTypeStub};
-}

package/front_end/testing/UserMetricsHelpers.ts

@@ -1,17 +0,0 @@
-// 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 Host from '../core/host/host.js';
-
-/**
- * @returns True, iff a metric event with the provided name and code was recorded. False otherwise.
- */
-export function recordedMetricsContain(actionName: string, actionCode: number): boolean {
-  return Host.InspectorFrontendHost.InspectorFrontendHostInstance.recordedEnumeratedHistograms.some(
-      event => event.actionName === actionName && event.actionCode === actionCode);
-}
-
-export function resetRecordedMetrics(): void {
-  Host.InspectorFrontendHost.InspectorFrontendHostInstance.recordedEnumeratedHistograms = [];
-}

package/front_end/testing/ViewFunctionHelpers.ts

@@ -1,62 +0,0 @@
-// Copyright 2025 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 Platform from '../core/platform/platform.js';
-import type * as UI from '../ui/legacy/legacy.js';
-
-type WidgetConstructor = Platform.Constructor.AbstractConstructor<UI.Widget.Widget|HTMLElement>;
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type ViewFunctionLike = (input: any, output: any, target: HTMLElement) => void;
-
-type FindViewFunction<ParametersT extends readonly unknown[]> = ParametersT extends [infer Head, ...infer Tail] ?
-    Head extends ViewFunctionLike ? Head : FindViewFunction<Tail>:
-    never;
-
-type ViewFunction<WidgetConstructorT extends WidgetConstructor> =
-    FindViewFunction<Required<ConstructorParameters<WidgetConstructorT>>>;
-
-type ViewFunctionParameters<WidgetConstructorT extends WidgetConstructor> =
-    Parameters<ViewFunction<WidgetConstructorT>>;
-
-type ViewInput<WidgetConstructorT extends WidgetConstructor> = ViewFunctionParameters<WidgetConstructorT>[0];
-
-type ViewOutput<WidgetConstructorT extends WidgetConstructor> = ViewFunctionParameters<WidgetConstructorT>[1];
-
-interface ViewStubExtensions<WidgetConstructorT extends WidgetConstructor> extends
-    sinon.SinonSpy<[ViewInput<WidgetConstructorT>, ViewOutput<WidgetConstructorT>, HTMLElement], void> {
-  input: ViewInput<WidgetConstructorT>;
-  nextInput: Promise<ViewInput<WidgetConstructorT>>;
-  callCount: number;
-}
-
-interface InternalViewStubExtensions<WidgetConstructorT extends WidgetConstructor> extends
-    ViewStubExtensions<WidgetConstructorT> {
-  invoked?: (input: ViewInput<WidgetConstructorT>) => void;
-}
-
-export type ViewFunctionStub<WidgetConstructorT extends WidgetConstructor> =
-    ViewFunction<WidgetConstructorT>&ViewStubExtensions<WidgetConstructorT>;
-
-export function createViewFunctionStub<WidgetConstructorT extends WidgetConstructor>(
-    _constructor: WidgetConstructorT,
-    outputValues?: ViewOutput<WidgetConstructorT>,
-    ): ViewFunctionStub<WidgetConstructorT> {
-  const result: InternalViewStubExtensions<WidgetConstructorT> =
-      sinon.fake(
-          (input: ViewInput<WidgetConstructorT>, output: ViewOutput<WidgetConstructorT>, _target: HTMLElement) => {
-            result.input = input;
-            if (output && outputValues) {
-              Object.assign(output, outputValues);
-            }
-            result.invoked?.(input);
-          }) as ViewFunctionStub<WidgetConstructorT>;
-  Object.defineProperty(result, 'nextInput', {
-    get() {
-      return new Promise<ViewInput<WidgetConstructorT>>(resolve => {
-        result.invoked = resolve;
-      });
-    }
-  });
-  return result as ViewFunctionStub<WidgetConstructorT>;
-}

package/front_end/testing/VisualLoggingHelpers.ts

@@ -1,11 +0,0 @@
-// Copyright 2023 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 VisualLogging from '../ui/visual_logging/visual_logging-testing.js';
-
-export function getVeId(loggable: VisualLogging.Loggable.Loggable|string): number {
-  if (typeof loggable === 'string') {
-    loggable = document.querySelector(loggable)!;
-  }
-  return VisualLogging.LoggingState.getLoggingState(loggable)!.veid;
-}

package/front_end/testing/test_setup.ts

@@ -1,117 +0,0 @@
-// Copyright 2020 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.
-
-/*
- * This file is automatically loaded and run by Karma because it automatically
- * loads and injects all *.js files it finds.
- */
-
-import * as Common from '../core/common/common.js';
-import * as Host from '../core/host/host.js';
-import * as Root from '../core/root/root.js';
-import * as Trace from '../models/trace/trace.js';
-import * as Timeline from '../panels/timeline/timeline.js';
-import * as UI from '../ui/legacy/legacy.js';
-import * as ThemeSupport from '../ui/legacy/theme_support/theme_support.js';
-
-import {cleanTestDOM, raf, setupTestDOM} from './DOMHelpers.js';
-import {createFakeSetting, resetHostConfig} from './EnvironmentHelpers.js';
-import {
-  checkForPendingActivity,
-  startTrackingAsyncActivity,
-  stopTrackingAsyncActivity,
-} from './TrackAsyncOperations.js';
-
-const style = document.createElement('style');
-style.innerText =
-    '@import url(\'https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,100..900;1,100..900&display=swap\');';
-document.head.append(style);
-document.documentElement.classList.add('platform-screenshot-test');
-
-const documentBodyElements = new Set<Element>();
-
-// Warm-up fonts to be readily available.
-before(async () => {
-  const div = document.createElement('div');
-  div.style.fontFamily = 'roboto';
-  // Some latin characters to trigger the latin font file to be loaded.
-  // Additional non-lating characters can be included if needed.
-  div.innerText = 'abc';
-  // eslint-disable-next-line rulesdir/no-document-body-mutation
-  document.body.append(div);
-  await document.fonts.ready;
-  div.remove();
-});
-
-beforeEach(async () => {
-  resetHostConfig();
-  for (const child of document.body.children) {
-    documentBodyElements.add(child);
-  }
-  await setupTestDOM();
-
-  // Ensure that no trace data leaks between tests when testing the trace engine.
-  for (const handler of Object.values(Trace.Handlers.ModelHandlers)) {
-    handler.reset();
-  }
-  Trace.Helpers.SyntheticEvents.SyntheticEventsManager.reset();
-  Timeline.Utils.SourceMapsResolver.SourceMapsResolver.clearResolvedNodeNames();
-
-  // Don't retain host binding listeners across tests. Set this up before initializing ThemeSupport as
-  // ThemeSupport adds a host binding listener.
-  Host.InspectorFrontendHost.InspectorFrontendHostInstance.events = new Common.ObjectWrapper.ObjectWrapper();
-
-  // Some unit tests exercise code that assumes a ThemeSupport instance is available.
-  // Run this in a beforeEach in case an individual test overrides it.
-  const setting = createFakeSetting('theme', 'default');
-  ThemeSupport.ThemeSupport.instance({forceNew: true, setting});
-
-  startTrackingAsyncActivity();
-});
-
-/**
- * If a widget creates a glass pane, it can get orphaned and not cleaned up correctly.
- */
-function removeGlassPanes() {
-  for (const pane of document.body.querySelectorAll('[data-devtools-glass-pane]')) {
-    document.body.removeChild(pane);
-  }
-}
-/**
- * If a text editor is created we create a special parent for the tooltip
- * This does not get cleared after render, but it's internals do.
- * So we need to manually remove it
- */
-function removeTextEditorTooltip() {
-  // Found in front_end/ui/components/text_editor/config.ts
-  for (const pane of document.body.querySelectorAll('.editor-tooltip-host')) {
-    document.body.removeChild(pane);
-  }
-}
-
-afterEach(async function() {
-  cleanTestDOM();
-  removeGlassPanes();
-  removeTextEditorTooltip();
-  UI.ARIAUtils.LiveAnnouncer.removeAnnouncerElements(document.body);
-  // Make sure all DOM clean up happens before the raf
-  await raf();
-
-  for (const child of document.body.children) {
-    if (!documentBodyElements.has(child)) {
-      console.error(`Test "${this.currentTest?.fullTitle()}" left DOM in document.body:`);
-      console.error(child);
-    }
-  }
-  for (const key of Object.keys(Root.Runtime.hostConfig)) {
-    // @ts-expect-error
-    delete Root.Runtime.hostConfig[key];
-  }
-
-  await checkForPendingActivity();
-  resetHostConfig();
-  sinon.restore();
-  stopTrackingAsyncActivity();
-  // Clear out any Sinon stubs or spies between individual tests.
-});

package/front_end/ui/components/adorners/Adorner.test.ts

@@ -1,134 +0,0 @@
-// Copyright 2020 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 Common from '../../../core/common/common.js';
-import type * as Platform from '../../../core/platform/platform.js';
-
-import * as Adorners from './adorners.js';
-
-const ADORNER_TAG_NAME = 'DEVTOOLS-ADORNER';
-
-describe('Adorner', () => {
-  function assertIsAdorner(element: HTMLElement) {
-    assert.strictEqual(element.tagName, ADORNER_TAG_NAME, `element tag name is not ${ADORNER_TAG_NAME}`);
-    assert.instanceOf(element, Adorners.Adorner.Adorner, 'element is not an instance of Adorner');
-    assert.strictEqual(
-        Object.getPrototypeOf(element), Adorners.Adorner.Adorner.prototype,
-        'element is not on Adorner\'s prototype chain');
-  }
-
-  it('can be created by document.createElement', () => {
-    const adorner = document.createElement('devtools-adorner');
-    assertIsAdorner(adorner);
-  });
-
-  it('can interacts as a toggle button with proper ARIA setup', () => {
-    const content = document.createElement('span');
-    const adorner = new Adorners.Adorner.Adorner();
-    adorner.data = {
-      content,
-      name: 'foo',
-    };
-    assert.isNull(adorner.getAttribute('role'), 'non-interactive adorner had wrong aria role value');
-
-    let clickCounter = 0;
-    const clickListener = () => {
-      clickCounter++;
-    };
-
-    const ariaLabelDefault = 'adorner toggled on' as Platform.UIString.LocalizedString;
-    const ariaLabelActive = 'adorner toggled off' as Platform.UIString.LocalizedString;
-    adorner.addInteraction(clickListener, {
-      isToggle: true,
-      shouldPropagateOnKeydown: false,
-      ariaLabelActive,
-      ariaLabelDefault,
-    });
-    assert.strictEqual(
-        adorner.getAttribute('aria-label'), ariaLabelDefault,
-        'interactive adorner didn\'t have correct initial aria-label value');
-    assert.strictEqual(
-        adorner.getAttribute('role'), 'button', 'interactive adorner didn\'t have correct aria role setup');
-    assert.strictEqual(
-        adorner.getAttribute('aria-pressed'), 'false',
-        'toggle adorner didn\'t have correct initial aria-pressed value');
-
-    adorner.click();
-    assert.strictEqual(clickCounter, 1, 'interactive adorner was not triggered by clicking');
-    assert.strictEqual(
-        adorner.getAttribute('aria-label'), ariaLabelActive,
-        'interactive adorner didn\'t have correct active aria-label value');
-    assert.strictEqual(
-        adorner.getAttribute('aria-pressed'), 'true', 'toggle adorner didn\'t have correct active aria-pressed value');
-
-    adorner.dispatchEvent(new KeyboardEvent('keydown', {code: 'Enter'}));
-    assert.strictEqual(clickCounter, 2, 'interactive adorner was not triggered by Enter key');
-    assert.strictEqual(
-        adorner.getAttribute('aria-label'), ariaLabelDefault,
-        'interactive adorner didn\'t have correct inactive aria-label value');
-    assert.strictEqual(
-        adorner.getAttribute('aria-pressed'), 'false',
-        'toggle adorner didn\'t have correct inactive aria-pressed value');
-
-    adorner.dispatchEvent(new KeyboardEvent('keydown', {code: 'Space'}));
-    assert.strictEqual(clickCounter, 3, 'interactive adorner was not triggered by Space key');
-    assert.strictEqual(
-        adorner.getAttribute('aria-label'), ariaLabelActive,
-        'interactive adorner didn\'t have correct active aria-label value');
-    assert.strictEqual(
-        adorner.getAttribute('aria-pressed'), 'true', 'toggle adorner didn\'t have correct active aria-pressed value');
-  });
-
-  it('can be toggled programmatically', () => {
-    const content = document.createElement('span');
-    const adorner = new Adorners.Adorner.Adorner();
-    adorner.data = {
-      content,
-      name: 'foo',
-    };
-    adorner.addInteraction(() => {}, {
-      isToggle: true,
-      shouldPropagateOnKeydown: false,
-      ariaLabelActive: Common.UIString.LocalizedEmptyString,
-      ariaLabelDefault: Common.UIString.LocalizedEmptyString,
-    });
-    assert.strictEqual(
-        adorner.getAttribute('aria-pressed'), 'false',
-        'toggle adorner didn\'t have correct initial aria-pressed value');
-
-    adorner.toggle();
-    assert.strictEqual(
-        adorner.getAttribute('aria-pressed'), 'true', 'toggle adorner didn\'t have correct active aria-pressed value');
-  });
-
-  it('only contains the most recently slotted content after multiple data setting calls', () => {
-    const content1 = document.createElement('span');
-    content1.textContent = 'content 1';
-
-    const content2 = document.createElement('div');
-    content2.textContent = 'content 2';
-
-    const content3 = document.createElement('span');
-    content3.textContent = 'content 3';
-
-    const adorner = new Adorners.Adorner.Adorner();
-    adorner.data = {
-      content: content1,
-      name: 'foo',
-    };
-    adorner.data = {
-      content: content2,
-      name: 'foo',
-    };
-    adorner.data = {
-      content: content3,
-      name: 'foo',
-    };
-
-    const slottedChildren = adorner.children;
-    assert.lengthOf(slottedChildren, 1, 'adorner light dom should only have one child with [slot="content"]');
-    assert.strictEqual(
-        slottedChildren[0].textContent, 'content 3', 'adorner content slot should have the most recent content');
-  });
-});