@firefox-devtools/profiler-cli 0.1.0-alpha.0 → 0.1.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -3
- package/dist/profiler-cli.js +122 -97
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Profiler CLI
|
|
1
|
+
# Firefox Profiler CLI
|
|
2
2
|
|
|
3
3
|
A command-line interface for querying Firefox Profiler profiles with persistent daemon sessions.
|
|
4
4
|
|
|
@@ -25,7 +25,7 @@ profiler-cli stop # Stop the daemon
|
|
|
25
25
|
|
|
26
26
|
`profiler-cli` is also available as `pq` for shorter invocations (e.g. `pq thread samples`).
|
|
27
27
|
|
|
28
|
-
Run `profiler-cli guide` for a detailed usage guide with patterns and tips.
|
|
28
|
+
Run `profiler-cli guide` for a detailed usage guide with patterns and tips.
|
|
29
29
|
Run `profiler-cli --help` for the full options reference.
|
|
30
30
|
|
|
31
31
|
## Commands
|
|
@@ -39,8 +39,9 @@ profiler-cli thread select <handle> # Select a thread (e.g., t-0, t-1)
|
|
|
39
39
|
profiler-cli thread samples # Show hot functions list for current thread
|
|
40
40
|
profiler-cli thread samples-top-down # Show top-down call tree (where CPU time is spent)
|
|
41
41
|
profiler-cli thread samples-bottom-up # Show bottom-up call tree (what calls hot functions)
|
|
42
|
-
profiler-cli thread markers # List markers with aggregated statistics
|
|
42
|
+
profiler-cli thread markers # List markers with aggregated statistics [--list for flat per-marker view]
|
|
43
43
|
profiler-cli thread functions # List all functions with CPU percentages
|
|
44
|
+
profiler-cli thread page-load # Show page load summary (navigation timing, resources, CPU, jank)
|
|
44
45
|
profiler-cli marker info <handle> # Show detailed marker information (e.g., m-1234)
|
|
45
46
|
profiler-cli marker stack <handle> # Show full stack trace for a marker
|
|
46
47
|
profiler-cli function expand <handle> # Show full untruncated function name (e.g., f-123)
|
|
@@ -87,6 +88,9 @@ profiler-cli thread info --thread t-0 # View info for specific thread witho
|
|
|
87
88
|
| `--limit <N>` | Limit number of results shown |
|
|
88
89
|
| `--max-lines <N>` | Limit call tree nodes for `samples-top-down`/`samples-bottom-up` (default: 100) |
|
|
89
90
|
| `--scoring <strategy>` | Call tree scoring: `exponential-0.95`, `exponential-0.9` (default), `exponential-0.8`, `harmonic-0.1`, `harmonic-0.5`, `harmonic-1.0`, `percentage-only` |
|
|
91
|
+
| `--navigation <N>` | Select which navigation to show in `thread page-load` (1-based, default: last completed) |
|
|
92
|
+
| `--jank-limit <N>` | Max jank periods to show in `thread page-load` (default: 10, 0 = show all) |
|
|
93
|
+
| `--list` | Show a flat chronological list of individual markers (for `thread markers`) |
|
|
90
94
|
| `--all` | Show all threads in `profile info` (overrides default top-5 limit) |
|
|
91
95
|
| `--session <id>` | Use a specific session instead of the current one |
|
|
92
96
|
|