Escanear Website

O comando scan obtém um URL público, mede o tamanho total da página e audita a saúde de i18n e SEO da página. Produz um relatório com pontuação (0–100) que cobre atributos HTML, links canónicos, tags hreflang, robots.txt, sitemap.xml, links internos localizados e o peso de cada idioma no bundle JavaScript.

Não são necessárias dependências adicionais. Quando o puppeteer está instalado, o scan pode capturar partes de JavaScript carregadas dinamicamente (lazy-loaded) para uma análise de bundle mais precisa; caso contrário, recorre à inspeção dos scripts carregados diretamente declarados no HTML.

Utilização

npx intlayer scan <url>

Exemplo

npx intlayer scan https://example.com

Exemplo de saída:

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

Opções

<url> (obrigatório)

O URL completo a escanear (por exemplo, https://example.com).

--no-deep

Desativa o scan profundo baseado em renderização.

Por padrão, o comando tenta utilizar o puppeteer para renderizar a página num navegador headless, capturar as partes de JavaScript carregadas de forma diferida e medir o tamanho real de transferência. Se o puppeteer não estiver instalado, o comando recorre automaticamente ao modo básico.

Passe --no-deep para forçar o modo básico mesmo quando o puppeteer estiver disponível.

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

--json

Apresenta o resultado completo do scan como um objeto JSON em vez de um relatório formatado. Útil para consumo programático ou pipelines de CI.

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

Opções de configuração padrão

• --base-dir — Diretório base utilizado para localizar o ficheiro intlayer.config.*.
• -e, --env — Ambiente de destino (por exemplo, development, production).
• --env-file — Caminho para um ficheiro .env personalizado.
• --no-cache — Desativar cache de configuração.
• --verbose — Ativar logs detalhados (padrão no modo CLI).
• --prefix — Prefixo de log personalizado.

O que é verificado

A pontuação final é a soma ponderada de todas as verificações bem-sucedidas expressa em percentagem (0–100).

Utilização programática da função de scan

A função scan também é exportada a partir de @intlayer/cli para que possa ser chamada nos seus próprios scripts:

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

Para acesso de nível inferior, scanWebsite de @intlayer/chokidar/scan devolve um objeto ScanResult estruturado:

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