chrome-devtools-frontend 1.0.1040337 → 1.0.1070764

package/docs/localization/localization_apis.md

@@ -1,80 +0,0 @@
-Access localized strings in the DevTools frontend using the following localization calls.
-
-## i18nString
-The basic API to make a string (with or without placeholder) localizable.
-The first argument is the string reference in `UIStrings`
-The second argument is an object for placeholders (if any)
-
-```javascript
-// at the top of example.js file, after import statements
-
-const UIStrings = {
-  /**
-    * @description This is an example description for my new string with placeholder
-    * @example {example for placeholder} PH1
-    * @example {example 2 for placeholder 2} PH2
-    */
-  addAnotherString: 'Another new string I want to add, with {PH1} and {PH2}',
-};
-
-message = i18nString(UIStrings.addAnotherString, {PH1: 'a placeholder', PH2: 'another placeholder'});
-```
-
-## i18nLazyString
-The `i18nString` function returns the translated string, with placeholders resolved. To do this, it needs access to the translated strings for the user's locale, which are not available until after DevTools has finished starting up.
-
-Calls to `i18nString` in the module scope will therefore fail when the module is imported.
-```javascript
-// Fails because i18nString runs at module-import time.
-Common.Settings.registerSettingExtension({
-  category: Common.Settings.SettingCategory.CONSOLE,
-  title: i18nString(UIStrings.groupSimilarMessagesInConsole),
-...
-
-function notTopLevel() {
-  console.log(extension.title);
-}
-```
-
-`i18nLazyString` fixes this problem by providing the same API, but returning a closure that returns a `LocalizedString`.
-It can be used in top-level calls; just make sure use-sites know it's a function now.
-
-```javascript
-// Works because i18nLazyString defers the loading of the translated string until later.
-Common.Settings.registerSettingExtension({
-  category: Common.Settings.SettingCategory.CONSOLE,
-  title: i18nLazyString(UIStrings.groupSimilarMessagesInConsole),
-...
-
-// Note we need to call title() now.
-function notTopLevel() {
-  console.log(extension.title());
-}
-```
-
-## i18n.i18n.getFormatLocalizedString
-This call returns a **span element**, not a string. It is used when you want to construct a DOM element with a localizable string, or localizable content that contains some other DOM element.
-
-```javascript
-// Create the string in UIString
-/**
-*@description Message in Coverage View of the Coverage tab
-*@example {reload button icon} PH1
-*@example {record button icon} PH2
-*/
-clickTheRecordButtonSToStart: 'Click the reload button {PH1} to reload or record button {PH2} start capturing coverage.',
-
-// Element with localizable content containing two DOM elements that are buttons
-const reloadButton = UI.createInlineButton(UI.Toolbar.createActionButtonForId('coverage.start-with-reload'));
-const recordButton = UI.createInlineButton(UI.Toolbar.createActionButton(this._toggleRecordAction));
-message = i18n.i18n.getFormatLocalizedString(str_, UIStrings.clickTheReloadButtonSToReloadAnd, {PH1: reloadButton, PH2:recordButton });
-```
-
-## i18n.i18n.lockedString
-This call is a named cast. Use it in places where a localized string is expected but the
-term you want to use does not require translation. Instead of locking the whole phrase or using
-a placeholder-only phrase, use `lockedString`.
-
-```javascript
-someFunctionRequiringALocalizedString(i18n.i18n.lockedString('HTTP'));
-```

package/docs/localization/locked_terms.md

