Repolode
open-wxa

open-wxa/wxa-runner

Executa mini programs do WeChat em um navegador comum usando a biblioteca base oficial do WeChat, com depuração pelo Chrome DevTools e testes E2E com Playwright.

Alternativa open source a:WeChat Developer Tools

Estrelas
246
Forks
21
Issues abertas
4
Último commit
há 8 horas

O que é?

wxa-runner executa diretamente em um navegador desktop o resultado compilado de mini programs do WeChat, incluindo projetos nativos e builds de uni-app ou Taro. A renderização, os componentes, o setData e os ciclos de vida usam a biblioteca base oficial do WeChat, em vez de uma reimplementação; por isso, o comportamento fica mais próximo do de um dispositivo real do que de uma versão H5 do app.

O principal uso é para depuração local e testes automatizados. É possível escrever testes com Playwright sem controlar o WeChat DevTools remotamente e executá-los em modo headless no Linux, em CI. Os desenvolvedores podem definir breakpoints, inspecionar requisições de rede e o DOM com o Chrome DevTools e acompanhar as alterações com hot reload.

A ferramenta não substitui o WeChat DevTools para pré-visualização, upload ou depuração em dispositivos reais. Também oferece hooks de configuração para predefinir o estado de login, simular APIs nativas e interceptar chamadas wx.request.

Recursos principais

  • 01Executa o resultado compilado de mini programs no navegador usando a biblioteca base oficial do WeChat.
  • 02É compatível com builds de projetos nativos, uni-app e Taro.
  • 03Permite executar testes E2E com Playwright em modo headless, sem o WeChat DevTools.
  • 04Permite depurar com o Chrome DevTools, usando breakpoints e inspecionando a rede e o DOM.
  • 05Oferece hot reload ao salvar.
  • 06Permite usar hooks de configuração para simular APIs nativas, interceptar wx.request e predefinir o login.

Casos de uso

  • Escrever testes E2E com Playwright para um mini program em CI no Linux.
  • Depurar a lógica das páginas e as chamadas de rede com as ferramentas de desenvolvedor do navegador durante o desenvolvimento.
  • Testar fluxos que precisam de login simulado ou respostas de backend substituídas por stubs.

Início rápido

  1. 1

    Execute o servidor de desenvolvimento no diretório compilado do miniprograma

    npx wxa-runner dev ./dist/dev/mp-weixin
  2. 2

    Abra no navegador o endereço local exibido no terminal

Antes de usar

  • Não substitui o WeChat Developer Tools; a ferramenta continua sendo necessária para pré-visualização, envio e depuração em um dispositivo real.
  • É baseado na biblioteca base oficial do WeChat, que não está coberta pela licença MIT do projeto.

Tópicos

Perguntas frequentes

O que é wxa-runner?
Executa mini programs do WeChat em um navegador comum usando a biblioteca base oficial do WeChat, com depuração pelo Chrome DevTools e testes E2E com Playwright. wxa-runner executa diretamente em um navegador desktop o resultado compilado de mini programs do WeChat, incluindo projetos nativos e builds de uni-app ou Taro. A renderização, os componentes, o setData e os ciclos de vida usam a biblioteca base oficial do WeChat, em vez de uma reimplementação; por isso, o comportamento fica mais próximo do de um dispositivo real do que de uma versão H5 do app.
wxa-runner é gratuito? Qual é a licença?
wxa-runner é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
wxa-runner ainda é mantido?
Manutenção ativa. O último commit de wxa-runner foi em 21 de out. de 2026.
Para que posso usar wxa-runner?
Escrever testes E2E com Playwright para um mini program em CI no Linux. Depurar a lógica das páginas e as chamadas de rede com as ferramentas de desenvolvedor do navegador durante o desenvolvimento. Testar fluxos que precisam de login simulado ou respostas de backend substituídas por stubs.
Como instalar wxa-runner?
Execute o servidor de desenvolvimento no diretório compilado do miniprograma: npx wxa-runner dev ./dist/dev/mp-weixin Abra no navegador o endereço local exibido no terminal
Onde consigo wxa-runner?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/open-wxa/wxa-runner

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

Projetos relacionados