Skanuj stronę internetową

Polecenie scan pobiera publiczny adres URL, mierzy całkowity rozmiar strony i przeprowadza audyt zdrowia i18n oraz SEO strony. Generuje ono raport z punktacją (0–100) obejmujący atrybuty HTML, linki kanoniczne, tagi hreflang, robots.txt, sitemap.xml, zlokalizowane linki wewnętrzne oraz wagę językową w pakiecie (bundle) JavaScript.

Nie są wymagane żadne dodatkowe zależności. Kiedy zainstalowany jest puppeteer, skanowanie może przechwytywać opóźnieniej ładowane (lazy-loaded) fragmenty kodu JavaScript dla dokładniejszej analizy pakietu; w przeciwnym razie wraca do inspekcji skryptów ładowanych natychmiast, zadeklarowanych w kodzie HTML.

Użycie

npx intlayer scan <url>

Przykład

npx intlayer scan https://example.com

Przykładowe dane wyjściowe:

🔍 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%)

Opcje

<url> (wymagane)

Pełny adres URL do zeskanowania (np. https://example.com).

--no-deep

Wyłącza głębsze skanowanie oparte na renderowaniu strony.

Domyślnie polecenie próbuje użyć biblioteki puppeteer do wyrenderowania strony w przeglądarce bezinterfejsowej (headless browser), przechwycenia opóźnioniej ładowanych fragmentów kodu JavaScript i zmierzenia rzeczywistego rozmiaru transferu. Jeśli puppeteer nie jest zainstalowany, polecenie automatycznie przechodzi w tryb podstawowy.

Przekaż --no-deep, aby wymusić tryb podstawowy, nawet gdy puppeteer jest dostępny.

Przykład: npx intlayer scan https://example.com --no-deep

--json

Wypisuje pełny wynik skanowania jako obiekt JSON zamiast sformatowanego raportu. Przydatne do użycia programistycznego lub w potokach CI.

Przykład: npx intlayer scan https://example.com --json

Standardowe opcje konfiguracji

• --base-dir — Katalog bazowy używany do zlokalizowania pliku intlayer.config.*.
• -e, --env — Środowisko docelowe (np. development, production).
• --env-file — Ścieżka do niestandardowego pliku .env.
• --no-cache — Wyłącza pamięć podręczną konfiguracji.
• --verbose — Włącza pełne logowanie (domyślne w trybie CLI).
• --prefix — Niestandardowy prefiks logów.

Co podlega sprawdzeniu

Wynik końcowy to ważona suma wszystkich pomyślnie zaliczonych sprawdzeń wyrażona w procentach (0–100).

Programistyczne korzystanie z funkcji skanowania

Funkcja scan jest również eksportowana z @intlayer/cli, dzięki czemu można ją wywoływać z poziomu własnych skryptów:

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

W przypadku dostępu niskopoziomowego funkcja scanWebsite z modułu @intlayer/chokidar/scan zwraca ustrukturyzowany obiekt ScanResult:

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