chrome-devtools-frontend 1.0.1672557 → 1.0.1675430

package/front_end/panels/profiler/HeapProfileView.ts

@@ -35,40 +35,40 @@ const {widget, widgetRef} = UI.Widget;
 
 const UIStrings = {
   /**
-   * @description The reported total size used in the selected time frame of the allocation sampling profile
+   * @description The reported total size used in the selected time frame of the allocation sampling profile.
    * @example {3 MB} PH1
    */
   selectedSizeS: 'Selected size: {PH1}',
   /**
-   * @description Name of column header that reports the size (in terms of bytes) used for a particular part of the heap, excluding the size of the children nodes of this part of the heap
+   * @description Column header that reports the size (in bytes) used for a particular part of the heap, excluding the size of child nodes.
    */
   selfSizeBytes: 'Self size',
   /**
-   * @description Name of column header that reports the total size (in terms of bytes) used for a particular part of the heap
+   * @description Column header that reports the total size (in bytes) used for a particular part of the heap.
    */
   totalSizeBytes: 'Total size',
   /**
-   * @description Button text to stop profiling the heap
+   * @description Button text to stop profiling the heap.
    */
   stopHeapProfiling: 'Stop heap profiling',
   /**
-   * @description Button text to start profiling the heap
+   * @description Button text to start profiling the heap.
    */
   startHeapProfiling: 'Start heap profiling',
   /**
-   * @description Progress update that the profiler is recording the contents of the heap
+   * @description Progress update that the profiler is recording the contents of the heap.
    */
   recording: 'Recording…',
   /**
-   * @description Icon title in Heap Profile View of a profiler tool
+   * @description Tooltip and status text for the recording icon when the heap profiler is actively recording.
    */
   heapProfilerIsRecording: 'Heap profiler is recording',
   /**
-   * @description Progress update that the profiler is in the process of stopping its recording of the heap
+   * @description Progress update that the profiler is in the process of stopping its recording of the heap.
    */
   stopping: 'Stopping…',
   /**
-   * @description Sampling category to only profile allocations happening on the heap
+   * @description Sampling category to only profile allocations happening on the heap.
    */
   allocationSampling: 'Allocation sampling',
   /**
@@ -76,95 +76,95 @@ const UIStrings = {
    */
   samplingProfiles: 'Sampling profiles',
   /**
-   * @description Description in Heap Profile View of a profiler tool
+   * @description Description for the allocation sampling profiling option in the Memory panel.
    */
   recordMemoryAllocations:
       'Approximate memory allocations by sampling long operations with minimal overhead and get a breakdown by JavaScript execution stack',
   /**
-   * @description Name of a profile
+   * @description Name of a profile.
    * @example {2} PH1
    */
   profileD: 'Profile {PH1}',
   /**
-   * @description Accessible text for the value in bytes in memory allocation or coverage view.
+   * @description Accessible text for the value in bytes in the allocation view or coverage view.
    * @example {12345} PH1
    */
   sBytes: '{PH1} bytes',
   /**
-   * @description Text in CPUProfile View of a profiler tool
+   * @description Formatting template for displaying a percentage value in heap and CPU profile views.
    * @example {21.33} PH1
    */
   formatPercent: '{PH1} %',
   /**
-   * @description The formatted size in kilobytes, abbreviated to kB
+   * @description The formatted size in kilobytes, abbreviated to kB.
    * @example {1,021} PH1
    */
   skb: '{PH1} kB',
   /**
-   * @description Text for the name of something
+   * @description Text for the name of something.
    */
   name: 'Name',
   /**
-   * @description Tooltip of a cell that reports the size used for a particular part of the heap, excluding the size of the children nodes of this part of the heap
+   * @description Tooltip for a cell reporting the size used for a particular part of the heap, excluding the size of child nodes.
    */
   selfSize: 'Self size',
   /**
-   * @description Tooltip of a cell that reports the total size used for a particular part of the heap
+   * @description Tooltip for a cell reporting the total size used for a particular part of the heap.
    */
   totalSize: 'Total size',
   /**
-   * @description Text for web URLs
+   * @description Text for web URLs.
    */
   url: 'URL',
   /**
-   * @description Label for a checkbox in the memory panel to enable sampling heap profiler timeline.
+   * @description Label for a checkbox in the Memory panel to enable sampling heap profiler timeline.
    */
   samplingHeapProfilerTimeline: 'Sampling heap profiler timeline',
   /**
-   * @description Text in Profile View of a profiler tool
+   * @description Tab title for an individual heap profile view in the Memory panel.
    */
   profile: 'Profile',
   /**
    * @description Placeholder text in the search box of the JavaScript profiler tool. Users can search
-   *the results by the cost in milliseconds, the name of the function, or the file name.
+   * the results by the cost in milliseconds, the name of the function, or the file name.
    */
   findByCostMsNameOrFile: 'Find by cost (>50ms), name or file',
   /**
-   * @description Text for a programming function
+   * @description Text for a programming function.
    */
   function: 'Function',
   /**
-   * @description Title of the Profiler tool
+   * @description Title of the Profiler tool.
    */
   profiler: 'Profiler',
   /**
-   * @description Aria-label for profiles view combobox in memory tool
+   * @description Aria-label for profiles view combobox in Memory panel.
    */
   profileViewMode: 'Profile view mode',
   /**
-   * @description Tooltip text that appears when hovering over the largeicon visibility button in the Profile View of a profiler tool
+   * @description Tooltip text that appears when hovering over the focus button in the heap profile view toolbar.
    */
   focusSelectedFunction: 'Focus selected function',
   /**
-   * @description Tooltip text that appears when hovering over the largeicon delete button in the Profile View of a profiler tool
+   * @description Tooltip text that appears when hovering over the exclude button in the heap profile view toolbar.
    */
   excludeSelectedFunction: 'Exclude selected function',
   /**
-   * @description Tooltip text that appears when hovering over the largeicon refresh button in the Profile View of a profiler tool
+   * @description Tooltip text that appears when hovering over the restore button in the heap profile view toolbar.
    */
   restoreAllFunctions: 'Restore all functions',
   /**
-   * @description Text in Profile View of a profiler tool
+   * @description Option in the view mode dropdown to display the heap profile as a flame chart.
    */
   chart: 'Chart',
   /**
-   * @description Text in Profile View of a profiler tool
+   * @description Option in the view mode dropdown to display the heap profile as a bottom-up call tree.
    */
-  heavyBottomUp: 'Heavy (Bottom Up)',
+  heavyBottomUp: 'Heavy (bottom up)',
   /**
-   * @description Text for selecting different profile views in the JS profiler tool. This option is a tree view.
+   * @description Option in the view mode dropdown to display the heap profile as a top-down call tree.
    */
-  treeTopDown: 'Tree (Top Down)',
+  treeTopDown: 'Tree (top down)',
 
   /**
    * @description Tooltip to alert developers that some parts of code in execution were not optimized.

package/front_end/panels/profiler/HeapProfilerPanel.ts

@@ -11,9 +11,9 @@ import {ProfilesPanel} from './ProfilesPanel.js';
 
 const UIStrings = {
   /**
-   * @description A context menu item in the Heap Profiler Panel of a profiler tool
+   * @description Context menu item to reveal the selected object in the summary perspective.
    */
-  revealInSummaryView: 'Reveal in Summary view',
+  revealInSummaryView: 'Reveal in summary view',
 } as const;
 const str_ = i18n.i18n.registerUIStrings('panels/profiler/HeapProfilerPanel.ts', UIStrings);
 const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);

