# The Cost of Javascript Frameworks

There is no faster (pun intended) way to slow down a site than to use a bunch of JavaScript.

The thing about JavaScript is you end up paying a performance tax no less than four times:

1. The cost of downloading the file on the network
2. The cost of parsing and compiling the uncompressed file once downloaded
3. The cost of executing the JavaScript
4. The memory cost

The combination is very expensive.

And we are shipping an increasingly high amount. We’re making the core functionality of our sites increasingly dependant on JavaScript as organizations move towards sites driven by frameworks like React, Vue.js, and friends.

I see a lot of very heavy sites using them, but then, my perspective is very biased as the companies that I work with work with me precisely because they are facing performance challenges. I was curious just how common the situation is and just how much of a penalty we’re paying when we make these frameworks the default starting point.

Thanks to HTTP Archive, we can figure that out.

## The data

In total, HTTP Archive tracks 4,308,655 desktop URLs, and 5,484,239 mobile URLs. Among the many data points HTTP Archive reports for those URLs is a list of the detected technologies for a given site. That means we can pick out the thousands of sites that use various frameworks and see how much code they’re shipping, and what that costs the CPU.

I ran all the queries against March of 2020, the most recent run at the time.

I decided to compare the aggregate HTTP Archive data for all sites recorded against sites with React, Vue.js, and Angular detected.

For fun, I also added jQuery—it’s still massively popular, and it also represents a bit of a different approach to building with JavaScript than the single-page application (SPA) approach provided by React, Vue.js and Angular.

URLs in HTTP Archive with specific frameworks detected
Framework | Mobile URLs | Desktop URLs
--- | --- | ---
jQuery | 4,615,474 | 3,714,643
React | 489,827 | 241,023
Vue.js | 85,649 | 43,691
Angular | 19,423 | 18,088

## Hopes and dreams

Before we dig in, here’s what I would hope.

In an ideal world, I believe a framework should go beyond developer experience value and provide concrete value for the people using our sites. Performance is just one part of that—accessibility and security both come to mind as well—but it’s an essential part.

So in an ideal world, a framework makes it easier to perform well by either providing a better starting point or providing constraints and characteristics that make it hard to build something that doesn’t perform well.

The best of frameworks would do both: provide a better starting point and help to restrict how out of hands things can get.

Looking at the median for our data isn’t going to tell us that, and in fact leaves a ton of information out. Instead, for each stat, I pulled the following percentiles: the 10th, 25th, 50th (the median), 75th, and 90th.

The 10th and 90th percentiles are particularly interesting to me. The 10th percentile represents the best of class (or at least, reasonably close to the best of class) for a given framework. In other words, only 10% of all sites using a given framework reach that mark or better. The 90th percentile, on the other hand, is the opposite of the spectrum—it shows us how bad things can get. The 90th percentile represents the long-tail—that last 10% of sites with the highest number of bytes or largest amount of main thread time.

## JavaScript Bytes

For the starting point, it makes sense to look at the amount of JavaScript passed over the network.

JavaScript Bytes Served to Mobile Devices, by Percentile
| 10th | 25th | 50th | 75th | 90th
--- | --- | --- | --- | --- | ---
All Sites | 93.4kb | 196.6kb | 413.5kb | 746.8kb | 1,201.6kb
Sites with jQuery | 110.3kb | 219.8kb | 430.4kb | 748.6kb | 1,162.3kb
Sites with Vue.js | 244.7kb | 409.3kb | 692.1kb | 1,065.5kb | 1,570.7kb
Sites with Angular | 445.1kb | 675.6kb | 1,066.4kb | 1,761.5kb | 2,893.2kb
Sites with React | 345.8kb | 441.6kb | 690.3kb | 1,238.5kb | 1,893.6kb

JavaScript Bytes Served to Desktop Devices, by Percentile
| 10th | 25th | 50th | 75th | 90th
--- | --- | --- | --- | --- | ---
All Sites | 105.5kb | 226.6kb | 450.4kb | 808.8kb | 1,267.3kb
Sites with jQuery | 121.7kb | 242.2kb | 458.3kb | 803.4kb | 1,235.3kb
Sites with Vue.js | 248.0kb | 420.1kb | 718.0kb | 1,122.5kb | 1,643.1kb
Sites with Angular | 468.8kb | 716.9kb | 1,144.2kb | 1,930.0kb | 3,283.1kb
Sites with React | 308.6kb | 469.0kb | 841.9kb | 1,472.2kb | 2,197.8kb

