Repolode
HuolalaTech

HuolalaTech/page-spy-web

Cliente web de depuração remota que você pode hospedar por conta própria para visualizar logs do console e dados de páginas em dispositivos remotos, junto com os SDKs do PageSpy.

Estrelas
5,635
Forks
357
Issues abertas
53
Último commit
há 2 meses

O que é?

PageSpy é uma ferramenta de depuração remota para páginas web, apps React Native, mini programas e apps HarmonyOS. Os SDKs do lado do cliente encapsulam o console nativo e APIs relacionadas, serializam os argumentos e os enviam para um cliente de depuração, que os exibe em uma interface semelhante ao console do devtools local do navegador.

Este repositório contém o cliente web e o servidor desse sistema. Ele pode ser executado localmente com Node.js por meio do pacote @huolala-tech/page-spy-api ou implantado com Docker, que expõe o serviço na porta 6752. Os logs e dados são armazenados nos diretórios montados, permitindo manter o serviço na sua própria infraestrutura.

O projeto atende a situações em que não é possível usar o devtools local, como depurar dentro de um webview móvel, coordenar a reprodução de bugs entre regiões ou descobrir a causa de uma tela branca no dispositivo de um usuário final.

Recursos principais

  • 01Encapsula o console nativo e APIs relacionadas em SDKs para web, React Native, mini programas e HarmonyOS.
  • 02Exibe logs remotos em uma interface semelhante ao console do devtools local.
  • 03Permite implantação com Node.js via npm ou com Docker na porta 6752.
  • 04Mantém logs e dados no seu próprio servidor.

Casos de uso

  • Depurar uma página H5 ou um webview em um celular, onde é difícil usar o devtools local.
  • Ajudar alguém de uma equipe remota a reproduzir e analisar um bug entre regiões.
  • Investigar uma tela branca relatada no dispositivo de um usuário final.

Início rápido

  1. 1

    Instale o serviço de API globalmente com npm ou yarn

    npm install -g @huolala-tech/page-spy-api@latest
  2. 2

    Inicie o serviço no terminal

    page-spy-api
  3. 3

    Abra o cliente no navegador em localhost, na porta 6752

Antes de usar

  • A hospedagem própria exige que você execute um serviço Node.js ou contêiner Docker por conta própria.
  • A depuração remota exige adicionar o SDK do PageSpy correspondente à página ou ao app que será depurado.

Em coleções

Tópicos

Perguntas frequentes

O que é page-spy-web?
Cliente web de depuração remota que você pode hospedar por conta própria para visualizar logs do console e dados de páginas em dispositivos remotos, junto com os SDKs do PageSpy. PageSpy é uma ferramenta de depuração remota para páginas web, apps React Native, mini programas e apps HarmonyOS. Os SDKs do lado do cliente encapsulam o console nativo e APIs relacionadas, serializam os argumentos e os enviam para um cliente de depuração, que os exibe em uma interface semelhante ao console do devtools local do navegador.
page-spy-web é gratuito? Qual é a licença?
page-spy-web é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
page-spy-web ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de page-spy-web foi em 18 de set. de 2026.
Para que posso usar page-spy-web?
Depurar uma página H5 ou um webview em um celular, onde é difícil usar o devtools local. Ajudar alguém de uma equipe remota a reproduzir e analisar um bug entre regiões. Investigar uma tela branca relatada no dispositivo de um usuário final.
Como instalar page-spy-web?
Instale o serviço de API globalmente com npm ou yarn: npm install -g @huolala-tech/page-spy-api@latest Inicie o serviço no terminal: page-spy-api Abra o cliente no navegador em localhost, na porta 6752
Onde consigo page-spy-web?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/HuolalaTech/page-spy-web

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados