[ Documentation ]
rnx perf

rnx perf

rnx perf

One profiling group for sampled JS CPU profiles, React render-cost tables, shell and compositor frame timing, and timestamp-aligned scroll offsets from the tenant, shell, and compositor workers.

terminal
rnx perf cpu [options]
rnx perf react <profile|summary|slow|rerenders|tree|why> [options]
rnx perf shell <start|stop|transition> [options]
rnx perf scroll <start|stop> [options]

Options

flagdescription
--cdp-port <port>for perf cpu: Chrome DevTools port (default: $RNX_CDP_PORT or 9222)
--duration <seconds>for perf cpu: recording duration (default: 5)
--match <substring>for perf cpu: pick the page target by URL substring
--output <path>for perf cpu: output .cpuprofile path
--include-propsfor perf react profile start: record shallow prop previews
--limit <n>for perf react: rows; for perf scroll: samples per layer
--jsonstructured output where supported
--sim <sim>target a specific connected sim

Examples

terminal
rnx open 8089 --new --driver playwright --cdp-port 9222
rnx perf cpu --cdp-port 9222 --duration 5
rnx perf react profile start
rnx perf react summary --limit 10
rnx perf shell start
rnx perf shell stop --json
rnx perf scroll start
rnx perf scroll stop --json

Profiling Surfaces

perf cpu captures sampled JavaScript CPU profiles through CDP. Open the sim with a CDP port first:

terminal
rnx open 8081 --new --driver playwright --cdp-port 9222
rnx perf cpu --cdp-port 9222 --duration 5

perf react reads React render cost from the tenant worker. perf shell records shell and compositor frame timing. perf scroll records timestamp-aligned per-frame offsets from the tenant, shell, and compositor workers while it is armed; use --json on stop for the complete series.