Run the benchmark
Run the scroll and sort suites on your machine, read their output, and compare two builds.
When you change the grid or want numbers for your hardware, run the benchmark. You clone the gridcn repository, run Chromium tests that drive a 100,000-row grid, and read the logged output.
You need the repository with dependencies installed and Playwright Chromium. Install the browser with npx playwright install chromium. Benchmark results lists what each suite enforces.
Run the scroll suites
Run one browser suite at a time. Two runs at once share the machine, and their frame times mean nothing.
-
Run the blank-row, render-count, mounted-row, and keyboard checks:
npx vitest run --project=browser \ registry/default/blocks/data-grid/test/scroll-drag.browser.test.tsx -
Run the full-swap ratio, the long-task budget, and the jump sequence:
npx vitest run --project=browser --reporter=verbose \ registry/default/blocks/data-grid/test/perf.browser.test.tsx -
Read the result. Each file prints its own test count, and a pass has no failed test. A passing
perf.browser.test.tsxrun ends withTests 3 passed (3). It logsperf ratioandperf long-tasks. Thejump-sequenceline appears with--reporter=verbose. A warning on a passing run is not a failure.
A failure names the threshold that broke. If one file fails, run it once more before you debug. If the machine is busy, a timing test can fail by chance. A second failure is real.
Measure frames by hand
Use this script to compare two builds on the same machine.
-
Start the dev server:
pnpm dev -
In a second terminal, run the script against the benchmark page:
node scripts/perf-scroll.mjs --runs 5 \ --url http://localhost:3000/dev/bench -
Save the result with
--out before.json. Change the code. Run again with--baseline before.json.
With --runs, the script loads the page fresh for each run. It prints the median, the minimum, the maximum, and the spread of each metric. With --baseline, a change that is larger than both spreads counts as significant.
A production build returns 404 for the /dev routes unless GRIDCN_DEV_PAGES=1 is set.
Measure sort latency
With the dev server running, time a sort of 100,000 rows:
node scripts/perf-sort.mjs --runs 5The script clicks the Name header and measures the time until the first row shows the sorted order. Pass --column to sort another column.
Related
- Benchmark results: what each suite enforces
- Performance guidance: keep scrolling smooth
- Virtualization: what the grid mounts