Informações gerais

O Lighthouse é uma ferramenta automatizada de código aberto que melhora a qualidade das páginas da Web. Você pode executá-lo em qualquer página da Web, pública ou que exige autenticação. Ele conta com auditorias de desempenho, acessibilidade, Progressive Web Apps, SEO e muito mais.

Logotipo da Lighthouse

É possível executar o Lighthouse no Chrome DevTools usando a linha de comando ou como um módulo do Node. Você fornece ao Lighthouse um URL para auditoria, ele executa uma série de auditorias na página e gera um relatório sobre o desempenho dela. A partir daí, use as auditorias com falha como indicadores de como melhorar a página. Cada auditoria tem um documento de referência que explica por que ela é importante e como corrigi-la.

Também é possível usar o Lighthouse CI para evitar regressões nos seus sites.

Assista ao vídeo abaixo do Google I/O para saber mais sobre como usar e contribuir com o Lighthouse.

Primeiros passos

Escolha o fluxo de trabalho do Lighthouse mais adequado para você:

Executar o Lighthouse no Chrome DevTools

O Lighthouse tem seu próprio painel no Chrome DevTools. Para executar um relatório:

  1. Faça o download do Google Chrome para computador.
  2. No Google Chrome, acesse o URL que você quer auditar. É possível auditar qualquer URL na Web.
  3. Abra o Chrome DevTools.
  4. Clique na guia Lighthouse.

    O painel Lighthouse do Chrome DevTools
    À esquerda, está a janela de visualização da página que será auditada. À direita está o painel Lighthouse do Chrome DevTools, que usa a tecnologia do Lighthouse.

  5. Clique em Analisar o carregamento de página. O DevTools mostra uma lista de categorias de auditoria. Deixe todas ativadas.

  6. Clique em Executar auditoria. Depois de 30 a 60 segundos, o Lighthouse gera um relatório na página.

    Um relatório do Lighthouse no Chrome DevTools
    Um relatório do Lighthouse no Chrome DevTools

Instalar e executar a ferramenta de linha de comando do Node

Para instalar o módulo Node:

  1. Faça o download do Google Chrome para computador.
  2. Instale a versão atual do Node com Suporte de longo prazo.
  3. Instale o Lighthouse. A sinalização -g o instala como um módulo global.
npm install -g lighthouse

Para fazer uma auditoria:

lighthouse <url>

Para ver todas as opções, faça o seguinte:

lighthouse --help

Executar o módulo Node de maneira programática

Consulte Como usar programaticamente para ver um exemplo de como executar o Lighthouse de maneira programática, como um módulo de nó.

Executar o PageSpeed Insights

Para executar o Lighthouse no PageSpeed Insights:

  1. Acesse PageSpeed Insights.
  2. Insira um URL de página da Web.
  3. Clique em Analyze.

    Interface do PageSpeed Insights
    A interface do PageSpeed Insights

Executar o Lighthouse como uma extensão do Chrome

Para instalar a extensão, faça o seguinte:

  1. Faça o download do Google Chrome para computador.
  2. Instale a extensão do Chrome do Lighthouse na Chrome Web Store.

Para fazer uma auditoria:

  1. No Chrome, acesse a página que você quer auditar.
  2. Clique no Lighthouse Extensão do Lighthouse icion. Ele deve estar ao lado da barra de endereço do Chrome. Caso contrário, abra o menu de extensões do Chrome e acesse-o a partir desse local. Depois de clicar, o menu do Lighthouse se expande.

    Extensão do Lighthouse
    Painel de extensão do Lighthouse

  3. Clique em Gerar relatório. O Lighthouse realiza as auditorias na página atualmente em foco e abre uma nova guia com um relatório dos resultados.

    Relatório de extensões do Lighthouse
    Um relatório do Lighthouse da extensão

Compartilhar e visualizar relatórios on-line

Use o Lighthouse Viewer para acessar e compartilhar relatórios on-line.

Leitor do Lighthouse
Leitor do Lighthouse

Compartilhar relatórios como JSON

O Visualizador do Lighthouse precisa da saída JSON de um relatório do Lighthouse. A lista abaixo explica como conseguir a saída JSON, dependendo do fluxo de trabalho do Lighthouse usado:

  • Relatório do Lighthouse. Abra o menu Ícone de menu no canto superior direito e clique em Botão &quot;Salvar como JSON&quot; Salvar como JSON.
  • Linha de comando. Executar: shell lighthouse --output json --output-path <path/for/output.json>

