Scan Website

Команда scan запрашивает публичный URL, измеряет общий размер страницы и проверяет состояние i18n и SEO страницы. Она создает отчет с оценкой (0–100), охватывающий HTML-атрибуты, канонические ссылки, теги hreflang, robots.txt, sitemap.xml, локализованные внутренние ссылки и вес локалей в JavaScript-бандле.

Никаких дополнительных зависимостей не требуется. Если установлен puppeteer, сканирование может фиксировать лениво загружаемые (lazy-loaded) JavaScript-чанки для более точного анализа сборки; в противном случае оно проверяет только скрипты, объявленные в HTML для немедленной загрузки.

Использование

npx intlayer scan <url>

Пример

npx intlayer scan https://example.com

Пример вывода:

🔍 Scanned https://example.com (basic mode)Score: 90/100Page size: 10.60 MB (HTML 42.31 KB)Locales: en, fr, es, de, …Checks:  ✓ html lang attribute  ✓ html dir attribute  ✓ canonical link  ✓ hreflang tags  ✓ x-default hreflang  ✓ localized internal links  ⚠ all internal links localized  ✓ current locale detected  ✓ robots.txt present  ✓ robots.txt keeps locale paths crawlable  ✓ sitemap.xml present  ✓ sitemap lists every locale  ✓ sitemap has alternate links  ✓ sitemap has x-defaultBundle locale weight:  Translations shipped: 120.50 KB  Unused (other locales): 45.20 KB (37%)

Параметры

<url> (обязательно)

Полный URL-адрес для сканирования (например, https://example.com).

--no-deep

Отключить более глубокое сканирование на основе рендеринга страницы.

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

Передайте --no-deep, чтобы принудительно использовать базовый режим, даже если puppeteer доступен.

Пример: npx intlayer scan https://example.com --no-deep

--json

Вывод полного результата сканирования в виде JSON-объекта вместо форматированного отчета. Полезно для программного использования или в CI-пайплайнах.

Пример: npx intlayer scan https://example.com --json

Стандартные параметры конфигурации

• --base-dir — Базовая директория для поиска файла intlayer.config.*.
• -e, --env — Целевое окружение (например, development, production).
• --env-file — Путь к кастомному файлу .env.
• --no-cache — Отключить кэширование конфигурации.
• --verbose — Включить подробное логирование (по умолчанию включено в режиме CLI).
• --prefix — Кастомный префикс для логов.

Что проверяется

Итоговая оценка представляет собой средневзвешенную сумму всех пройденных проверок, выраженную в процентах (0–100).

Использование функции сканирования в коде

Функция scan также экспортируется из пакета @intlayer/cli, поэтому её можно вызывать в ваших собственных скриптах:

import { scan } from "@intlayer/cli";await scan("https://example.com", {  deep: false,  json: false,});

Для более низкоуровневого доступа функция scanWebsite из модуля @intlayer/chokidar/scan возвращает структурированный объект ScanResult:

import { scanWebsite } from "@intlayer/chokidar/scan";const result = await scanWebsite("https://example.com", { deep: false });console.log(result.score, result.totalPageSize, result.events);