Optimizing an Angular application is important, but how do you make sure its performance doesn't regress over time? By introducing performance metrics and monitoring them on each code change!
Calculate your performance budget
Configure a performance budget in the Angular CLI
You'll see that the following budget has been configured in
Here's a summary of what's being specified:
- If the
mainbundle gets bigger than 170 KB, the Angular CLI will show a warning in the console when you build the app.
- If the
mainbundle gets bigger than 250 KB, the build will fail.
Now try building the app by running
ng build --prod.
You should see this error in the console:
To fix the build error, take a look at
app.component.ts, which includes an import from
rxjs/internal/operators. This is a private import that's not supposed to be used by consumers of
rxjs. It increases the bundle size a lot! When you update to the correct import,
rxjs/operators, and run the build again, you'll see that it passes the budget check successfully.
Note that, since differential loading is enabled by default in the Angular CLI, the
ng build command produces two builds of the app:
- A build for older browsers without ECMAScript 2015 support. The older syntax is less expressive and requires more polyfills, which leads to larger bundles.
index.html file of the sample app refers to both builds so that modern browsers can take advantage of the smaller ECMAScript 2015 build and older browsers can fall back to the ECMAScript 5 build.
Enforce your budget as part of continuous integration
If you prefer, you can also enforce a performance budget using bundlesize and Lighthouse. The main difference between performance budgets in the Angular CLI and Lighthouse is when the checks get performed. The Angular CLI performs the checks at build time, looking at the production assets and verifying their sizes. Lighthouse, however, opens the deployed version of the application and measures the asset size. Both approaches have their pros and cons. The check that Angular CLI performs is less robust but much faster since it's a single disk lookup. On the other hand, the LightWallet of Lighthouse can perform a very accurate check by considering dynamically loaded resources, but it needs to deploy and open the app each time it runs.
bundlesize is quite similar to the Angular CLI's budget check; the main difference is that bundlesize can show the check results directly in GitHub's user interface.
Establish performance budgets with the Angular CLI to make sure your Angular app's performance doesn't regress over time:
- Set a baseline for the resource size either by using a budget calculator or by following your organization's practices.
- Configure size budgets in
- The budgets will be automatically enforced on each build with the Angular CLI.
- Consider introducing budget monitoring as part of continuous integration (which can also be achieved with the Angular CLI).
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.