Para visualizar os dados do relatório:

  1. Abra o Lighthouse Viewer.
  2. Arraste o arquivo JSON para o visualizador ou clique em qualquer lugar no Visualizador para abrir o navegador de arquivos e selecionar o arquivo.

Compartilhar relatórios como Gists do GitHub

Se você não quiser transmitir manualmente arquivos JSON, também poderá compartilhar seus relatórios como essências secretas do GitHub. Um benefício do gist é o controle de versão sem custo financeiro.

Para exportar um relatório como uma síntese dele, faça o seguinte:

  1. (Se você já estiver no visualizador, pule esta etapa) Abra o menu Ícone de menu no canto superior direito e clique em Botão &quot;Abrir no visualizador&quot; Abrir no visualizador. O relatório é aberto no visualizador, localizado em https://googlechrome.github.io/lighthouse/viewer/.
  2. No visualizador, abra o menu Ícone de menu no canto superior direito e clique em Botão &quot;Abrir no visualizador&quot; Save as Gist. Na primeira vez que você fizer isso, um pop-up solicitará permissão para acessar seus dados básicos do GitHub e ler e gravar nos seus elementos.

Para exportar um relatório como gist da versão da CLI do Lighthouse, crie um gist manualmente e copie e cole a saída JSON do relatório no gist. O nome de arquivo gist que contém a saída JSON precisa terminar com .lighthouse.report.json. Consulte Compartilhar relatórios como JSON para ver um exemplo de como gerar uma saída JSON a partir da ferramenta de linha de comando.

Para conferir um relatório que foi salvo como gist, siga estas etapas:

  • Adicione ?gist=<ID> ao URL do visualizador, em que <ID> é o ID da gist. text https://googlechrome.github.io/lighthouse/viewer/?gist=<ID>
  • Abra o Viewer e cole o URL de um gist nele.

Extensibilidade do Lighthouse

O objetivo do Lighthouse é fornecer orientações relevantes e acionáveis para todos os desenvolvedores web. Para isso, há dois recursos disponíveis que permitem personalizar o Lighthouse de acordo com suas necessidades.

Empilhamento

Os desenvolvedores usam muitas tecnologias diferentes (frameworks de back-end/CMS/JavaScript) para criar páginas da Web. Em vez de mostrar apenas recomendações gerais, agora o Lighthouse pode oferecer recomendações mais relevantes e úteis, dependendo das ferramentas usadas.

Com os "Pacotes de pilha", o Lighthouse detecta em qual plataforma seu site foi criado e exibe recomendações específicas com base na pilha. Essas recomendações são definidas e selecionadas por especialistas da comunidade.

Para contribuir com um pacote de pilha, leia as Diretrizes de contribuição.

Plug-ins do Lighthouse

Com os plug-ins do Lighthouse, os especialistas em domínio podem ampliar a funcionalidade do Lighthouse para atender às necessidades específicas da comunidade. Agora você pode aproveitar os dados que o Lighthouse coleta para criar novas auditorias. Basicamente, o plug-in do Lighthouse é um módulo de nó que implementa um conjunto de verificações que serão executadas pelo Lighthouse e adicionadas ao relatório como uma nova categoria.

Para mais informações sobre como criar seu próprio plug-in, consulte nosso Manual de plug-in (em inglês) no repositório do Lighthouse no GitHub.

Integrar o Lighthouse

Se você representa uma empresa ou um indivíduo que está integrando o Lighthouse como parte dos produtos / serviços que oferece, primeiro o mais importante. Estamos muito felizes por você! Queremos que o maior número possível de pessoas use o Lighthouse, e as Diretrizes e recursos da marca para integração do Lighthouse têm como objetivo facilitar a demonstração de que o Lighthouse é fundamental e protege nossa marca.

Contribuir com o Lighthouse

O Lighthouse é de código aberto, e contribuições são bem-vindas. Confira o Issue Tracker do repositório para encontrar bugs que podem ser corrigidos ou auditorias que podem ser criadas ou melhoradas. Ele também é um bom lugar para discutir métricas de desempenho, ideias para novas auditorias ou qualquer outro assunto relacionado ao Lighthouse.