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>
Теперь библиотека всегда выполняется первой, а график — вторым.
Как поймать гонку у себя
Баг «через раз» на быстром компьютере почти не воспроизводится. Заставь браузер работать как медленный телефон:
- Открой DevTools → вкладка Network.
- Поставь галочку Disable cache — иначе файлы придут из кэша мгновенно.
- В списке скорости выбери Slow 4G или 3G.
- Обнови страницу пять-шесть раз подряд и смотри в консоль.
Если ошибка 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 коротких урока на телефоне.