package/front_end/panels/profiler/HeapSnapshotDataGrids.ts

@@ -24,101 +24,97 @@ import type {DataDisplayDelegate} from './ProfileHeader.js';
 
 const UIStrings = {
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Tooltip for the distance column header in heap snapshot data grids.
    */
   distanceFromWindowObject: 'Distance from window object',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Tooltip for the shallow size column header in heap snapshot data grids.
    */
   sizeOfTheObjectItselfInBytes: 'Size of the object itself in bytes',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Tooltip for the retained size column header in heap snapshot data grids.
    */
   sizeOfTheObjectPlusTheGraphIt: 'Size of the object plus the graph it retains in bytes',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header displaying JavaScript object names in heap snapshot data grids.
    */
   object: 'Object',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header displaying distance from root window object in heap snapshot data grids.
    */
   distance: 'Distance',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool. Shallow size is the size of just this node, not including children/retained size.
+   * @description Column header displaying shallow size in heap snapshot data grids.
    */
-  shallowSize: 'Shallow Size',
+  shallowSize: 'Shallow size',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header displaying retained size in heap snapshot data grids.
    */
-  retainedSize: 'Retained Size',
+  retainedSize: 'Retained size',
   /**
-   * @description Title for a section in the Heap Snapshot view. This title is for a table which
+   * @description Title for a section in the heap snapshot view. This title is for a table which
    * shows retaining relationships between JavaScript objects. One object retains another if it holds
    * a reference to it, keeping it alive.
    */
-  heapSnapshotRetainment: 'Heap Snapshot Retainment',
+  heapSnapshotRetainment: 'Heap snapshot retainment',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header displaying JavaScript constructor names in heap snapshot data grids.
    */
   constructorString: 'Constructor',
   /**
-   * @description Data grid name for Heap Snapshot Constructors data grids
+   * @description Data grid name for heap snapshot constructors data grids.
    */
-  heapSnapshotConstructors: 'Heap Snapshot Constructors',
+  heapSnapshotConstructors: 'Heap snapshot constructors',
   /**
-   * @description Column header in a table displaying the diff between two Heap Snapshots. This
-   * column is number of new objects in snapshot #2 compared to snapshot #1.
+   * @description Column header in heap snapshot diff table displaying the number of new objects.
    */
   New: '# New',
   /**
-   * @description Column header in a table displaying the diff between two Heap Snapshots. This
-   * column is number of deleted objects in snapshot #2 compared to snapshot #1.
+   * @description Column header in heap snapshot diff table displaying the number of deleted objects.
    */
   Deleted: '# Deleted',
   /**
-   * @description Column header in a table displaying the diff between two Heap Snapshots. This
-   * column is the difference (delta) between the # New and # Deleted objects in the snapshot.
+   * @description Column header in heap snapshot diff table displaying net object count change.
    */
   Delta: '# Delta',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header in heap snapshot diff table displaying total allocated size.
    */
-  allocSize: 'Alloc. Size',
+  allocSize: 'Alloc. size',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header in heap snapshot diff table displaying total freed size.
    */
-  freedSize: 'Freed Size',
+  freedSize: 'Freed size',
   /**
-   * @description Title of a column in a table in the Heap Snapshot tool. 'Delta' here means
-   * difference, so the whole string means 'difference in size'.
+   * @description Column header in heap snapshot diff table displaying difference in size between snapshots. 'Delta' means difference.
    */
-  sizeDelta: 'Size Delta',
+  sizeDelta: 'Size delta',
   /**
-   * @description Data grid name for Heap Snapshot Diff data grids
+   * @description Data grid name for heap snapshot diff data grids.
    */
-  heapSnapshotDiff: 'Heap Snapshot Diff',
+  heapSnapshotDiff: 'Heap snapshot diff',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header in allocation data grid displaying the number of live objects.
    */
-  liveCount: 'Live Count',
+  liveCount: 'Live count',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header in allocation data grid displaying total allocation count.
    */
   count: 'Count',
   /**
-   * @description Text in Heap Snapshot Data Grids of a profiler tool
+   * @description Column header in allocation data grid displaying total live size.
    */
-  liveSize: 'Live Size',
+  liveSize: 'Live size',
   /**
-   * @description Text for the size of something
+   * @description Text for the size of something.
    */
   size: 'Size',
   /**
-   * @description Text for a programming function
+   * @description Text for a programming function.
    */
   function: 'Function',
   /**
-   * @description Text in Heap Snapshot View of a profiler tool
+   * @description Data grid name for allocation view in heap snapshots.
    */
   allocation: 'Allocation',
 } as const;

