Skip to content
A component to help benchmark React components and their trees.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Tweak docs, contributing guide Nov 12, 2017
examples Add UI example Oct 11, 2017
scripts update for react 16 Sep 30, 2017
.babelrc Add syntax-dynamic-import plugin Sep 30, 2017
.eslintignore Initial commit Sep 22, 2017
.eslintrc Ensure we return a high-resolution time in MS if possible Sep 26, 2017
.flowconfig Fix flow, add lint Sep 23, 2017
.gitignore Initial commit Sep 22, 2017
LICENSE Initial commit Sep 22, 2017 Tweak docs, contributing guide Nov 12, 2017
package.json Tweak docs, contributing guide Nov 12, 2017
yarn.lock update for react 16 Sep 30, 2017

React Component Benchmark Build Status

This project aims to provide a method for gathering benchmarks of component tree mount, update, and unmount timings.

Please note that the values returned are estimates. Since this project does not hook into the React renderer directly, the values gathered are not 100% accurate and may vary slightly because they're taken from a wrapping component. That being said, running a large sample set should give you a confident benchmark metric.


Historically, React has provided react-addons-perf in order to help gain insight into the performance of mounting, updating, and unmounting components. Unfortunately, as of React 16, it has been deprecated. Additionally, before deprecation, it was not usable in production React builds, making it less useful for many applications.


See the examples directory for ideas on how you might integrate this into your own project, whether in your user-interface or your automated tests.

Quick Start

import Benchmark, { BenchmarkType } from 'react-component-benchmark';

class MyComponentBenchmark extends React.Component {
  render() {
    return (
        <button onClick={this._start}>Run</button>

  _start = () => { this._benchmark.start(); };

  _handleComplete = (results) => {

  _setBenchRef = (ref) => { this._benchmark = ref; };

Benchmark props

  • component: typeof React.Component
  • componentProps: object Properties to be given to component when rendering
  • onComplete: (x: BenchResultsType) => void
  • samples: number Samples to run (default 50)
  • timeout: number Amount of time in milliseconds to stop running (default 10000)
  • type: string One of 'mount', 'update', or 'unmount'. Also available from BenchmarkType.

In tests

See examples/tests for various test integrations.


Note: All times and timestamps are in milliseconds. High resolution times provided when available.

  • startTime: number Timestamp of when the run started
  • endTime: number Timestamp of when the run completed
  • runTime: number Amount of time that it took to run all samples.
  • sampleCount: number The number of samples actually run. May be less than requested if the timeout was hit.
  • samples: Array<{ start, end, elapsed }>
  • max: number Maximum time elapsed
  • min: number Minimum time elapsed
  • median: number Median time elapsed
  • mean: number Mean time elapsed
  • stdDev: number Standard deviation of all elapsed times
  • p70: number 70th percentile for time elapsed: mean + stdDev
  • p95: number 95th percentile for time elapsed: mean + (stdDev * 2)
  • p99: number 99th percentile for time elapsed: mean + (stdDev * 3)
You can’t perform that action at this time.