For the sheer payload size, the 10th percentile turns out pretty much as you would expect: if one of these frameworks are in use, there’s more JavaScript even in the most ideal of situations. That’s not surprising—you can’t add a JavaScript framework as a default starting point and expect to ship less JavaScript out of the box.

What is notable is that some frameworks correlate to better starting points than others. Sites with jQuery are the best of the bunch, starting with about 15% more JavaScript on desktop devices and about 18% more on mobile. (There’s admittedly a little bit of bias here. jQuery is found on a lot of sites, so naturally, it’s going to have a tighter relationship to the overall numbers than others. Still, that doesn’t change the way the raw numbers appear for each framework.)

While even a 15-18% increase is notable, comparing that to the opposite end of the spectrum makes the jQuery tax feel very low. Sites with Angular ship 344% more JavaScript on desktop at the 10th percentile, and 377% more on mobile. Sites with React, the next heaviest, ship 193% more JavaScript on desktop and 270% more on mobile devices.

I mentioned earlier that even if the starting point is a little off, I would hope that a framework could still provide value by limiting the upper bound in some way.

Interestingly, jQuery driven sites follow this pattern. While they’re a bit heftier (15-18%) at the 10th percentile, they’re slightly smaller than the aggregate at the 90th percentile—about 3% on both desktop and mobile. Neither of those numbers is super significant, but at least sites with jQuery don’t seem to have a dramatically worse long-tail in terms of JavaScript bytes shipped.

The same can’t be said of the other frameworks.

Just as with the 10th percentile, Angular and React driven sites tend to distance themselves from others at the 90th percentile, and not in a very flattering way.

At the 90th percentile, Angular sites ship 141% more bytes on mobile and 159% more bytes on desktop. Sites with React ship 73% more bytes on desktop and 58% more on mobile. With a 90th percentile weight of 2,197.8kb, React sites ship 322.9kb more bytes of JavaScript to mobile users than Vue.js, the next closest. The desktop gap between Angular and React and the rest of the crowd is even higher—React-driven sites ship 554.7kb more JavaScript than Vue.js-driven sites.

## JavaScript Main Thread Time

It’s clear from the data that sites with these frameworks in place tend to pay a large penalty in terms of bytes. But of course, that’s just one part of the equation.

Once that JavaScript arrives, it has to get to work. Any work that occurs on the main thread of the browser is particularly troubling. The main thread is responsible for handling user input, during style calculation, layout and painting. If we’re clogging it up with a lot of JavaScript work, the main thread has no chance to do those things in a timely manner, leading to lag and jank.

HTTP Archive records V8 main thread time, so we can query to see just how much time that main thread is working on all that JavaScript.

Scripting related CPU time (in milliseconds) for mobile devices, in percentiles
| 10th | 25th | 50th | 75th | 90th
--- | --- | --- | --- | --- | ---
All Sites | 356.4ms | 959.7ms | 2,372.1ms | 5,367.3ms | 10,485.8ms
Sites with jQuery | 575.3ms | 1,147.4ms | 2,555.9ms | 5,511.0ms | 10,349.4ms
Sites with Vue.js | 1,130.0ms | 2,087.9ms | 4,100.4ms | 7,676.1ms | 12,849.4ms
Sites with Angular | 1,471.3ms | 2,380.1ms | 4,118.6ms | 7,450.8ms | 13,296.4ms
Sites with React | 2,700.1ms | 5,090.3ms | 9,287.6ms | 14,509.6ms | 20,813.3ms

Scripting related CPU time (in milliseconds) for desktop devices, in percentiles
| 10th | 25th | 50th | 75th | 90th
--- | --- | --- | --- | --- | ---
All Sites | 146.0ms | 351.8ms | 831.0ms | 1,739.8ms | 3,236.8ms
Sites with jQuery | 199.6ms | 399.2ms | 877.5ms | 1,779.9ms | 3,215.5ms
Sites with Vue.js | 350.4ms | 650.8ms | 1,280.7ms | 2,388.5ms | 4,010.8ms
Sites with Angular | 482.2ms | 777.9ms | 1,365.5ms | 2,400.6ms | 4,171.8ms
Sites with React | 508.0ms | 1,045.6ms | 2,121.1ms | 4,235.1ms | 7,444.3ms

There are some very familiar themes here.

First, sites with jQuery detected spend much less time on JavaScript work on the main thread than the other three analyzed. At the 10th percentile, there’s a 61% increase in JavaScript main thread work being done on mobile devices and 37% more on desktop. At the 90th percentile, jQuery sites are gain pretty darn close to the aggregate, spending 1.3% less time on the main thread for mobile devices and ..7% less time on desktop machines.

The opposite end—the frameworks that correlate to the most time spent on the main thread—is once again made up of Angular and React. The only difference is that while Angular sites shipped more JavaScript than React sites, they actually spend less time on the CPU—much less time.

At the 10th percentile, Angular sites spend 230% more time on the CPU for JavaScript related work on desktop devices, and 313% more on mobile devices. React sites bring up the tail end, spending 248% more time on desktop devices and 658% more time on mobile devices. No, 658% is not a typo. At the 10th percentile, sites with React spend 2.7s on the main thread dealing with all the JavaScript sent down.

Compared to those big numbers, the situation at the 90th percentile at least looks a little better. The main thread of Angular sites spends 29% more time on JavaScript for desktop devices and 27% more time on mobile devices. React sites spend 130% more time on desktop and 98% more time on mobile devices.

Those percentages look much better than at the 10th percentile, but keep in mind that the bulk numbers are pretty scary: that’s 20.8s of main thread work for sites built with React at the 90th percentile on mobile devices. (What, exactly, is happening during that time is a topic for a follow-up post, I think.)

There’s one potential gotcha (thanks Jeremy for making sure I double-checked the stats from this angle)—many sites will pull in multiple libraries. In particular, I see a lot of sites pulling jQuery in alongside React or Vue.js as they’re migrating to that architecture. So, I re-ran the queries, only this time I only included URLs that included only React, jQuery, Angular or Vue.js not some combination of them.

Scripting related CPU time (in milliseconds) for mobile devices where only one of the frameworks is detected, in percentiles
| 10th | 25th | 50th | 75th | 90th
--- | --- | --- | --- | --- | ---
Sites with only jQuery | 542.9ms | 1,062.2ms | 2,297.4ms | 4,769.7ms | 8,718.2ms
Sites with only Vue.js | 944.0ms | 1,716.3ms | 3,194.7ms | 5,959.6ms | 9,843.8ms
Sites with Angular | 1,328.9ms | 2,151.9ms | 3,695.3ms | 6,629.3ms | 11,607.7ms
Sites with React | 2,443.2ms | 4,620.5ms | 10,061.4ms | 17,074.3ms | 24,956.3ms

First, the unsurprising bit: when only one framework is used, performance improves far more often than not. The numbers for every framework look better at the 10th and 25th percentile. That makes sense. A site that is built well with one framework should perform better than a site that is built well with two or more.

In fact, the numbers for every framework look better at each percentile with one curious exception. What surprised me, and the reason I ended up including this data, is that at the 50th percentile and beyond, sites using React perform worse when React is the only framework in use.

It’s a bit odd, but here’s my best guess.

If you have React and jQuery running alongside each other, you’re more likely to be in the midst of a migration to React, or a mixed codebase. Since we have already seen that sites with jQuery spend less time on the main thread than sites with React, it makes sense that having some functionality still driven by jQuery would bring the numbers down a bit.

As you move away from jQuery and focus more on React exclusively, though, that changes. If the site is built really well and you’re using React sparingly, you’re fine. But for the average site, more work inside of React means the main thread receives an increasing amount of strain.

## The mobile/desktop gap

Another angle that’s worth looking at is just how large the gap is between that mobile experience and the desktop experience. Looking at it from a bytes perspective, nothing too scary jumps out. Sure, I’d love to see fewer bytes passed along, but neither mobile nor desktop devices receive significantly more bytes than the other.

But once you look at the processing time, the gap is significant.

Percentage increase in main thread scripting work on mobile devices compared to desktop devices, by percentiles
| 10th | 25th | 50th | 75th | 90th
--- | --- | --- | --- | --- | ---
All Sites | 144.1% | 172.8% | 185.5% | 208.5% | 224.0%
Sites with jQuery | 188.2% | 187.4% | 191.3% | 209.6% | 221.9%
Sites with Vue.js | 222.5% | 220.8% | 220.2% | 221.4% | 220.4%
Sites with Angular | 205.1% | 206.0% | 201.6% | 210.4% | 218.7%
Sites with React | 431.5% | 386.8% | 337.9% | 242.6% | 179.6%