package/front_end/panels/profiler/HeapSnapshotGridNodes.ts

@@ -28,102 +28,101 @@ import type {DataDisplayDelegate} from './ProfileHeader.js';
 
 const UIStrings = {
   /**
-   * @description Generic text with two placeholders separated by a comma
+   * @description Accessible name template combining a numeric value and its percentage (e.g. "1,613,680, 44%").
    * @example {1 613 680} PH1
    * @example {44 %} PH2
    */
   genericStringsTwoPlaceholders: '{PH1}, {PH2}',
   /**
-   * @description Text in Heap Snapshot Grid Nodes of a profiler tool
+   * @description Display text for internal array objects without a constructor name in heap snapshot trees.
    */
   internalArray: '(internal array)[]',
   /**
-   * @description Text in Heap Snapshot Grid Nodes of a profiler tool
+   * @description Tooltip for an icon indicating that an object is reachable from the global window object.
    */
   userObjectReachableFromWindow: 'User object reachable from window',
   /**
-   * @description Text in Heap Snapshot Grid Nodes of a profiler tool
+   * @description Tooltip for an icon indicating that a DOM node is detached from the DOM tree.
    */
   detachedFromDomTree: 'Detached from DOM tree',
   /**
-   * @description Text in Heap Snapshot Grid Nodes of a profiler tool
+   * @description Text displayed when a preview for a heap snapshot object cannot be retrieved.
    */
-  previewIsNotAvailable: 'Preview is not available',
+  previewIsNotAvailable: 'Preview isn’t available',
   /**
-   * @description A context menu item in the Heap Profiler Panel of a profiler tool
+   * @description Context menu item to reveal the selected object in the summary perspective.
    */
-  revealInSummaryView: 'Reveal in Summary view',
+  revealInSummaryView: 'Reveal in summary view',
   /**
-   * @description Text for the summary view
+   * @description Title of the perspective showing objects grouped by constructor.
    */
   summary: 'Summary',
   /**
-   * @description A context menu item in the Heap Profiler Panel of a profiler tool
+   * @description Context menu item to reveal a specific object by name and snapshot ID in the summary perspective.
    * @example {SomeClassConstructor} PH1
    * @example {12345} PH2
    */
-  revealObjectSWithIdSInSummary: 'Reveal object \'\'{PH1}\'\' with id @{PH2} in Summary view',
+  revealObjectSWithIdSInSummary: 'Reveal object \'\'{PH1}\'\' with id @{PH2} in summary view',
   /**
-   * @description Text to store an HTML element or JavaScript variable or expression result as a global variable
+   * @description Text to store an HTML element or JavaScript variable or expression result as a global variable.
    */
   storeAsGlobalVariable: 'Store as global variable',
   /**
-   * @description Text to ignore an object shown in the Retainers pane
+   * @description Context menu item to ignore a reference in the retainers view.
    */
   ignoreThisRetainer: 'Ignore this retainer',
   /**
-   * @description Text to undo the "Ignore this retainer" action
+   * @description Text to undo the "Ignore this retainer" action.
    */
   stopIgnoringThisRetainer: 'Stop ignoring this retainer',
   /**
-   * @description Text indicating that a node has been ignored with the "Ignore this retainer" action
+   * @description Text indicating that a node has been ignored with the "Ignore this retainer" action.
    */
   ignored: 'ignored',
   /**
-   * @description Text in Heap Snapshot Grid Nodes of a profiler tool that indicates an element contained in another
-   * element.
+   * @description Preposition used in object retaining paths to show containment relationships (e.g. "myProp in Object" or "HTMLDivElement in HTMLBodyElement").
    */
   inElement: 'in',
   /**
-   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#compiled-code
+   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#compiled-code.
    */
   compiledCodeSummary: 'Internal data which V8 uses to run functions defined by JavaScript or WebAssembly.',
   /**
-   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#concatenated-string
+   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#concatenated-string.
    */
   concatenatedStringSummary: 'A string which represents the contents of two other strings joined together.',
   /**
-   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#system-context
+   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#system-context.
    */
   contextSummary:
       'An internal object containing variables from a JavaScript scope which may be needed by a function created within that scope.',
   /**
-   * @description A short description of the data type internal type DescriptorArray, which is described more fully at https://v8.dev/blog/fast-properties
+   * @description A short description of the data type internal type DescriptorArray, which is described more fully at https://v8.dev/blog/fast-properties.
    */
   descriptorArraySummary: 'A list of the property names used by a JavaScript Object.',
   /**
-   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#array
+   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#array.
    */
   internalArraySummary: 'An internal array-like data structure (not a JavaScript Array).',
   /**
-   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#internal-node
+   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#internal-node.
    */
   internalNodeSummary: 'An object allocated by a component other than V8, such as C++ objects defined by Blink.',
   /**
-   * @description A short description of the data type "system / Map" described at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#object-shape
+   * @description A short description of the data type "system / Map" described at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#object-shape.
    */
   mapSummary: 'An internal object representing the shape of a JavaScript Object (not a JavaScript Map).',
   /**
-   * @description A short summary of the "(object elements)[]" described at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#array
+   * @description A short summary of the "(object elements)[]" described at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#array.
    */
   objectElementsSummary:
       'An internal object which stores the indexed properties in a JavaScript Object, such as the contents of an Array.',
   /**
-   * @description A short summary of the "(object properties)[]" described at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#array
+   * @description A short summary of the "(object properties)[]" described at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#array.
    */
   objectPropertiesSummary: 'An internal object which stores the named properties in a JavaScript Object.',
   /**
-   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#sliced-string
+   * @description A short summary of the text at https://developer.chrome.com/docs/devtools/memory-problems/heap-snapshots#sliced-string.
    */
   slicedStringSummary: 'A string which represents some of the characters from another string.',
 } as const;