Do you need async and/or defer?

These HTML attributes are said to be powerful. Let’s check it.

Permalink to heading Simple presentation Simple presentation

async and defer are simple attributes to use with your script tags =

<script defer src="./js/myjavascript.js"></script>
<script async src="./js/myjavascript.js"></script>

It might seem self-explanatory, but I’ve seen a lot of misuses.

Do you need both? Where to use it? When to use it?

Permalink to heading Simple definitions Simple definitions

Here are very light descriptions for these attributes:

  • async tells the browser to execute your JavaScript asynchronously
  • defer tells the browser to execute your JavaScript only after parsing the whole HTML document

Permalink to heading Differences with/without these attributes Differences with/without these attributes

As we just saw, you have to add those attributes if you want the browser to act differently. Without async or defer, the browser stops parsing the document every time it finds an external js call, such as <script src="./js/myjavascript.js"></script>.

In this case, the browser pauses its parsing and fetches the js file to execute it. That’s the reason why you often read that those calls are blocking.

In that perspective, it’s a good practice to put your js calls at the end of the document, just before the </body> tag when it’s possible, to reduce the amount of blocking resources. Lighthouse often tells you that ^^.

Permalink to heading async to the rescue async to the rescue

The best-case scenario for async is when you need support for modern browsers only, and your script is entirely standalone, with no dependencies, so you don’t expect results from other scripts to run your code.

Source: Caniuse

Permalink to heading But I’ve seen the use of both attributes But I’ve seen the use of both attributes

It’s not rare to see both attributes on the same tag:

<script defer async src="./js/myjavascript.js"></script>

People may use that for ancient browsers where async is not supported, so it fallbacks to defer, as defer is pretty much older than async ( IE 6 for defer vs. IE 10 for async!!!)

Permalink to heading I don’t get it. Is it async, defer, or both? I don’t get it. Is it async, defer, or both?

There are subtleties you have to know.

If your scripts are very close to the closing </body> tag, it makes less sense to defer or async as the browser has almost finished its parsing. You won’t significantly improve performances in this case.

Depending on the rendering engine, JavaScript is more or less blocking. In other words, the browser reduces blocking by dedicating threads to parse your js whether you’ve added the attributes or not.

With defer or async, the browser fetches your script asynchronously, but with defer, it will execute it only after parsing the whole HTML document, whereas, with async, it will execute it as soon as your js is ready.

As a result, the browser parsing may still pause even if you use async.

It’s worth noting that if you defer several scripts, they will execute in the same order you’ve added them, even if it’s deferred. It’s not the same with async. You don’t get the same level of control.

Permalink to heading Potential misunderstandings Potential misunderstandings

You won’t eliminate all render-blocking issues by using defer or async. Don’t forget to use the appropriate JavaScript event.

Deferred JavaScript executes BEFORE images and stylesheets are loaded and parsed. More precisely, it’s before domContentLoaded.

Regarding async, don’t write the following:

<script src="mylib.js" async></script>
<script src="myscript.js" async></script>

If myscript.js needs functions set in mylib.js, it won’t work as you might expect. Remember that as soon as the script is available, the browser executes it with async.

Permalink to heading Wrap up Wrap up

I’ve used the async attribute in particular cases only. I prefer the defer attribute, but I don’t use it either if my script tags are very close to the closing </body> tag.

Again, the vast majority of modern browsers and rendering engines are pretty good at deferring and optimizing stuff, so it’s probably more clever not to add anything than introducing nasty bugs, but these attributes are still impressive.


I do my best to update all my contents, but keep it mind that "Do you need async and/or defer?" has been published many months ago.