@@ -1,38 +0,0 @@
-## How to prevent a term being localized?
-
-Any text within the backticks will not be translated.
-For example, if the 'robots.txt' in string 'Requesting for robots.txt ...' should not be translated:
-
-```javascript
-// in example.js file
-
-import * as i18n from '../i18n/i18n.js';
-const UIStrings = {
-  /**
-   * @description Example description. Note: "robots.txt" is a canonical filename and should not be translated.
-   */
-  requestMessage: 'Requesting for `robots.txt` ...',
-};
-const str_ = i18n.i18n.registerUIStrings('example.js', UIStrings);
-
-const message = i18nString(UIStrings.requestMessage);
-```
-The string will rendered with robots.txt not translated and without the backticks around it
-```javascript
-  'Requesting for robots.txt ...'
-```
-
-### Phrases that are fully locked
-Any text that is fully locked should not go into the UIStrings object. To make your intention clear
-or to make TypeScript happy, there are two methods `i18n.i18n.lockedString` and `i18n.i18n.lockedLazyString`
-that can be used instead of having fully locked phrases via `i18nString`.
-
-## What should not be localized?
-In general, branding related terms and code snippets are the ones to look for, and Sometimes some technical terms. Some examples:
-
-**Brandings:**
-Lighthouse, GitHub, DevTools, Chrome Data Saver, Safari, BlackBerry Z30, Kindle Fire HDX, Pixel 2, Microsoft Lumia 550
-**Code snippets:**
-localhost:9229, console.clear(), --memlog=all, url:a.com
-**Technical terms:**
-DOM, DIV, aria...

package/docs/testing_guidelines.md

@@ -1,4 +0,0 @@
-# Chrome DevTools Testing Guidelines
-
-- [E2E test guide](../test/e2e/README.md)
-- [Web tests in the DevTools repo guide](../test/webtests/README)

package/docs/triage_guidelines.md

