Scanner le site web

La commande scan récupère une URL publique, mesure la taille totale de la page et audite la santé i18n et SEO de la page. Elle produit un rapport avec un score (0–100) couvrant les attributs HTML, les liens canoniques, les balises hreflang, robots.txt, sitemap.xml, les liens internes localisés et le poids des locales dans le bundle JavaScript.

Aucune dépendance supplémentaire n'est requise. Lorsque puppeteer est installé, le scan peut capturer les morceaux de JavaScript chargés à la demande (lazy-loaded) pour une analyse plus précise du bundle ; sinon, il se replie sur l'inspection des scripts chargés directement déclarés dans le HTML.

Utilisation

npx intlayer scan <url>

Exemple

npx intlayer scan https://example.com

Exemple de sortie :

🔍 Scanned https://example.com (basic mode)

Score: 90/100
Page 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-default

Bundle locale weight:
  Translations shipped: 120.50 KB
  Unused (other locales): 45.20 KB (37%)

Options

<url> (requis)

L'URL complète à scanner (par exemple, https://example.com).

--no-deep

Désactive le scan approfondi basé sur le rendu.

Par défaut, la commande tente d'utiliser puppeteer pour rendre la page dans un navigateur headless, capturer les morceaux de JavaScript chargés à la demande et mesurer la taille réelle de transfert. Si puppeteer n'est pas installé, la commande se replie automatiquement sur le mode basique.

Passez --no-deep pour forcer le mode basique même lorsque puppeteer est disponible.

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

--json

Affiche le résultat complet du scan sous forme d'objet JSON au lieu d'un rapport formaté. Utile pour une consommation programmatique ou des pipelines CI.

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

Options de configuration standard

• --base-dir — Répertoire de base utilisé pour localiser le fichier intlayer.config.*.
• -e, --env — Environnement cible (par exemple, development, production).
• --env-file — Chemin vers un fichier .env personnalisé.
• --no-cache — Désactiver le cache de configuration.
• --ci — Exécute la commande dans chaque projet Intlayer du monorepo (ou uniquement le projet courant si lancée depuis son répertoire). Des identifiants par projet peuvent être injectés via INTLAYER_PROJECT_CREDENTIALS, un objet JSON associant chaque chemin de projet à { "clientId", "clientSecret" }.
• --verbose — Activer le journal détaillé (par défaut en mode CLI).
• --prefix — Préfixe de journal personnalisé.

Ce qui est vérifié

Le score final est la somme pondérée de toutes les vérifications réussies exprimée en pourcentage (0–100).

Utilisation programmatique de la fonction de scan

La fonction scan est également exportée depuis @intlayer/cli afin de pouvoir être appelée depuis vos propres scripts :

import { scan } from "@intlayer/cli";

await scan("https://example.com", {
  deep: false,
  json: false,
});

Pour un accès de niveau inférieur, scanWebsite de @intlayer/engine/scan renvoie un objet ScanResult structuré :

import { scanWebsite } from "@intlayer/engine/scan";

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