While some variance is expected between a phone and a laptop, seeing numbers this high tells me that the current crop of frameworks isn’t doing enough to prioritize less powerful devices and help to close that gap. Even at the 10th percentile, React sites spend 431.5% more time on the main thread on mobile devices as they do on desktop devices. jQuery has the lowest gap of all frameworks, but even there, it equates to 188.2% more time on mobile devices. When we make the CPU work harder—and increasingly we are—folks with less powerful devices end up holding the bill.

## The big picture

Good frameworks should provide a better starting point on the essentials (security, accessibility, performance) or have built-in constraints that make it harder to ship something that violates those.

That doesn’t appear to be happening with performance (nor with accessibility, apparently).

It’s worth noting that because sites with React or Angular spend more time on the CPU than others, that isn’t necessarily the same as saying React is more expensive on the CPU than Vue.js. In fact, it says very little about the performance of the core frameworks in play and much more about the approach to development these frameworks may encourage (whether intentionally or not) through documentation, ecosystem, and general coding practices.

It’s also worth noting what we don’t have here: data about how much time the device spends on this JavaScript for subsequent views. The argument for the SPA architecture is that, once the SPA is in place, you theoretically get faster subsequent page loads. My own experience tells me that’s far from a given, but we don’t have concrete data here to make that case in either direction.

What is clear: right now, if you’re using a framework to build your site, you’re making a trade-off in terms of initial performance—even in the best of scenarios.

Some trade-off may be acceptable in the right situations, but it’s important that we make that exchange consciously.

There’s reason for optimism. I’m encouraged by how closely the folks at Chrome have been working with some of these frameworks to help improve their performance.

But I’m also pragmatic. New architectures tend to create performance problems just as often as they solve them, and it takes time to right the ship. Just as we shouldn’t expect new networks to solve all our performance woes, we shouldn’t expect that the next version of our favorite framework is going to solve them all either.

If you are going to use one of these frameworks, then you have to take extra steps to make sure you don’t negatively impact performance in the meantime. Here are a few great starting considerations:

- Do a sanity check: do you really need to use it? Vanilla JavaScript can do a lot today.
- Is there a lighter alternative (Preact, Svelte, etc.) that gets you 90% of the way there?
- If you’re going with a framework, does anything exist that provides better, more opinionated defaults (ex: Nuxt.js instead of Vue.js, Next.js instead of React, etc.)?
- What’s your performance budget going to be for your JavaScript?
- What friction can you introduce into the workflow that makes it harder to add any more JavaScript than absolutely necessary?
- If you’re using a framework for the developer ergonomics, do you need to ship it down to the client, or can you handle that all on the server?

These are generally good things to consider regardless of your technology choice, but they’re particularly important if you’re starting with a performance deficit from the beginning.

For example, we could use all sites that didn't have any of the mentioned frameworks (jQuery, React, Vue.js, Angular) detected.

Here are the numbers for the JavaScript main thread work on mobile devices for those URLs:

Scripting related CPU time (in milliseconds) for mobile devices, in percentiles
| 10th | 25th | 50th | 75th | 90th
--- | --- | --- | --- | --- | ---
All Sites | 6.3ms | 75.3ms | 382.2ms | 2,316.6ms | 5,504.7ms

Going even further, we could use all sites with no JavaScript framework or library detected at all. Here's what the main thread time looks like for those:

Scripting related CPU time (in milliseconds) for mobile devices, in percentiles
| 10th | 25th | 50th | 75th | 90th
--- | --- | --- | --- | --- | ---
All Sites | 3.6ms | 29.9ms | 193.2ms | 1,399.6ms | 3,714.5ms

With either baseline, the data would have looked less favorable and more dramatic. Ultimately, I ended up using the aggregate data as the baseline because:

- It's what is used broadly in the community whenever this stuff is discussed.
- It avoids derailing the conversation with debates about whether or not sites without frameworks are complex enough to be an accurate comparison. You can build large, complex sites without using a framework—I've worked with companies who have—but it's an argument that would distract from the otherwise pretty clear conclusions from the data.

Still, as a few folks pointed out to me when I was showing them the data, it's interesting to see these alternate baselines as they do make it very clear how much these tools are messing with the averages.