A few years ago, the advice for keeping your page fast was to keep your page weight down. These days, however, we know that it’s not necessarily how big your page is, it’s how, when, and if you send it content; a 5MB page and a 200kB page could have the same First Meaningful Paints and Times To Interactive. In this post, I’ll highlight our strategy for performantly loading the Sift Science single-page console application. (Note: you may find it easier to digest if you have some familiarity with webpack.)
Something important to keep in mind is that while there are certainly best practices, there aren’t necessarily any right answers; the best thing you can do is identify and weigh tradeoffs specific to your application. For our case, here are a few constraints to keep in mind:
This is a desktop-only app (used by companies’ fraud analyst teams)
We only need to support modern browsers (but not modern enough to be able to, say, ship native ES6 modules)
The app employs fairly strict CSP headers that ban all inline scripting
The Single Page App’s Single Page
Our app’s html file is really simple. In fact, I’ve included an exact screenshot of the pre-compiled pug file below (with pink dots highlighting our scripts):
Speaking of the loader GIF, we’ve also inlined some CSS animations nested within the
<svg> so that we can see it move without having to wait for our main CSS file to download:
And speaking of inlining, we’ve inlined the
<svg> content itself instead of using an
<img> tag so that the loader doesn’t need to be fetched—it can render immediately after the HTML is parsed!
Our Blocking Scripts
The first script we run into is one called
console.js is downloaded and executed—more on that in a bit.
By the way, when I say our chunks are route-based, that’s only half-true. In the Sift Console, we have a notion of a Section, which is comprised of multiple related Pages. For example, the Account Section might include the Billing Page, the Profile Page, and the Display Settings Page (among others, as shown below).
account-<hash>.js instead of
billing-<hash>.js, and when you then click on the Profile Page, you download nothing—you already have everything you need. The tradeoff, of course, is that the size of
account-<hash>.js will be greater than
billing-<hash>.js alone, and we’ve just front-loaded that weight. But since our app is a desktop app accessed over wifi, we determined that we’re okay with that tradeoff in exchange for making the user only wait once. (Side note: this looks super promising!) We do have a few pages that are notably larger than the rest, and those get their own route-based chunks.
You may have noticed that I’ve been writing out the chunk names with the
-<hash> placeholder. These hashes, used for caching and based on a file’s contents, are normally included as part of the webpack runtime so that webpack knows what filename to request; the runtime itself gets automatically prepended to every entry file. Unfortunately, that means that every time any of our chunks change (and thus their hashes), the hash for their parent (
console.js) also changes because of the hashes kept within the runtime!
To get around this, we utilized this awesome plugin from SoundCloud that extracts the hashes out of the runtime and into a JSON file. Alternatively, using the
inlineManifest: true option will assign them to a global variable in an inline
<script> tag for use in an html template. However, neither of these approaches actually works for us, because while we need to assign the JSON to a global variable, we can’t use inline scripts. So we forked the repo and hacked together our own version that writes to a
.js file, where the JSON is assigned to the global. That’s the purpose of the
chunkManifest.js file you see in the
Let’s take a look now at our
vendor.js file, placed at the top-level, just above our entry file.
Webpack 2 → Webpack 4
We recently upgraded our Webpack version with fantastic results. It turns out that all of your pre-defined Webpack 2 code chunks are by default self-contained, meaning they each bundle all modules they import. This led to a lot of duplication—we were splitting out our
vendor chunk via CommonsChunkPlugin, but that only extracted vendor files out of our
console.js entry point—all of our chunks each had their own vendor modules!
Notice in this chart how each of the chunks have their own
node_modules folder—except for our entry file
console.js, from which the
Webpack 4 takes care of this, removing CommonsChunkPlugin in favor of the SplitChunksPlugin, which does do splits of splits:
Notice how the only bundle that contains our
node_modules is our
vendor chunk—it’s now taken out of both our entry
console.js and all our splits! Furthermore, it created a split of our splits, containing modules common to all the async chunks, further dwindling their file size and their likelihood of getting cache-busted. Some of our chunks went down in size by over 90%!
So now that we have an appropriately-extracted vendor file, we add it as a top-level script in our
index.html. Oddly, webpack will name the file as an async chunk, which is why you see it in the above diagram with the
index.html screenshot). I think this is a bug, since if we’re extracting from our entry file, the resulting file should be a sibling to the entry—which is top-level.
On that note, requesting your vendor file dynamically means that your entry file will have to download and execute before the vendor request gets made. If your vendor file contains libraries critical to your application (for example, React or lodash), this would unnecessarily slow down your time-to-first-paint. As a top-level request, however, you can download it in parallel with your entry file, and take advantage of the browser’s lookahead parser to make a request even before the HTML file has finished parsing. You should really only dynamically request libraries if they’re only pertinent to a small subset of unfrequented pages in your application; otherwise, request it in parallel and know that, because libraries seldom change, it will be in the HTTP cache more often than not.
Preloading our Async Chunks
console.js file is downloaded and executed. Well, we came up with a way to preload those splits in parallel, which I wrote about in a blog post a few months back. I won’t repeat its contents here except to say that it is handled within our
By its nature, preloading is opportunistic; if it doesn’t happen, the app will still load successfully. But if it does happen, it will make the app load faster. This is a textbook example of when to use a script as
async, which is what we do here, meaning that it won’t block the HTML parser. Its position in the
index.html file is important, though—if it weren’t placed above the
console.js files, the async file would still get fetched early due to the browser’s lookahead parser, but it wouldn’t get executed until after the blocking files execute. And in that case, we’d still effectively be waiting for
console.js to load and execute.
What’s even better is that our
splitPreload script will automatically load in parallel all required splits for the current section. This includes our new “split of splits” from Webpack 4, so that all we end up requesting for our other sections is their own split file, which, as discussed, have shrunk significantly in size.
Preloading via rel=preload
<head>, we use the new preload spec to preload a script and stylesheet to load in WebGL maps via Mapbox. In their documentation, they recommend adding those assets as blocking assets. But this would be a mistake; if, for whatever reason, Mapbox’s servers become slow to respond, our console would become slow to load. So we load it async, but we load it async from a module inside our entry
rel=preload just means that by the time
console.js adds the assets to the page, they’ve already been requested and have likely already returned. If you have to support browsers that don’t support
rel=preload, loading these scripts with an
async attribute in
index.html (and outside of the entry file) would suffice, as well.
Server-side Rendering (SSR)
As you can probably tell from our
<img > tags and some styles.
But this is not the case for us. If, instead of the
BONUS: CSS and Font Loading Strategies
Just for kicks, let’s round out the rest of our
<link> tag is placed after our loader in the html (yes, in the
<body>!), so that the loader is already rendered by the time the page puts rendering on pause while the styles are fetched.
If, for some reason, the font request takes a very long time, we backup the preload with a
font-display: swap; rule for those browsers that support it—to at least, if we can’t avoid the FOUC, avoid any FOIT.
Did I miss anything? Disagree with anything? Don’t hesitate to let me know!
Love front-end performance? We love you. Come fight fraud with us!