FAQ.md

Frequently Asked Questions

• Usage
  • How do I create a data file?
  • What do the different folder and file colors mean?
  • What does "Type", "Count", "Total size", and "Percent" refer to?
  • Which keyboard shortcuts are supported?
• Symbols
  • What are "Other entries"?
  • What are "Other small" symbols for?
• Filters
  • What regular expressions syntax is supported?

Usage

How do I create a data file?

Use the Super Size program to generate data files. Data files are created from .size files, which are also created by Super Size and are used to archive details on Chrome's binary size.

Super Size is located in the //tools/binary_size directory in the chromium repository.

To generate a data file, use the html_report mode.

tools/binary_size/supersize html_report chrome.size --report-dir size-report
# Places the data file inside the ./size-report directory,
# generated based on ./chrome.size

What do the different folder and file colors mean?

Containers (folders, files, and components) have different colors depending on the symbols they contain. The color corresponds whatever symbol type has the most bytes in that container. The color is the same as that symbol type's icon.

When hovering over the container, you can see a breakdown of all the symbol types inside. The first row of that table indicates the symbol type with the most bytes.

What does "Type", "Count", "Total size", and "Percent" refer to?

When hovering over a container, a card appears breaking down the symbols stored within that container. The data appears as a pie chart and a table with the columns "Type", "Count", "Total size", and "Percent".

• Type refers to the symbol type that row represents.
• Count indicates the number of symbols of that type present in the container.
• Total size indicates how many bytes the symbols of that type take up in total.
• Percent indicates how much the total size of a symbol type takes up of the total size of the container. It also correlates to the pie chart sizes.

Which keyboard shortcuts are supported?

Once the symbol tree is focused on, various keyboard shortcuts are supported to navigate around the tree.

The symbol tree can be focused by clicking on it or by pressing Tab until the tree is focused.

Key	Function
Enter or Space	Open or close a container, just like clicking on it
↓	Focus the node below the current node
↑	Focus the node above the current node
→	Move focus to the first child node, or open the current node if closed
←	Move focus to the parent node, or close the current node if open
Home	Move focus to the topmost node
End	Move focus to the bottommost node
A-z	Focus the next node that starts with the given character
*	Expand all sibling containers of the current node.

Symbols

What are "Other entries"?

The symbol type "Other entries" refers to symbols that don't fall in one of the defined symbol categories. This includes images and .bin files.

What are "Other small" symbols for?

To reduce the size of the generated data file, small symbols are omitted by default. Small symbols of the same type are combined into an "Other small [type]" bucket.

More symbols can be displayed by setting the --min-symbol-size=<number> flag when generating the data file. However, the data file will be larger and will take longer to load.

Filters

What regular expressions syntax is supported?

The contain and exclude regular expressions are evaluated against the full path of each symbol. Symbol names are appended onto the end of a path and prefixed with a : (path/to/file:symbol). The full path is displayed below the byte size on the info card, and also appears when hovering over a symbol's name.

The "Symbols must contain" filter is applied before the "Symbols must exclude" filter.

Example filter	Regular expression
Find symbols in MyJavaClass	:MyJavaClass#
Find folders named myfolder	myfolder/