1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
|
---
title: Web Performance
slug: Web/Performance
tags:
- API
- App
- App Performance
- HTML
- JavaScript
- Landing
- Mobile
- Mobile Performance
- NeedsTranslation
- Performance
- Performance Budget
- Start-Up Performance
- TopicStub
- Web
- Web Performance
translation_of: Web/Performance
---
<p><span class="seoSummary">Web performance is the objective measurements and the perceived user experience of load time and runtime. Web performance is how long a site takes to load, become interactive and responsive, and how smooth the content is during user interactions </span>- is the scrolling smooth? are buttons clickable? Are pop-ups quick to load and display, and do they animate smoothly as they do so? Web performance includes both objective measurements like time to load, frames per second, and time to become interactive, and subjective experiences of how long it felt like it took the content to load.</p>
<p>The longer it takes for a site to respond, the more users will abandon the site. It is important to minimize the loading and response times and add additional features to conceal latency by making the experience as available and interactive as possible, as soon as possible, while asynchronously loading in the longer tail parts of the experience.</p>
<p>There are tools, APIs, and best practices that help us measure and improve web performance. We cover them in this section:</p>
<h2 id="Key_performance_guides">Key performance guides</h2>
<p>{{LandingPageListSubpages}}</p>
<div class="cleared topicpage-table">
<div class="section">
<h2 id="Beginners_tutorials">Beginner's tutorials</h2>
<p>The MDN <a href="/en-US/docs/Learn/Performance">Web Performance Learning Area</a> contains modern, up-to-date tutorials covering Performance essentials. Start here if you are a newcomer to performance:</p>
<dl>
<dt></dt>
<dt><a href="/en-US/docs/Learn/Performance/web_performance_overview">Web performance: brief overview</a></dt>
<dd>Overview of the web performance learning path. Start your journey here.</dd>
<dt><a href="/en-US/docs/Learn/Performance/What_is_web_performance">What is web performance?</a></dt>
<dd>This article starts the module off with a good look at what performance actually is — this includes the tools, metrics, APIs, networks, and groups of people we need to consider when thinking about performance, and how we can make performance part of our web development workflow.</dd>
<dt><a href="/en-US/docs/Learn/Performance/Perceived_performance">How do users perceive performance?</a></dt>
<dd>
<p>More important than how fast your website is in milliseconds, is how fast your users perceive your site to be. These perceptions are impacted by actual p<span style="letter-spacing: -0.00278rem;">age load time, idling, responsiveness to user interaction, and the smoothness of scrolling and other animations. In this article, we discuss the various loading metrics, animation, and responsiveness metrics, along with best practices to improve user perception, if not the actual timings.</span></p>
</dd>
<dt><a href="/en-US/docs/Learn/Performance/Web_Performance_Basics">Web performance basics</a></dt>
<dd>In addition to the front end components of HTML, CSS, JavaScript, and media files, there are features that can make applications slower and features that can make applications subjectively and objectively faster. There are many APIs, developer tools, best practices, and bad practices relating to web performance. Here we'll introduce many of these features ad the basic level and provide links to deeper dives to improve performance for each topic.</dd>
<dt><a href="/en-US/docs/Learn/Performance/HTML">HTML performance features</a></dt>
<dd>Some attributes and the source order of your mark-up can impact the performance or your website. By minimizing the number of DOM nodes, making sure the best order and attributes are used for including content such as styles, scripts, media, and third-party scripts, you can drastically improve the user experience. This article looks in detail at how HTML can be used to ensure maximum performance.</dd>
<dt><a href="/en-US/docs/Learn/Performance/Multimedia">Multimedia: images and video</a></dt>
<dd>The lowest hanging fruit of web performance is often media optimization. Serving different media files based on each user agent's capability, size, and pixel density is possible. Additional tips like removing audio tracks from background videos can improve performance even further. In this article we discuss the impact video, audio, and image content has on performance, and the methods to ensure that impact is as minimal as possible.</dd>
<dt><a href="/en-US/docs/Learn/Performance/CSS">CSS performance features</a></dt>
<dd>CSS may be a less important optimization focus for improved performance, but there are some CSS features that impact performance more than others. In this article we look at some CSS properties that impact performance and suggested ways of handling styles to ensure performance is not negatively impacted.</dd>
<dt><a href="/en-US/docs/Learn/Performance/JavaScript">JavaScript performance best practices</a></dt>
<dd>JavaScript, when used properly, can allow for interactive and immersive web experiences — or it can significantly harm download time, render time, in-app performance, battery life, and user experience. This article outlines some JavaScript best practices that should be considered to ensure even complex content is as performant as possible.</dd>
<dt><a href="/en-US/docs/Learn/Performance/Mobile">Mobile performance</a></dt>
<dd>With web access on mobile devices being so popular, and all mobile platforms having fully-fledged web browsers, but possibly limited bandwidth, CPU and battery life, it is important to consider the performance of your web content on these platforms. This article looks at mobile-specific performance considerations.</dd>
</dl>
<dl>
</dl>
</div>
<div class="section">
<h2 class="Other_documentation" id="Other_documentation" name="Other_documentation">Using Performance APIs</h2>
<dl>
<dt><a href="/en-US/docs/Web/API/Performance_API/Using_the_Performance_API">Performance API</a></dt>
<dd>This guide describes how to use the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Performance" title="The Performance interface provides access to performance-related information for the current page. It's part of the High Resolution Time API, but is enhanced by the Performance Timeline API, the Navigation Timing API, the User Timing API, and the Resource Timing API."><code>Performance</code></a> interfaces that are defined in the <a class="external external-icon" href="https://w3c.github.io/hr-time/" rel="noopener">High-Resolution Time</a> standard.</dd>
<dt><a href="/en-US/docs/Web/API/Resource_Timing_API/Using_the_Resource_Timing_API">Resource Timing API</a></dt>
<dd><a href="/en-US/docs/Web/API/Resource_Timing_API">Resource loading and timing</a> the loading of those resources, including managing the resource buffer and coping with CORS</dd>
<dt><a href="/en-US/docs/Web/API/Performance_Timeline/Using_Performance_Timeline">The performance timeline</a></dt>
<dd>The <a href="/en-US/docs/Web/API/Performance_Timeline">Performance Timeline</a> standard defines extensions to the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Performance" title="The Performance interface provides access to performance-related information for the current page. It's part of the High Resolution Time API, but is enhanced by the Performance Timeline API, the Navigation Timing API, the User Timing API, and the Resource Timing API."><code>Performance</code></a> interface to support client-side latency measurements within applications. Together, these interfaces can be used to help identify an application's performance bottlenecks.</dd>
<dt><a href="/en-US/docs/Web/API/User_Timing_API/Using_the_User_Timing_API">User Timing API</a></dt>
<dd>Create application specific timestamps using the <a href="/en-US/docs/Web/API/User_Timing_API">user timing API</a>'s "mark" and "measure" entry types - that are part of the browser's performance timeline.</dd>
<dt><a href="/en-US/docs/Web/API/Frame_Timing_API/Using_the_Frame_Timing_API">Frame Timing API</a></dt>
<dd>The <code><a href="/en-US/docs/Web/API/PerformanceFrameTiming">PerformanceFrameTiming</a></code> interface provides <em>frame</em> timing data about the browser's event loop.</dd>
<dt><a href="/en-US/docs/Web/API/Beacon_API/Using_the_Beacon_API">Beacon API</a></dt>
<dd><small>The <a href="/en-US/docs/Web/API/Beacon_API">Beacon</a> interface schedules an asynchronous and non-blocking request to a web server.</small></dd>
<dt><a href="/en-US/docs/Web/API/Intersection_Observer_API/Timing_element_visibility">Intersection Observer API</a></dt>
<dd>Learn to time element visibility with the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API">Intersection Observer API</a> and be asynchronously notified when elements of interest becomes visible.</dd>
</dl>
<h2 class="Other_documentation" id="Other_documentation" name="Other_documentation">Other documentation</h2>
<dl>
<dt><a href="/en-US/docs/Tools/Performance">Developer Tools Performance Features</a></dt>
<dd>This section provides information on how to use and understand the performance features in your developer tools, including <a href="/en-US/docs/Tools/Performance/Waterfall">Waterfall</a>, <a href="/en-US/docs/Tools/Performance/Call_Tree">Call Tree</a>, and <a href="/en-US/docs/Tools/Performance/Flame_Chart">Flame Charts</a>.</dd>
<dt><a href="/en-US/docs/Mozilla/Performance/Profiling_with_the_Built-in_Profiler">Profiling with the built-in profiler</a></dt>
<dd>Learn how to profile app performance with Firefox's built-in profiler.</dd>
</dl>
</div>
</div>
<h2 id="Glossary_Terms">Glossary Terms</h2>
<div class="index">
<ul class="index">
<li>{{glossary('Beacon')}}</li>
<li>{{glossary('Brotli compression')}}</li>
<li>{{glossary('Client hints')}}</li>
<li>{{glossary('Code splitting')}}</li>
<li>{{glossary('CSSOM')}}</li>
<li>{{glossary('Domain sharding')}}</li>
<li>{{glossary('Effective connection type')}}</li>
<li>{{glossary('First contentful paint')}}</li>
<li>{{glossary('First CPU idle')}}</li>
<li>{{glossary('First input delay')}}</li>
<li>{{glossary('First interactive')}}</li>
<li>{{glossary('First meaningful paint')}}</li>
<li>{{glossary('First paint')}}</li>
<li>{{glossary('HTTP')}}</li>
<li>{{glossary('HTTP_2', 'HTTP/2')}}</li>
<li>{{glossary('Jank')}}</li>
<li>{{glossary('Latency')}}</li>
<li>{{glossary('Lazy load')}}</li>
<li>{{glossary('Long task')}}</li>
<li>{{glossary('Lossless compression')}}</li>
<li>{{glossary('Lossy compression')}}</li>
<li>{{glossary('Main thread')}}</li>
<li>{{glossary('Minification')}}</li>
<li>{{glossary('Network throttling')}}</li>
<li>{{glossary('Packet')}}</li>
<li>{{glossary('Page load time')}}</li>
<li>{{glossary('Page prediction')}}</li>
<li>{{glossary('Parse')}}</li>
<li>{{glossary('Perceived performance')}}</li>
<li>{{glossary('Prefetch')}}</li>
<li>{{glossary('Prerender')}}</li>
<li>{{glossary('QUIC')}}</li>
<li>{{glossary('RAIL')}}</li>
<li>{{glossary('Real User Monitoring')}}</li>
<li>{{glossary('Resource Timing')}}</li>
<li>{{glossary('Round Trip Time (RTT)')}}</li>
<li>{{glossary('Server Timing')}}</li>
<li>{{glossary('Speculative parsing')}}</li>
<li>{{glossary('Speed index')}}</li>
<li>{{glossary('SSL')}}</li>
<li>{{glossary('Synthetic monitoring')}}</li>
<li>{{glossary('TCP handshake')}}</li>
<li>{{glossary('TCP slow start')}}</li>
<li>{{glossary('Time to first byte')}}</li>
<li>{{glossary('Time to interactive')}}</li>
<li>{{glossary('TLS')}}</li>
<li>{{glossary('TCP', 'Transmission Control Protocol (TCP)')}}</li>
<li>{{glossary('Tree shaking')}}</li>
<li>{{glossary('Web performance')}}</li>
</ul>
</div>
<h2 id="Documents_yet_to_be_written">Documents yet to be written</h2>
<dl>
<dt><a href="/en-US/docs/Learn/Performance/JavaScript">JavaScript performance best practices</a></dt>
<dd>JavaScript, when used properly, can allow for interactive and immersive web experiences ... or it can significantly harm download time, render time, in app performance, battery life, and user experience. <span class="veryhardreadability"><span><span>This article outlines some JavaScript best practices that can ensure even complex content's performance is the highest possible.</span></span></span></dd>
<dt><a href="/en-US/docs/Learn/Performance/Mobile">Mobile performance</a></dt>
<dd>With web access on mobile devices being so popular, and all mobile platforms having fully-fledged web browsers, but possibly limited bandwidth, CPU, and battery life, it is important to consider the performance of your web content on these platforms. This article also looks at mobile-specific performance considerations.</dd>
<dt>Web font performance</dt>
<dd>An often overlooked aspect of performance landscape are web fonts. Web fonts are more prominent in web design than ever, yet many developers simply embed them from a third party service and think nothing of it. In this article, we'll covers methods for getting your font files as small as possible with efficient file formats and sub setting. From there, we'll go on to talk about how browsers text, and how you can use CSS and JavaScript features to ensure your fonts render quickly, and with minimal disruption to the user experience.</dd>
<dt>Performance bottlenecks</dt>
<dd></dd>
<dt>Understanding bandwidth</dt>
<dd>
<div>
<div class="public-DraftStyleDefault-block public-DraftStyleDefault-ltr"><span><span>Bandwidth is the amount of data measured in Megabits(Mb) or Kilobits(Kb) that one can send per second. </span></span><span class="veryhardreadability"><span><span>This article explains the role of bandwidth in media-rich internet applications, how you can measure it, and how you can optimize applications to make the best use of available bandwidth</span></span></span><span><span>.</span></span></div>
</div>
</dd>
<dd></dd>
<dt>The role of TLS in performance</dt>
<dd>
<p>TLS—or HTTPS as we tend to call it—is crucial in creating secure and safe user experiences. While hardware has reduced the negative impacts TLS has had on server performance, it still represents a substantial slice of the time we spend waiting for browsers to connect to servers. This article explains the TLS handshake process, and offers some tips for reducing this time, such as OCSP stapling, HSTS preload headers, and the potential role of resource hints in masking TLS latency for third parties.</p>
</dd>
<dt>Reading performance charts</dt>
<dd>Developer tools provide information on performance, memory, and network requests. Knowing how to read <a href="https://developer.mozilla.org/en-US/docs/Tools/Performance/Waterfall">waterfall</a> charts, <a href="https://developer.mozilla.org/en-US/docs/Tools/Performance/Call_Tree">call trees</a>, traces, <a href="https://developer.mozilla.org/en-US/docs/Tools/Performance/Flame_Chart">flame charts</a> , and <a href="https://developer.mozilla.org/en-US/docs/Tools/Performance/Allocations">allocations</a> in your browser developer tools will help you understand waterfall and flame charts in other performance tools.</dd>
<dt>Alternative media formats</dt>
<dd>When it comes to images and videos, there are more formats than you're likely aware of. Some of these formats can take your highly optimized media-rich pages even further by offering additional reductions in file size. In this guide we'll discuss some alternative media formats, how to use them responsibly so that non-supporting browsers don't get left out in the cold, and some advanced guidance on transcoding your existing assets to them.</dd>
<dt>Analyzing JavaScript bundles</dt>
<dd>No doubt, JavaScript is a big part of modern web development. While you should always strive to reduce the amount of JavaScript you use in your applications, it can be difficult to know where to start. <span class="veryhardreadability"><span><span>In this guide, we'll show you how to analyze your application's script bundles, so you know </span></span><em><span>what</span></em><span><span> you're using, as well how to detect if your app contains duplicated scripts between bundles</span></span></span><span><span>.</span></span></dd>
<dt><a href="/en-US/docs/Web/Performance/Lazy_loading">Lazy loading</a></dt>
<dd>It isn't always necessary to load all of a web applications assets on initial page load. Lazy Loading is deferring the loading of assets on a page, such as scripts, images, etc., on a page to a later point in time i.e when those assets are actually needed.</dd>
<dt>Lazy-loading JavaScript with dynamic imports</dt>
<dd>When developers hear the term "lazy loading", they immediately think of below-the-fold imagery that loads when it scrolls into the viewport. But did you know you can lazy load JavaScript as well? In this guide we'll talk about the dynamic import() statement, which is a feature in modern browsers that loads a JavaScript module on demand. Of course, since this feature isn't available everywhere, we'll also show you how you can configure your tooling to use this feature in a widely compatible fashion.</dd>
<dt><a href="/en-US/docs/Web/Performance/Controlling_resource_delivery_with_resource_hints">Controlling resource delivery with resource hints</a></dt>
<dd>Browsers often know better than we do when it comes to resource prioritization and delivery however they're far from clairyovant. Native browser features enable us to hint to the browser when it should connect to another server, or preload a resource before the browser knows it ever needs it. When used judiciously, this can make fast experience seem even faster. In this article, we cover native browser features like rel=preconnect, rel=dns-prefetch, rel=prefetch, and rel=preload, and how to use them to your advantage.</dd>
<dt><a href="/en-US/docs/Web/Performance/Performance_budgets">Performance Budgets</a></dt>
<dd>Marketing, design, and sales needs, and developer experience, often ad bloat, third-party scripts, and other features that can slow down web performance. To help set priorities, it is helpful to set a performance budget: a set of restrictions to not exceed during the development phase. In this article, we'll discuss creating and sticking to a performance budget. </dd>
<dt><a href="/en-US/docs/Web/Performance/Checklist">Web performance checklist</a></dt>
<dd>A performance checklist of features to consider when developing applications with links to tutorials on how to implement each feature, include service workers, diagnosing performance problems, font loading best practices, client hints, creating performant animations, etc.</dd>
<dt><a href="/en-US/docs/Web/Performance/Mobile_performance_checklist">Mobile performance checklist</a></dt>
<dd>A concise checklist of performance considerations impacting mobile network users on hand-held, battery operated devices.</dd>
</dl>
<h2 id="See_also">See also</h2>
<p>HTML</p>
<ul>
<li><a href="/en-US/docs/Web/HTML/Element/picture">The <code><picture></code> Element</a></li>
<li><a href="/en-US/docs/Web/HTML/Element/video">The <code><video></code> Element</a></li>
<li><a href="/en-US/docs/Web/HTML/Element/source">The <code><source></code> Element</a></li>
<li><a href="/en-US/docs/Web/HTML/Element/img#Attributes">The <code><img> srcset</code> attribute</a>
<ul>
<li><a href="/en-US/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images">Responsive images</a></li>
</ul>
</li>
<li><a href="/en-US/docs/Web/HTML/Preloading_content">Preloading content with <code>rel="preload"</code></a> - <a href="https://w3c.github.io/preload/">(https://w3c.github.io/preload/ </a>)</li>
</ul>
<p>CSS</p>
<ul>
<li><a href="/en-US/docs/Web/CSS/will-change">will-change</a></li>
<li>GPU v CPU</li>
<li>Measuring layout</li>
<li>Font-loading best practices</li>
</ul>
<p>JavaScript</p>
<ul>
<li><a href="/en-US/docs/Web/Events/DOMContentLoaded">DOMContentLoaded</a></li>
<li><a href="/en-US/docs/Glossary/Garbage_collection">Garbage collection</a></li>
<li><a href="/en-US/docs/Web/API/window/requestAnimationFrame">requestAnimationFrame</a></li>
</ul>
<p>APIs</p>
<ul>
<li><a href="/en-US/docs/Web/API/Performance_API">Performance API</a></li>
<li><a href="/en-US/docs/Web/API/Navigation_timing_API">Navigation Timing API</a></li>
<li><a href="/en-US/docs/Web/API/Media_Capabilities_API/Using_the_Media_Capabilities_API">Media Capabilities API</a></li>
<li><a href="/en-US/docs/Web/API/Network_Information_API">Network Information API</a></li>
<li><a href="/en-US/docs/Web/API/PerformanceNavigationTiming">PerformanceNavigationTiming</a></li>
<li><a href="/en-US/docs/Web/API/Battery_Status_API">Battery Status API</a></li>
<li><a href="/en-US/docs/Web/API/Navigator/deviceMemory">Navigator.deviceMemory</a></li>
<li><a href="/en-US/docs/Web/API/Intersection_Observer_API">Intersection Observer</a></li>
<li><a href="/en-US/docs/Web/API/User_Timing_API/Using_the_User_Timing_API">Using the User Timing AP</a>I</li>
<li><a href="/en-US/docs/Web/API/Long_Tasks_API">Long Tasks API</a></li>
<li><a href="/en-US/docs/Web/API/DOMHighResTimeStamp">High Resolution Timing API</a> (<a href="https://w3c.github.io/hr-time/">https://w3c.github.io/hr-time/)</a></li>
<li><a href="/en-US/docs/Web/API/Resource_Timing_API/Using_the_Resource_Timing_API">Resource Timing API</a></li>
<li><a href="/en-US/docs/Web/API/Page_Visibility_API">Page Visibility</a></li>
<li><a href="/en-US/docs/Web/API/Background_Tasks_API">Cooperative Scheduling of Background Tasks API</a>
<ul>
<li style="margin-top: 0.25em;"><a href="/en-US/docs/Web/API/Window/requestIdleCallback">requestIdleCallback() </a></li>
</ul>
</li>
<li><a href="/en-US/docs/Web/API/Beacon_API/Using_the_Beacon_API">Beacon API</a></li>
<li>Resource Hints - <a href="/en-US/docs/Web/HTTP/Headers/X-DNS-Prefetch-Control">dns-prefetch</a>, preconnect, <a href="/en-US/docs/Web/HTTP/Link_prefetching_FAQ">prefetch</a>, and prerender</li>
<li><a href="/en-US/docs/Web/API/FetchEvent/navigationPreload">Fetchevent.navigationPreload</a></li>
<li><a href="/en-US/docs/Web/API/PerformanceServerTiming">Performance Server Timing API</a></li>
</ul>
<p>Headers</p>
<ul>
<li><a href="/en-US/docs/Web/HTTP/Headers/Content-Encoding">Content-encoding</a></li>
<li>HTTP/2</li>
<li><a href="/en-US/docs/Glossary/GZip_compression">gZip</a></li>
<li>Client Hints</li>
</ul>
<p>Tools</p>
<ul>
<li><a href="/en-US/docs/Tools/Performance">Performance in Firefox Developer Tools</a></li>
<li>Flame charts</li>
<li>The Network panel</li>
<li>Waterfall charts</li>
</ul>
<p>Additional Metrics</p>
<ul>
<li>Speed Index and Perceptual Speed Index</li>
</ul>
<p>Best Practices</p>
<ul>
<li><a href="/en-US/docs/Web/API/Service_Worker_API/Using_Service_Workers">Using Service Workers</a></li>
<li><a href="/en-US/docs/Web/API/Web_Workers_API/Using_web_workers">Using Web Workers</a>
<ul>
<li><a href="/en-US/docs/Web/API/Web_Workers_API">Web Workers API</a></li>
</ul>
</li>
<li><a href="/en-US/docs/Web/Apps/Progressive/Offline_Service_workers">PWA</a></li>
<li><a href="/en-US/docs/Web/HTTP/Caching">Caching</a></li>
<li>Content Delivery Networks (CDN)</li>
</ul>
|