Midscene.js é um framework de testes E2E baseado em visão que permite escrever etapas e verificações de UI em linguagem natural para apps web, mobile e desktop.
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
Execute o servidor de desenvolvimento no diretório compilado do miniprograma
npx wxa-runner dev ./dist/dev/mp-weixin - 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
Framework de testes end-to-end para apps web e mobile que permite descrever objetivos em linguagem natural e controlar o app com um agente.
Uma solução aberta e multiplataforma, compatível com vários frameworks, para criar um único app que roda em mini programs do WeChat, Alipay e outras plataformas, na web H5 e no React Native com React ou Vue.
Playwright é um framework para testes e automação web que controla Chromium, Firefox e WebKit por meio de uma única API.
Agente de testes de IA open source que transforma arquivos de feature Gherkin em testes automatizados de ponta a ponta para navegador, API, segurança, acessibilidade e validação visual.
App gratuito e de código aberto para macOS que exibe emuladores Android, celulares Android, simuladores iOS e iPhones lado a lado para espelhamento, controle e ajustes de configurações.