{ "index": 20, "slug": "editorial-2027-06-mechanism-performance-capstone", "title": "Waterfall без иллюзий: как доказать, что ресурс задерживает первый экран", "excerpt": "Длинная полоса в waterfall не равна причине задержки. Разбираем зависимость ресурса, инициатора и потребителя, а затем проверяем одно изменение на учебной странице.", "contentHtml": "

Пользователь видит пустой или неполный первый экран. В DevTools рядом с ним растягивается полоса шрифта или изображения. Команда объявляет этот ресурс виновником и меняет порядок загрузки. Через релиз экран не ускоряется, зато появляется лишний preload, вспышка нестилизованного текста или гонка между скриптами. Цена ошибки — не только потерянные миллисекунды. Вы меняете контракт загрузки, не доказав, что страницу действительно задерживал этот запрос.

\n

Waterfall показывает время сетевой работы. Он не показывает причинность сам по себе. Ресурс влияет на экран только тогда, когда его результат нужен конкретной зависимости: parser ждёт script, CSS нужен для построения стилей, layout ждёт шрифт, а компонент ждёт данные. Поэтому тезис статьи простой: ищите не самую длинную полосу, а цепочку «инициатор → ресурс → потребитель → наблюдаемый эффект».

\n

Что именно нужно доказать

\n

У каждой записи ресурса есть временная и причинная часть. startTime говорит, когда запрос начал работу, а responseEnd — когда браузер получил последний байт. initiatorType помогает понять, кто начал запрос: parser, script, css, fetch или другой источник. Эти поля описывают наблюдение. Они ещё не отвечают, ждал ли результат первый экран.

\n

Для причинности добавьте три вопроса. Какой элемент или код потребляет ответ? В какой момент он потребляет его? Что изменится, если ответ придёт позже или не придёт вовсе? Если на последний вопрос нет проверяемого ответа, запись остаётся кандидатом. Её нельзя называть узким местом.

\n
Симптом → причина → проверка → действие
СимптомПричинаПроверкаДействие
CSS заканчивается поздно, первый экран пустойСтили нужны до первого layoutСопоставить тег link, DOM и момент первого визуального результатаУменьшить критический CSS или разделить его, затем проверить layout shift
Script начинается рано и долго выполняетсяParser или главный поток ждёт выполнениеПроверить атрибуты, initiator и long taskПрименить defer или разбить работу только после проверки зависимостей
Шрифт имеет длинную полосу, но контент уже виденШрифт не нужен первому экрану или заменяется fallbackСравнить момент ответа шрифта с визуальным результатом и layoutНе добавлять preload; проверить font-display и потребителя
JSON заканчивается поздно, карточки пустыеКомпонент ждёт fetchНайти вызов, состояние ожидания и время отображения данныхОптимизировать запрос или skeleton, не меняя случайные сетевые приоритеты
Одна запись отсутствует в отчётеНет поддержки поля, кросс-доменное ограничение или буфер очищенПроверить браузер, Timing-Allow-Origin и момент чтенияПометить «нет данных» и выбрать другой сигнал
\n
\"Матрица
Иллюстрация связывает строку waterfall с проверкой зависимости. Размер ресурса — только один из входов, а не итоговый вердикт.
\n

Модель загрузки на конкретном примере

\n

Рассмотрим страницу с таким HTML:

\n
<head>\n  <link rel=\"stylesheet\" href=\"/app.css\">\n  <script src=\"/vendor.js\" defer></script>\n  <script src=\"/analytics.js\" async></script>\n</head>\n<body>\n  <main id=\"catalog\"></main>\n  <script src=\"/catalog.js\" defer></script>\n</body>
\n

app.css может влиять на первый layout. vendor.js и catalog.js загружаются параллельно с разбором HTML, но выполняются после разбора документа и сохраняют порядок между собой. analytics.js выполняется, когда загрузится, поэтому не должен зависеть от глобального объекта, который создаёт другой script. Его длинная полоса не объясняет задержку каталога, если аналитика не участвует в рендере.

\n

Учебный наблюдатель ниже читает доступные записи после загрузки страницы. Он не меняет сеть и не утверждает, что каждая ранняя запись блокирует экран. Пример предназначен для локальной или тестовой страницы. Он показывает границу данных: если поле не поддерживается, результат будет unknown, а не выдуманный статус.

\n
const navigation = performance.getEntriesByType('navigation')[0];\nconst domEnd = navigation?.domContentLoadedEventEnd ?? Infinity;\n\nconst resources = performance\n  .getEntriesByType('resource')\n  .filter((entry) => entry.startTime < domEnd)\n  .map((entry) => ({\n    name: new URL(entry.name).pathname,\n    initiator: entry.initiatorType || 'unknown',\n    start: Math.round(entry.startTime),\n    end: Math.round(entry.responseEnd),\n    duration: Math.round(entry.duration),\n    blocking: entry.renderBlockingStatus ?? 'unknown',\n  }));\n\nconsole.table(resources);
\n

Фильтр ограничивает список ресурсами, которые начали работу до DOMContentLoaded. Это удобная граница для первичного поиска, но не доказательство готовности экрана. DOM мог закончить разбор, пока изображение, шрифт или отрисовка ещё продолжаются. Для визуального симптома нужен отдельный браузерный прогон и понятный элемент, который считается первым полезным результатом.

\n

Дальше найдите инициатор в HTML или исходном коде. Для parser проверьте тег. Для script найдите вызов fetch, импорт или создание элемента. Для css проверьте правило и используемый шрифт. Затем назовите потребителя. Формулировка «CSS заканчивается поздно» слишком слабая. Формулировка «карточки не получают стили до первого layout, потому что link указывает на полный файл» уже задаёт проверяемое действие.

\n

Порядок проверки

\n
  1. Зафиксируйте URL, браузер, viewport, сеть, режим кэша и состояние авторизации. Без этих условий две записи waterfall нельзя честно сравнить.
  2. Опишите симптом словами пользователя: пустой первый экран, поздние карточки, скачок текста или задержка интерактивности. Запишите момент и элемент, а не только общую длительность.
  3. Снимите navigation entry и resource entries в одном прогоне. Сохраните исходные значения, включая URL, инициатор, время начала, конец ответа и доступный статус блокировки.
  4. Отберите ранние записи по типу и времени. Для каждой найдите конкретный тег, вызов или CSS-правило, которое запустило запрос.
  5. Назовите потребителя и проверьте его зависимость. Удалите ресурс, отложите его в учебной копии или замените ответом-заглушкой. Если симптом не меняется, гипотеза не подтверждена.
  6. Измените один фактор: defer, разделение CSS, порядок запроса или код потребителя. Не смешивайте изменение сети с изменением рендера.
  7. Повторите прогон в тех же условиях. Сравните визуальный критерий, long tasks и нужный участок waterfall. Сокращение отдельной полосы без изменения симптома не считается успехом.
\n

Когда популярные исправления вредят

\n

preload запускает запрос раньше. Это полезно для действительно критичного ресурса, но лишний preload конкурирует с HTML, CSS и данными. Укажите правильный as и проверьте, что документ использует ответ. Иначе браузер предупреждает о неиспользованной загрузке, а критический путь становится шире.

\n

async освобождает parser, но отдаёт порядок выполнения сети. Он подходит для независимого кода. Если script читает объект, который создаёт другой script, или меняет DOM до инициализации компонента, появится гонка. defer сохраняет порядок отложенных скриптов, но не уменьшает размер файла и не доказывает, что работа главного потока стала короче.

\n

Разделение CSS снижает ранний объём только при точной границе. Ошибка даёт FOUC, неверный порядок правил или layout shift. Отложенный шрифт может убрать блокировку, но изменить переносы строк и высоту блока. Каждое исправление нужно оценивать по тому же потребителю, который породил исходный симптом.

\n

Отрицательный путь важен. Если waterfall показывает поздний запрос, но первый экран от него не зависит, остановите оптимизацию этой строки. Если данные недоступны из-за политики браузера, не подставляйте ноль. Если замер меняет состояние кэша, не сравнивайте его с холодным запуском. Честный вывод «причина не доказана» экономит больше времени, чем уверенная правка не того слоя.

\n

Ограничения и критерий готовности

\n

Resource Timing зависит от браузера и политики доступа. Кросс-доменные значения могут быть скрыты без Timing-Allow-Origin. renderBlockingStatus может отсутствовать. DOMContentLoaded не равен FCP или LCP, а локальная сеть не воспроизводит мобильное устройство. Записи Performance API не описывают серверную очередь, весь главный поток и пользовательский опыт одной цифрой.

\n

Учебный код не даёт production-результатов. Его задача — показать форму проверки. Для реального решения нужны повторяемые прогоны в целевых браузерах, сохранённые условия и выбранный визуальный критерий. Не называйте ресурс блокирующим только потому, что он большой, ранний или заметный на скриншоте DevTools.

\n

Работа готова, когда для заявленного симптома есть исходная запись и повторяемый критерий, у спорного ресурса найден инициатор и потребитель, одно изменение прошло в тех же условиях, а отрицательный путь тоже описан. После изменения должен измениться именно наблюдаемый симптом или заранее выбранная метрика. Если меняется только длина полосы, расследование не закончено.

\n

Проверяемые источники

" }