Repolode
open-wxa

open-wxa/wxa-runner

Ejecuta mini programas de WeChat en un navegador normal con la biblioteca base oficial de WeChat, depuración con Chrome DevTools y pruebas E2E con Playwright.

Alternativa open source a:WeChat Developer Tools

Estrellas
246
Forks
21
Issues abiertos
4
Último commit
hace 8 horas

¿Qué es?

wxa-runner ejecuta directamente en un navegador de escritorio el resultado compilado de mini programas de WeChat, incluidos proyectos nativos y compilaciones de uni-app o Taro. El renderizado, los componentes, setData y los ciclos de vida se ejecutan en la biblioteca base oficial de WeChat, en lugar de en una reimplementación, por lo que el comportamiento se aproxima más al de un dispositivo real que al de una versión H5 de la aplicación.

Su uso principal es la depuración local y las pruebas automatizadas. Las pruebas se pueden escribir con Playwright sin controlar WeChat DevTools de forma remota, y pueden ejecutarse en modo headless en Linux dentro de CI. Los desarrolladores pueden establecer puntos de interrupción, inspeccionar las solicitudes de red y el DOM con Chrome DevTools, y ver los cambios mediante recarga en caliente.

La herramienta no sustituye a WeChat DevTools para previsualizar, subir o depurar en un dispositivo real. También admite hooks de configuración para establecer de antemano el estado de inicio de sesión, simular APIs nativas e interceptar llamadas a wx.request.

Funciones clave

  • 01Ejecuta en el navegador el resultado compilado de mini programas con la biblioteca base oficial de WeChat.
  • 02Admite resultados de compilación de proyectos nativos, uni-app y Taro.
  • 03Permite ejecutar pruebas E2E con Playwright en modo headless y sin WeChat DevTools.
  • 04Permite depurar con Chrome DevTools, establecer puntos de interrupción e inspeccionar la red y el DOM.
  • 05Ofrece recarga en caliente al guardar.
  • 06Permite usar hooks de configuración para simular APIs nativas, interceptar wx.request y establecer de antemano el inicio de sesión.

Casos de uso

  • Escribir pruebas E2E con Playwright para un mini programa en CI sobre Linux.
  • Depurar la lógica de las páginas y las llamadas de red con las herramientas de desarrollo del navegador.
  • Probar flujos que requieren simular el inicio de sesión o usar respuestas simuladas del backend.

Inicio rápido

  1. 1

    Inicia el servidor de desarrollo en el directorio compilado del miniprograma

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

    Abre en el navegador la dirección local que aparece en el terminal

Antes de usarlo

  • No sustituye a WeChat Developer Tools; para previsualizar, subir y depurar en un dispositivo real, sigue siendo necesario.
  • Está basado en la biblioteca base oficial de WeChat, que no está cubierta por la licencia MIT del proyecto.

Temas

Preguntas frecuentes

¿Qué es wxa-runner?
Ejecuta mini programas de WeChat en un navegador normal con la biblioteca base oficial de WeChat, depuración con Chrome DevTools y pruebas E2E con Playwright. wxa-runner ejecuta directamente en un navegador de escritorio el resultado compilado de mini programas de WeChat, incluidos proyectos nativos y compilaciones de uni-app o Taro. El renderizado, los componentes, setData y los ciclos de vida se ejecutan en la biblioteca base oficial de WeChat, en lugar de en una reimplementación, por lo que el comportamiento se aproxima más al de un dispositivo real que al de una versión H5 de la aplicación.
¿wxa-runner es gratuito? ¿Qué licencia tiene?
wxa-runner es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿wxa-runner sigue mantenido?
Mantenimiento activo. El último commit de wxa-runner fue el 21 oct 2026.
¿Para qué puedo usar wxa-runner?
Escribir pruebas E2E con Playwright para un mini programa en CI sobre Linux. Depurar la lógica de las páginas y las llamadas de red con las herramientas de desarrollo del navegador. Probar flujos que requieren simular el inicio de sesión o usar respuestas simuladas del backend.
¿Cómo se instala wxa-runner?
Inicia el servidor de desarrollo en el directorio compilado del miniprograma: npx wxa-runner dev ./dist/dev/mp-weixin Abre en el navegador la dirección local que aparece en el terminal
¿Dónde consigo wxa-runner?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/open-wxa/wxa-runner

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados