Современные сайты всё чаще строятся на JavaScript: карточки товаров, фильтры каталога, цены, отзывы и навигация загружаются динамически. Для пользователя всё выглядит нормально, но для поисковой системы между «сервер отдал HTML» и «пользователь увидел страницу» происходит несколько технических этапов. Если на одном из них возникнет ошибка — Google просто не увидит ваш контент.
Почему JavaScript может стать проблемой для SEO
JavaScript используется для создания интерактивных интерфейсов и динамического формирования содержимого страниц. Например, интернет-магазин может загружать карточки товаров, цены и характеристики только после выполнения JavaScript и обращения к API.
Для пользователя это выглядит как обычная страница каталога. Однако технически между загрузкой HTML и появлением содержимого происходит несколько операций:
- Браузер получает первоначальный HTML.
- Загружаются JavaScript-файлы.
- Выполняются скрипты приложения.
- Отправляются запросы к API.
- Полученные данные вставляются в DOM.
- Пользователь видит готовый интерфейс.
Если на одном из этапов возникает ошибка, важный контент может не появиться. Типичные причины:
- API возвращает ошибку 403 или 500;
- JavaScript-файл не загружается;
- скрипт завершается с ошибкой;
- контент зависит от авторизации;
- ссылки формируются только после взаимодействия пользователя;
- необходимые ресурсы заблокированы в
robots.txt.
Google умеет обрабатывать JavaScript, но это не означает, что любой JS-код автоматически будет обработан без ошибок.
Как Googlebot обрабатывает JavaScript
Google описывает три основных этапа обработки JavaScript-страниц: сканирование, рендеринг и индексирование.
Каждый этап — отдельная техническая операция. Проблема на любом из них приводит к потере контента.
Этап 1. Crawling — получение HTML
Googlebot обращается к URL и получает HTTP-ответ сервера.
HTTP/2 200
Content-Type: text/html; charset=UTF-8 Если сайт использует Client-Side Rendering, первоначальный HTML может содержать только оболочку приложения:
<!DOCTYPE html>
<html lang="ru">
<head>
<title>Каталог товаров</title>
</head>
<body>
<div id="app"></div>
<script src="/assets/app.js"></script>
</body>
</html> В исходном документе практически нет основного содержимого страницы.
Этап 2. Rendering — выполнение JavaScript
Google ставит страницу в очередь на рендеринг. Система рендеринга запускает JavaScript, загружает необходимые ресурсы и формирует DOM.
После выполнения скриптов первоначальный HTML может превратиться в полноценную страницу:
<main>
<h1>Купить строительные смеси</h1>
<p>
Каталог строительных смесей
с доставкой по региону.
</p>
<a href="/catalog/smesi/">
Все смеси
</a>
</main> Однако если JavaScript выполняется с ошибкой, API недоступен или нужный ресурс заблокирован, DOM может остаться неполным.
Этап 3. Indexing — обработка содержимого
Google анализирует полученное содержимое и принимает решение о дальнейшей обработке страницы и её включении в индекс.
Наличие текста в отрисованном DOM само по себе не гарантирует индексирование. На результат влияют качество страницы, дублирование, canonical, технические ограничения и другие факторы.
CSR, SSR и SSG: какая архитектура лучше для SEO
| Технология | Как работает | Особенности для SEO |
|---|---|---|
| CSR | HTML формируется преимущественно в браузере | Требует корректного выполнения JavaScript |
| SSR | HTML формируется на сервере при запросе | Основной контент доступен сразу в ответе |
| SSG | HTML генерируется заранее | Стабильный исходный HTML для поисковых систем |
| Prerendering | Заранее создаётся HTML-представление страницы | Может упростить обработку контента |
Client-Side Rendering
Сервер отдаёт минимальную HTML-оболочку, контент формируется на стороне браузера. Проблема — когда важные элементы зависят от цепочки скриптов, API-запросов и условий выполнения.
Server-Side Rendering
Сервер возвращает HTML с готовым содержимым. Робот сразу получает заголовок, описание и ссылки. После загрузки JS приложение активирует интерактивные элементы.
Static Site Generation
HTML создаётся заранее при сборке сайта. Подходит для информационных страниц, категорий каталога и документации.
Prerendering
Заранее создаётся HTML-представление для конкретных URL. Можно использовать как точечное решение для важных страниц.
Что выбрать?
Не нужно автоматически переводить весь проект на SSR только потому, что он использует JavaScript. Если Google корректно получает контент и ссылки после рендеринга, CSR может работать. Серверный или статический рендеринг часто делает обработку содержимого более предсказуемой.
Диагностика: сравниваем исходный HTML и отрисованный DOM
Это одна из важнейших проверок JavaScript SEO. Необходимо выяснить, какой контент присутствует в HTML сразу после ответа сервера и что появляется только после выполнения JavaScript.
Способ 1. Просмотр исходного кода
Откройте страницу в браузере и нажмите Ctrl + U. Либо используйте адресную строку:
view-source:https://example.com/catalog/ Найдите в исходном коде:
- H1;
- основной текст;
- ссылки;
- названия товаров;
- цены;
- canonical;
- meta robots;
- JSON-LD.
Если в исходном HTML отсутствуют практически все важные элементы — это повод проверить отрисованный DOM.
Способ 2. Проверка через DevTools
Откройте страницу и нажмите F12. Перейдите во вкладку Elements и сравните DOM с исходным HTML.
| Элемент | Исходный HTML | DOM после JS |
|---|---|---|
| H1 | Отсутствует | Присутствует |
| Описание | Отсутствует | Присутствует |
| Карточки товаров | Отсутствуют | Присутствуют |
| Внутренние ссылки | Отсутствуют | Присутствуют |
| Canonical | Присутствует | Присутствует |
Такая картина говорит о том, что значительная часть содержимого зависит от JavaScript.
Способ 3. Сравнение через Screaming Frog
В Screaming Frog SEO Spider можно выполнить два обхода сайта:
- С обычным HTML-рендерингом.
- С JavaScript-рендерингом.
Настройка:
Configuration
→ Spider
→ Rendering
→ JavaScript После этого сравните: HTML Word Count, Rendered HTML Word Count, количество ссылок, H1, Title, Description, canonical и содержимое страниц.
Пример диагностики
Допустим, проверяем 500 страниц интернет-магазина.
| Показатель | До JS | После JS |
|---|---|---|
| Среднее количество слов | 42 | 680 |
| Страницы с H1 | 500 | 500 |
| Внутренние ссылки | 1 200 | 8 700 |
| Страницы с карточками товаров | 18 | 462 |
В этом примере основная часть содержимого формируется на стороне клиента. Это не означает, что Google обязательно не сможет обработать такие страницы — но есть основание проверить отрисованный HTML средствами Google.
Проверка через Google Search Console
Инструмент проверки URL позволяет посмотреть, как Google получает и обрабатывает конкретную страницу.
- Откройте Google Search Console.
- Вставьте URL в верхнюю строку проверки.
- Нажмите «Проверить опубликованный URL» (Test Live URL).
- Дождитесь завершения проверки.
- Откройте просмотр проверенной страницы.
- Изучите HTML и информацию о загруженных ресурсах.
Проверять необходимо не только главную страницу. Для интернет-магазина я бы выбрал:
- главную;
- категорию;
- подкатегорию;
- карточку товара;
- страницу с фильтром;
- страницу с пагинацией;
- страницу с динамической подгрузкой.
На что обращать внимание
- Основной текст. Присутствует ли содержимое, которое пользователь видит на странице?
- Заголовки. Корректно ли формируются H1 и H2?
- Ссылки. Может ли Google обнаружить ссылки на категории и товары?
- Изображения. Формируются ли корректные адреса изображений?
- Метаданные. Правильно ли формируются title, description и canonical?
- Ошибки ресурсов. Нет ли ошибок загрузки JavaScript и CSS?
Для дополнительной проверки структурированных данных можно использовать Google Rich Results Test.
Проверяем загрузку API и динамического контента
Одна из самых неприятных проблем — когда страница визуально работает, но данные загружаются нестабильно.
Например, интернет-магазин формирует карточку товара после обращения к API:
fetch('/api/products/123')
.then(response => response.json())
.then(product => {
document.querySelector('#product-name').textContent =
product.name;
document.querySelector('#product-price').textContent =
product.price;
}); В обычном браузере всё может работать нормально. Но если API возвращает ошибку, блокировку доступа или некорректный JSON — содержимое не появится.
Что проверять в DevTools
Откройте F12 → Network, обновите страницу и установите фильтр Fetch/XHR. Проверьте:
- какие API-запросы отправляются;
- какие ответы возвращает сервер;
- есть ли ошибки 4xx и 5xx;
- сколько времени занимают запросы;
- нет ли блокировок CORS;
- не зависит ли загрузка данных от авторизации;
- не требуется ли дополнительное действие пользователя.
Особое внимание уделите ответам API, которые формируют названия товаров, цены, описания, характеристики, отзывы и списки категорий.
Типовой сценарий проблемы
Предположим, интернет-магазин использует API для загрузки каталога:
GET /api/catalog/category/15
HTTP/2 403 В результате карточки товаров не появляются. В браузере администратора всё может работать, поскольку у него есть действующая сессия. Но публичный посетитель и поисковый робот получают совершенно другую картину.
Решение:
- проверить доступность API без авторизации;
- убрать обязательную зависимость индексируемого контента от пользовательской сессии;
- проверить CORS и настройки доступа;
- предусмотреть корректную обработку ошибок;
- для важных страниц рассмотреть SSR или предварительную генерацию HTML.
Проверяем внутренние ссылки, сформированные JavaScript
Это отдельная проблема, которую часто недооценивают.
Допустим, каталог содержит 300 товаров. Пользователь видит карточки, кликает на них и переходит на страницы товаров. Но ссылки формируются через обработчик JavaScript:
<div onclick="openProduct(123)">
Смартфон
</div> Для пользователя это работает, но такая конструкция не эквивалентна обычной HTML-ссылке. Для поисковой системы предпочтительнее:
<a href="/catalog/smartfony/model-123/">
Смартфон
</a> Google рекомендует использовать ссылки с атрибутом href, чтобы URL могли обнаруживаться и обрабатываться поисковым роботом.
Что проверять
- Есть ли у ссылок реальный
href. - Не заменены ли ссылки на
divилиspanс обработчиками. - Не формируются ли адреса только после клика.
- Доступны ли ссылки без авторизации.
- Не блокируется ли переход через JavaScript.
- Не используются ли некорректные относительные URL.
Пример из практики
В ходе проверки каталога из 1 200 URL обнаружено:
- 1 200 карточек отображаются пользователю;
- 1 200 элементов имеют обработчики клика;
- только 340 элементов содержат полноценные HTML-ссылки.
После доработки шаблона все карточки получили обычные ссылки. Это позволило устранить проблему обнаружения URL через внутреннюю навигацию.
href не гарантирует индексацию товаров. Оно решает задачу обнаружения и обхода URL, но не заменяет остальные требования к индексируемой странице.
HTTP, robots, canonical и JavaScript-ошибки
| Проверка | Что может быть проблемой |
|---|---|
| HTTP-код | Страница возвращает 404, 403 или 5xx |
| Robots.txt | Закрыты важные ресурсы или сама страница |
| Meta robots | Присутствует noindex |
| X-Robots-Tag | Сервер отдаёт запрет на индексацию |
| Canonical | Указывает на другой URL |
| Redirect | Происходит неожиданный редирект |
| Sitemap | URL отсутствует в карте сайта |
Проверка через командную строку
Для первичной диагностики можно использовать:
curl -I https://example.com/catalog/ Проверяем HTTP-заголовки. Затем:
curl -L https://example.com/catalog/ Получаем HTML-ответ сервера с учётом редиректов. Ищем в нём title, H1, canonical и meta robots.
Необходимо учитывать, что curl не выполняет JavaScript — поэтому он показывает первоначальный ответ сервера, а не итоговый DOM после рендеринга.
Проверка JavaScript-ошибок
Откройте страницу, нажмите F12 и перейдите во вкладку Console. Ищите сообщения:
Uncaught TypeError
ReferenceError
Failed to fetch
SyntaxError Особенно опасны ошибки, которые останавливают формирование основного содержимого.
Что делать:
- Проверить ошибки в консоли.
- Найти скрипт, который формирует основной контент.
- Проверить обработку пустых и некорректных ответов API.
- Добавить обработку исключений.
- Проверить поведение при медленной загрузке.
- Повторить тест после исправлений.
Практический кейс: интернет-магазин с невидимым каталогом
Рассмотрим условный интернет-магазин строительных материалов. Сайт работает на JavaScript-фреймворке, категории и карточки товаров формируются через API.
Владелец замечает, что значительная часть категорий плохо индексируется, а новые товары долго не появляются в Google. При этом визуально сайт работает без ошибок.
Исходные данные
| Показатель | Значение |
|---|---|
| Всего URL в каталоге | 8 400 |
| Категории | 320 |
| Карточки товаров | 7 800 |
| Страницы с фильтрами | 280 |
| URL в индексе Google | 2 950 |
| Страницы с JS-зависимым контентом | 7 600 |
Этап 1. Первичная проверка
При сравнении исходного HTML и отрисованного DOM обнаружилось:
- в исходном HTML отсутствовали названия большинства товаров;
- описания категорий формировались после API-запросов;
- часть ссылок создавалась через обработчики событий;
- некоторые фильтры формировали URL только после взаимодействия пользователя.
Этап 2. Проверка API
При тестировании запросов обнаружили, что часть ответов API возвращала ошибку 403 для неавторизованных запросов. В административной сессии сайт работал нормально, поэтому проблему не замечали при обычном просмотре.
Этап 3. Проверка ссылочной структуры
Из 7 800 карточек товаров:
- 2 100 имели полноценные ссылки с
href; - остальные использовали элементы с JavaScript-обработчиками.
Это затрудняло обнаружение части URL через внутреннюю навигацию.
Этап 4. Внесённые изменения
- Сделали API каталога доступным для публичного просмотра.
- Добавили серверную генерацию HTML для категорий и карточек товаров.
- Перевели навигационные элементы на обычные ссылки.
- Исправили формирование canonical для фильтров.
- Пересмотрели правила индексации параметрических URL.
- Добавили контроль ошибок JavaScript.
- Проверили основные шаблоны через URL Inspection.
Результаты после внедрения
| Показатель | До работ | После работ |
|---|---|---|
| URL в индексе | 2 950 | 5 760 |
| Категории с контентом в исходном HTML | 18% | 96% |
| Карточки с доступными HTML-ссылками | 27% | 100% |
| Ошибки API на тестовых URL | 14% | 0% |
| Страницы с корректным canonical | 82% | 99% |
После технических изменений доля индексируемых страниц выросла, а количество проблем с формированием содержимого снизилась. Однако изменение архитектуры не гарантирует индексацию каждой страницы — Google отдельно оценивает качество, полезность и самостоятельную ценность контента.
Как исправлять проблемы JavaScript SEO
| Проблема | Что делать |
|---|---|
| Основной контент отсутствует в исходном HTML | Рассмотреть SSR или SSG для важных страниц |
| API возвращает 403 или 500 | Исправить доступность и обработку API |
Карточки не имеют href | Использовать полноценные HTML-ссылки |
| Canonical меняется после рендеринга | Синхронизировать canonical в исходном и итоговом HTML |
| Скрипты завершаются ошибками | Найти и исправить JavaScript-ошибки |
| Контент появляется только после клика | Сделать важное содержимое доступным без взаимодействия |
| Google не загружает JS/CSS | Проверить доступность ресурсов и robots.txt |
| SPA возвращает 200 для несуществующих страниц | Настроить корректную обработку 404 и Soft 404 |
| Контент зависит от авторизации | Сделать публичные индексируемые данные доступными без сессии |
Нужно ли полностью отказываться от JavaScript?
Нет. JavaScript — нормальная часть современной веб-разработки. Сам факт его использования не является SEO-ошибкой. Проблема возникает тогда, когда поисковая система не может получить важное содержимое или корректно обработать структуру страницы.
Для индексируемых страниц лучше стремиться к тому, чтобы ключевые элементы были доступны максимально надёжно:
- основной текст;
- заголовки;
- товарные данные;
- внутренние ссылки;
- метаданные;
- canonical;
- структурированные данные.
Почему Dynamic Rendering — не универсальное решение
Раньше одним из способов решения подобных проблем считался Dynamic Rendering: сервер определял поискового робота и отдавал ему заранее отрисованную HTML-версию страницы. Однако Google рассматривает этот подход как временное обходное решение, а не как долгосрочную архитектуру. Вместо него рекомендуется рассматривать SSR, статический рендеринг или гидратацию.
Полезные инструменты для JavaScript SEO
Проверять JavaScript-сайт удобно связкой из нескольких инструментов: каждый закрывает свою часть задачи и даёт свой тип данных. Ниже — набор, который я использую на реальных аудитах.
Google Search Console
Главный источник правды о том, что Google видит на странице и как она представлена в индексе.
- URL Inspection — отрисованный HTML
- Покрытие и исключённые страницы
- Запросы, кликабельность и позиции
Screaming Frog SEO Spider
Десктопный краулер для проверки всего сайта. Умеет рендерить JavaScript через встроенный Chromium и сравнивать исходный и отрисованный HTML.
- HTML Word Count против Rendered HTML
- Поиск страниц с пустым контентом
- Ссылки без атрибута href
Chrome DevTools
Встроенный набор инструментов браузера: DOM после выполнения скриптов, сетевые запросы, ошибки JavaScript и вес ресурсов.
- Elements — отрисованный DOM
- Network — статусы и тайминги API
- Console — ошибки JavaScript
- Coverage — неиспользуемый код
Rich Results Test
Проверка структурированных данных JSON-LD, Microdata и RDFa — именно они используются для расширенных сниппетов в поиске.
- Валидация разметки Schema.org
- Поддерживаемые типы контента
- Превью будущего сниппета
Mobile-Friendly Test
Показывает, как Google отрисует страницу для мобильного пользователя: какие ресурсы загрузятся, а какие будут заблокированы.
- Скриншот мобильного рендера
- Список недоступных ресурсов
- Проблемы с viewport и вёрсткой
curl + Терминал
Самый быстрый способ увидеть документ, который сервер отдаёт поисковому роботу без выполнения JavaScript.
- Коды ответов и заголовки
- Первоначальный HTML-документ
- Редиректы, canonical, robots
Чек-лист технического аудита JavaScript SEO
Используйте этот чек-лист для самопроверки. Прогресс сохраняется автоматически — можно вернуться к проверке позже.
Пункты аудита
0 / 0Исходный HTML
Рендеринг
Внутренняя структура
Индексация
FAQ: частые вопросы о JavaScript SEO
Да. Google умеет выполнять JavaScript и использовать отрисованный HTML для обработки содержимого страниц. Однако необходимо учитывать ограничения рендеринга и доступность ресурсов.
Не обязательно. Если Google корректно получает контент и ссылки после рендеринга, CSR может работать. SSR и SSG часто делают обработку содержимого более предсказуемой.
Используйте URL Inspection в Google Search Console и проверьте отрисованную страницу. Дополнительно сравните исходный HTML и DOM после выполнения JavaScript.
Он может добавлять этап рендеринга и создавать дополнительные зависимости. Однако нельзя утверждать, что любая JavaScript-страница будет индексироваться медленнее: многое зависит от архитектуры и конкретной реализации.
Возможные причины: ошибки JavaScript, недоступность API, блокировка ресурсов, зависимость от авторизации, некорректная загрузка данных или проблемы с формированием DOM.
Нет, если эти файлы необходимы для формирования содержимого страницы. Блокировка важных ресурсов может помешать корректному рендерингу.
Заключение
JavaScript сам по себе не мешает продвижению сайта в Google. Проблемы появляются тогда, когда важные элементы страницы зависят от нестабильной цепочки загрузки скриптов, API-запросов и динамического формирования DOM.
Поэтому технический аудит JavaScript-сайта не должен ограничиваться проверкой исходного кода или просмотром страницы в браузере. Нужно сопоставить несколько уровней:
- Что сервер отдаёт в первоначальном HTML.
- Что появляется после выполнения JavaScript.
- Какие ресурсы и API-запросы используются.
- Какие ссылки доступны поисковому роботу.
- Что Google получает при проверке опубликованного URL.
- Как страницы представлены в поисковом индексе.
Именно сопоставление этих данных позволяет обнаружить проблемы, которые невозможно увидеть при обычном визуальном просмотре сайта.
В техническом SEO важно не только то, что видит пользователь. Важно понимать, какой документ в итоге получает поисковая система.
