Website scannen

Der Befehl scan ruft eine öffentliche URL ab, misst die Gesamtseitengröße und überprüft die i18n- und SEO-Gesundheit der Seite. Er erstellt einen bewerteten Bericht (0–100), der HTML-Attribute, kanonische Links, hreflang-Tags, robots.txt, sitemap.xml, lokalisierte interne Links und das Gewicht der Lokalisierungsdaten im JavaScript-Bundle abdeckt.

Es sind keine zusätzlichen Abhängigkeiten erforderlich. Wenn puppeteer installiert ist, kann der Scan träge geladene (lazy-loaded) JavaScript-Chunks erfassen, um eine präzisere Bundle-Analyse durchzuführen. Andernfalls fällt er auf die Überprüfung der im HTML deklarierten, direkt geladenen Skripte zurück.

Verwendung

npx intlayer scan <url>

Beispiel

npx intlayer scan https://example.com

Beispielausgabe:

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

Optionen

<url> (erforderlich)

Die vollständige URL, die gescannt werden soll (z. B. https://example.com).

--no-deep

Deaktiviert den tieferen, auf Rendering basierenden Scan.

Standardmäßig versucht der Befehl, puppeteer zu verwenden, um die Seite in einem kopflosen (headless) Browser zu rendern, träge geladene JavaScript-Chunks zu erfassen und die tatsächliche Übertragungsgröße zu messen. Wenn puppeteer nicht installiert ist, fällt der Befehl automatisch in den Basismodus zurück.

Übergeben Sie --no-deep, um den Basismodus zu erzwingen, selbst wenn puppeteer verfügbar ist.

Beispiel: npx intlayer scan https://example.com --no-deep

--json

Gibt das vollständige Scan-Ergebnis als JSON-Objekt anstelle eines formatierten Berichts aus. Nützlich für die programmatische Verwendung oder CI-Pipelines.

Beispiel: npx intlayer scan https://example.com --json

Standard-Konfigurationsoptionen

• --base-dir — Basisverzeichnis zur Lokalisierung der Datei intlayer.config.*.
• -e, --env — Zielumgebung (z. B. development, production).
• --env-file — Pfad zu einer benutzerdefinierten .env-Datei.
• --no-cache — Konfigurationscache deaktivieren.
• --verbose — Ausführliche Protokollierung aktivieren (Standardwert im CLI-Modus).
• --prefix — Benutzerdefiniertes Protokollpräfix.

Was überprüft wird

Die endgültige Bewertung ist die gewichtete Summe aller erfolgreichen Überprüfungen, ausgedrückt als Prozentsatz (0–100).

Verwendung der Scan-Funktion im Code (programmatisch)

Die Funktion scan wird auch aus @intlayer/cli exportiert, sodass sie in Ihren eigenen Skripten aufgerufen werden kann:

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

Für den Zugriff auf niedrigerer Ebene gibt scanWebsite aus @intlayer/chokidar/scan ein strukturiertes ScanResult-Objekt zurück:

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