@@ -1,3 +0,0 @@
-# Triage Guidelines
-
-Moved to [go/chrome-devtools/triage-sheriff](http://go/chrome-devtools/triage-sheriff).

package/front_end/entrypoints/formatter_worker/HTMLOutline.ts

@@ -1,53 +0,0 @@
-// 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.
-
-import * as Platform from '../../core/platform/platform.js';
-import * as TextUtils from '../../models/text_utils/text_utils.js';
-
-import {javaScriptOutline} from './JavaScriptOutline.js';
-export interface Item {
-  title: string;
-  subtitle?: string;
-  line: number;
-  column: number;
-}
-
-export function htmlOutline(content: string, chunkCallback: (arg0: {
-                                               chunk: Array<Item>,
-                                               isLastChunk: boolean,
-                                             }) => void): void {
-  const SCRIPT_OPENING_TAG = /<script[^>]*>/im;
-  const SCRIPT_CLOSING_TAG = /<\/script\s*>/im;
-
-  const textCursor = new TextUtils.TextCursor.TextCursor(Platform.StringUtilities.findLineEndingIndexes(content));
-  while (true) {
-    // Look for the opening <script> tag.
-    const openingMatch = SCRIPT_OPENING_TAG.exec(content.substring(textCursor.offset()));
-    if (!openingMatch) {
-      break;
-    }
-    const scriptStart = textCursor.offset() + openingMatch.index + openingMatch[0].length;
-    textCursor.advance(scriptStart);
-    const scriptLine = textCursor.lineNumber();
-    const scriptColumn = textCursor.columnNumber();
-    // Look for the closing </script> tag.
-    const closingMatch = SCRIPT_CLOSING_TAG.exec(content.substring(textCursor.offset()));
-    if (!closingMatch) {
-      break;
-    }
-    const scriptEnd = textCursor.offset() + closingMatch.index;
-    textCursor.advance(scriptEnd + closingMatch[0].length);
-    const scriptContent = content.substring(scriptStart, scriptEnd);
-    javaScriptOutline(scriptContent, ({chunk}) => {
-      chunk.forEach(item => {
-        if (item.line === 0) {
-          item.column += scriptColumn;
-        }
-        item.line += scriptLine;
-      });
-      chunkCallback({chunk, isLastChunk: false});
-    });
-  }
-  chunkCallback({chunk: [], isLastChunk: true});
-}

package/front_end/entrypoints/formatter_worker/JavaScriptOutline.ts

@@ -1,153 +0,0 @@
-// Copyright 2016 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 Platform from '../../core/platform/platform.js';
-import * as TextUtils from '../../models/text_utils/text_utils.js';
-import * as AcornLoose from '../../third_party/acorn-loose/acorn-loose.js';
-import * as Acorn from '../../third_party/acorn/acorn.js';
-
-import {ECMA_VERSION} from './AcornTokenizer.js';
-import {ESTreeWalker} from './ESTreeWalker.js';
-import {type ChunkCallback} from './FormatterWorker.js';
-
-export interface Item {
-  title: string;
-  subtitle?: string;
-  line: number;
-  column: number;
-}
-
-export function javaScriptOutline(content: string, chunkCallback: ChunkCallback): void {
-  const chunkSize = 100000;
-  let chunk: Item[] = [];
-  let lastReportedOffset = 0;
-
-  let ast;
-  try {
-    ast = Acorn.parse(content, {ecmaVersion: ECMA_VERSION, ranges: false});
-  } catch (e) {
-    ast = AcornLoose.AcornLoose.parse(content, {ecmaVersion: ECMA_VERSION, ranges: false});
-  }
-
-  const contentLineEndings = Platform.StringUtilities.findLineEndingIndexes(content);
-  const textCursor = new TextUtils.TextCursor.TextCursor(contentLineEndings);
-  const walker = new ESTreeWalker(beforeVisit);
-
-  // @ts-ignore Technically, the acorn Node type is a subclass of Acorn.ESTree.Node.
-  // However, the acorn package currently exports its type without specifying
-  // this relationship. So while this is allowed on runtime, we can't properly
-  // typecheck it.
-  walker.walk(ast);
-
-  chunkCallback({chunk, isLastChunk: true});
-
-  function beforeVisit(node: Acorn.ESTree.Node): undefined {
-    if (node.type === 'ClassDeclaration') {
-      reportClass((node.id as Acorn.ESTree.Node));
-    } else if (node.type === 'VariableDeclarator' && node.init && isClassNode(node.init)) {
-      reportClass((node.id as Acorn.ESTree.Node));
-    } else if (node.type === 'AssignmentExpression' && isNameNode(node.left) && isClassNode(node.right)) {
-      reportClass((node.left as Acorn.ESTree.Node));
-    } else if (node.type === 'Property' && isNameNode(node.key) && isClassNode(node.value)) {
-      reportClass((node.key as Acorn.ESTree.Node));
-    } else if (node.type === 'FunctionDeclaration') {
-      reportFunction((node.id as Acorn.ESTree.Node), node);
-    } else if (node.type === 'VariableDeclarator' && node.init && isFunctionNode(node.init)) {
-      reportFunction((node.id as Acorn.ESTree.Node), (node.init as Acorn.ESTree.Node));
-    } else if (node.type === 'AssignmentExpression' && isNameNode(node.left) && isFunctionNode(node.right)) {
-      reportFunction((node.left as Acorn.ESTree.Node), (node.right as Acorn.ESTree.Node));
-    } else if (
-        (node.type === 'MethodDefinition' || node.type === 'Property') && isNameNode(node.key) &&
-        isFunctionNode(node.value)) {
-      const namePrefix = [];
-      if (node.kind === 'get' || node.kind === 'set') {
-        namePrefix.push(node.kind);
-      }
-      if ('static' in node && node.static) {
-        namePrefix.push('static');
-      }
-      reportFunction((node.key as Acorn.ESTree.Node), node.value, namePrefix.join(' '));
-    }
-
-    return undefined;
-  }
-
-  function reportClass(nameNode: Acorn.ESTree.Node): void {
-    const name = 'class ' + stringifyNameNode(nameNode);
-    textCursor.advance(nameNode.start);
-    addOutlineItem(name);
-  }
-
-  function reportFunction(nameNode: Acorn.ESTree.Node, functionNode: Acorn.ESTree.Node, namePrefix?: string): void {
-    let name = stringifyNameNode(nameNode);
-    const functionDeclarationNode = (functionNode as Acorn.ESTree.FunctionDeclaration);
-    if (functionDeclarationNode.generator) {
-      name = '*' + name;
-    }
-    if (namePrefix) {
-      name = namePrefix + ' ' + name;
-    }
-    if (functionDeclarationNode.async) {
-      name = 'async ' + name;
-    }
-
-    textCursor.advance(nameNode.start);
-    addOutlineItem(name, stringifyArguments((functionDeclarationNode.params as Acorn.ESTree.Node[])));
-  }
-
-  function isNameNode(node: Acorn.ESTree.Node): boolean {
-    if (!node) {
-      return false;
-    }
-    if (node.type === 'MemberExpression') {
-      return !node.computed && node.property.type === 'Identifier';
-    }
-    return node.type === 'Identifier';
-  }
-
-  function isFunctionNode(node: Acorn.ESTree.Node): boolean {
-    if (!node) {
-      return false;
-    }
-    return node.type === 'FunctionExpression' || node.type === 'ArrowFunctionExpression';
-  }
-
-  function isClassNode(node: Acorn.ESTree.Node): boolean {
-    return node !== undefined && node.type === 'ClassExpression';
-  }
-
-  function stringifyNameNode(node: Acorn.ESTree.Node): string {
-    if (node.type === 'MemberExpression') {
-      node = (node.property as Acorn.ESTree.Node);
-    }
-    console.assert(node.type === 'Identifier', 'Cannot extract identifier from unknown type: ' + node.type);
-    const identifier = (node as Acorn.ESTree.Identifier);
-    return identifier.name;
-  }
-
-  function stringifyArguments(params: Acorn.ESTree.Node[]): string {
-    const result = [];
-    for (const param of params) {
-      if (param.type === 'Identifier') {
-        result.push(param.name);
-      } else if (param.type === 'RestElement' && param.argument.type === 'Identifier') {
-        result.push('...' + param.argument.name);
-      } else {
-        console.error('Error: unexpected function parameter type: ' + param.type);
-      }
-    }
-    return '(' + result.join(', ') + ')';
-  }
-
-  function addOutlineItem(title: string, subtitle?: string): void {
-    const line = textCursor.lineNumber();
-    const column = textCursor.columnNumber();
-    chunk.push({title, subtitle, line, column});
-    if (textCursor.offset() - lastReportedOffset >= chunkSize) {
-      chunkCallback({chunk, isLastChunk: false});
-      chunk = [];
-      lastReportedOffset = textCursor.offset();
-    }
-  }
-}

package/front_end/legacy_test_runner/lighthouse_test_runner/lighthouse_test_runner.js

@@ -1,155 +0,0 @@
-// Copyright 2017 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 '../test_runner/test_runner.js';
-import '../../panels/lighthouse/lighthouse-legacy.js';
-
-/**
- * @fileoverview using private properties isn't a Closure violation in tests.
- */
-self.LighthouseTestRunner = self.LighthouseTestRunner || {};
-
-/**
- * @return {!Lighthouse.LighthousePanel}
- */
-LighthouseTestRunner._panel = function() {
-  return /** @type {!Object} **/ (UI.panels).lighthouse;
-};
-
-/**
- * @return {?Element}
- */
-LighthouseTestRunner.getContainerElement = function() {
-  return LighthouseTestRunner._panel().contentElement;
-};
-
-/**
- * @return {?Element}
- */
-LighthouseTestRunner.getResultsElement = function() {
-  return LighthouseTestRunner._panel().auditResultsElement;
-};
-
-/**
- * @return {?Element}
- */
-LighthouseTestRunner.getDialogElement = function() {
-  return LighthouseTestRunner._panel().statusView._dialog.contentElement.shadowRoot.querySelector('.lighthouse-view');
-};
-
-/**
- * @return {?Element}
- */
-LighthouseTestRunner.getSettingsElement = function() {
-  return LighthouseTestRunner._panel().settingsPane.element;
-};
-
-/**
- * @return {?Element}
- */
-LighthouseTestRunner.getRunButton = function() {
-  const dialog = LighthouseTestRunner.getContainerElement();
-  return dialog && dialog.querySelectorAll('button')[0];
-};
-
-/**
- * @return {?Element}
- */
-LighthouseTestRunner.getCancelButton = function() {
-  const dialog = LighthouseTestRunner.getDialogElement();
-  return dialog && dialog.querySelectorAll('button')[0];
-};
-
-LighthouseTestRunner.openStartAudit = function() {
-  LighthouseTestRunner._panel().renderStartView();
-};
-
-/**
- * @param {function(string)} onMessage
- */
-LighthouseTestRunner.addStatusListener = function(onMessage) {
-  TestRunner.addSniffer(Lighthouse.StatusView.prototype, 'updateStatus', onMessage, true);
-};
-
-/**
- * @return {!Promise<!Object>}
- */
-LighthouseTestRunner.waitForResults = function() {
-  return new Promise(resolve => {
-    TestRunner.addSniffer(
-        Lighthouse.LighthousePanel.prototype, 'buildReportUI', (lhr, artifacts) => resolve({lhr, artifacts}));
-  });
-};
-
-LighthouseTestRunner.forcePageAuditabilityCheck = function() {
-  LighthouseTestRunner._panel().controller.recomputePageAuditability();
-};
-
-/**
- * @param {?Element} checkboxContainer
- * @return {string}
- */
-LighthouseTestRunner._checkboxStateLabel = function(checkboxContainer) {
-  if (!checkboxContainer) {
-    return 'missing';
-  }
-
-  const label = checkboxContainer.textElement.textContent;
-  const checkedLabel = checkboxContainer.checkboxElement.checked ? 'x' : ' ';
-  return `[${checkedLabel}] ${label}`;
-};
-
-/**
- * @param {?Element} combobox
- * @return {string}
- */
-LighthouseTestRunner._comboboxStateLabel = function(combobox) {
-  if (!combobox) {
-    return 'missing';
-  }
-
-  return `${combobox.ariaLabel}: ${combobox.value}`;
-};
-
-/**
- * @param {?Element} button
- * @return {string}
- */
-LighthouseTestRunner._buttonStateLabel = function(button) {
-  if (!button) {
-    return 'missing';
-  }
-
-  const enabledLabel = button.disabled ? 'disabled' : 'enabled';
-  const hiddenLabel = window.getComputedStyle(button).getPropertyValue('visibility');
-  return `${button.textContent}: ${enabledLabel} ${hiddenLabel}`;
-};
-
-LighthouseTestRunner.dumpStartAuditState = function() {
-  TestRunner.addResult('\n========== Lighthouse Start Audit State ==========');
-
-  const containerElement = LighthouseTestRunner.getContainerElement();
-  const checkboxes = [...containerElement.querySelectorAll('.checkbox')];
-
-  const toolbarShadowRoot =
-      LighthouseTestRunner.getSettingsElement().querySelector('.lighthouse-settings-pane > div').shadowRoot;
-  for (const checkbox of toolbarShadowRoot.querySelectorAll('.checkbox')) {
-    checkboxes.push(checkbox);
-  }
-
-  checkboxes.forEach(element => {
-    TestRunner.addResult(LighthouseTestRunner._checkboxStateLabel(element));
-  });
-
-  for (const combobox of toolbarShadowRoot.querySelectorAll('select')) {
-    TestRunner.addResult(LighthouseTestRunner._comboboxStateLabel(combobox));
-  }
-
-  const helpText = containerElement.querySelector('.lighthouse-help-text');
-  if (!helpText.classList.contains('hidden')) {
-    TestRunner.addResult(`Help text: ${helpText.textContent}`);
-  }
-
-  TestRunner.addResult(LighthouseTestRunner._buttonStateLabel(LighthouseTestRunner.getRunButton()));
-};