Что такое…

async или defer в теге script — и почему с async сайт ломается через раз

Иллюстрация: один курьер ждёт у готовой двери, другой врывается в недостроенный дом

У тебя на сайте график. Подключены два скрипта: библиотека для графиков и твой код, который её использует. ИИ посоветовал «ускорить загрузку» и дописал обоим async:

<script async src="chart-library.js"></script>
<script async src="my-chart.js"></script>

У тебя всё работает. А друг открывает сайт с телефона — и графика нет. В консоли: Chart is not defined. Обновляет страницу — график на месте. Ещё раз — снова нет.

Смотри, в чём штука. async выполняет скрипты в том порядке, в каком они скачались, а не в каком написаны. Твой файл маленький — он иногда приходит первым и вызывает библиотеку, которой ещё нет. Это классическое состояние гонки. Разберём, чем async отличается от defer и когда что ставить.

Что делает браузер без атрибутов

Сначала база. Браузер читает HTML сверху вниз и строит страницу. Встречает обычный <script src="..."> — останавливается. Скачивает файл, выполняет его, и только потом читает HTML дальше.

Две проблемы. Пока скрипт качается, страница пустая. А если скрипт стоит в <head> и ищет кнопку через document.querySelector, он получит null — кнопки ещё нет, браузер до неё не дочитал.

async и defer решают первую проблему одинаково: файл качается параллельно, браузер продолжает строить страницу. А вот когда скрипт выполнится — тут они расходятся.

Сравнение по пяти критериям

1. Когда выполняется.

  • async — сразу, как только скачался. Даже если страница ещё недостроена: браузер на время выполнения замирает.
  • defer — только когда весь HTML прочитан. Страница уже построена целиком.

2. Порядок выполнения.

  • async — кто первый скачался, тот и выполнился. Порядок в HTML не важен.
  • defer — строго в том порядке, в каком скрипты написаны в HTML.

Это и есть главное отличие. Скрипты, которые зависят друг от друга, с async ставить нельзя.

3. Видит ли элементы страницы.

  • async — не гарантированно. Может выполниться, когда половины страницы ещё нет.
  • defer — да, всегда. Весь HTML уже прочитан, querySelector найдёт любую кнопку.

4. Отношение к событию DOMContentLoaded.

  • async — может выполниться и до него, и после. Подписка на него из async-скрипта иногда опаздывает.
  • defer — все defer-скрипты выполняются до DOMContentLoaded. Событие гарантированно ещё впереди.

5. Работает ли со встроенным кодом.

  • Оба атрибута работают только у скриптов с src. На <script defer> с кодом внутри тега defer просто игнорируется. (Исключение — type="module", о нём ниже.)

Кому что подойдёт

Без увиливаний: для твоего собственного кода бери defer. Он сохраняет порядок, видит всю страницу и не блокирует загрузку. Это безопасный выбор по умолчанию.

async — для скриптов, которые ни от кого не зависят и от них никто не зависит. Счётчик посещений, виджет чата, рекламный пиксель. Им всё равно, что вокруг, а пусть начинают работу пораньше. Именно так ставят, например, скрипт аналитики.

Простой тест: «если этот скрипт выполнится первым на странице — что-то сломается?» Если да — defer. Если нет — можно async.

Сломанный пример из начала чинится одним словом:

<script defer src="chart-library.js"></script>
<script defer src="my-chart.js"></script>

Теперь библиотека всегда выполняется первой, а график — вторым.

Как поймать гонку у себя

Баг «через раз» на быстром компьютере почти не воспроизводится. Заставь браузер работать как медленный телефон:

  1. Открой DevTools → вкладка Network.
  2. Поставь галочку Disable cache — иначе файлы придут из кэша мгновенно.
  3. В списке скорости выбери Slow 4G или 3G.
  4. Обнови страницу пять-шесть раз подряд и смотри в консоль.

Если ошибка is not defined появляется не каждый раз, а иногда — это гонка из-за async. Поменяй на defer и повтори: ошибка должна исчезнуть совсем.

А что с type="module"

Современные сборщики (Vite, Next.js) подключают код как <script type="module">. Такие скрипты ведут себя как defer по умолчанию — писать атрибут не нужно. Поэтому в проекте на Vite ты этих проблем почти не встретишь.

Они вылезают в обычном HTML: лендинг на одном файле, вставка чужого виджета, сайт на конструкторе с кастомным кодом. Как раз там, где ИИ любит «ускорять» через async. Больше способов ускорить страницу — в разборе как ускорить сайт.

Что будет, если написать и async, и defer?

Современный браузер выполнит скрипт как async. defer в такой паре — запасной вариант для очень старых браузеров. Не пиши оба: смысл читается хуже.

Почему у меня работает, а у пользователей нет?

На своём компьютере ты грузишь файлы из кэша или с localhost — они приходят почти одновременно и в «удачном» порядке. На медленном мобильном интернете порядок меняется. Ошибки, которые появляются «через раз», почти всегда означают гонку — проверь async.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →