Saltar al contenido principal

Pruebas

Nuestro objetivo es mantener la cobertura de código de electrón alto. Pedimos que todas la solicitudes de extracción requeridas no solo pasen todas las pruebas existentes, lo ideal seria añadir nuevas pruebas para cubrir los cambios en el código y nuevos escenarios. Asegurando que capturamos muchas rutas de código y casos de uso de Electrón es posible asegurar que todas las aplicaciones tengan menos errores.

Este repositorio viene con reglas de borrado tanto para JavaScript como para C++ – así como pruebas de unidad e integración. Para aprender más sobre el estilo de código de Electron, por favor vea el documento coding-style.

Borrador​

Para asegurarte de que tus cambios cumplen con el estilo de codificación de Electron, ejecuta npm run lint, lo que ejecutará una variedad de comprobaciones de linting en tus cambios según las áreas del código que afecten.

Muchas de estas comprobaciones se incluyen como precommit hooks, por lo que es probable que cualquier error se detecte en el momento de confirmar los cambios.

Pruebas unitarias​

Si no estás usando build-tools, asegúrate de que el nombre que has configurado para tu construcción local de Electron sea uno de Testing, Release, Default, o que hayas establecido process.env.ELECTRON_OUT_DIR. Sin estos conjuntos, Electron fallará al realizar algunos pasos previos a la prueba.

Para ejecutar todas las pruebas de unidad, ejecute npm run test. Las pruebas de unidad son una aplicación de Electrón(¡sorpresa!) que puede encontrarse en la carpeta de spec. Tenga en cuenta que tiene su propio package.json y que sus dependencias por lo tanto no se definen en el nivel superior package.json.

Para correr solo pruebas especificas que coincidan con un patrón, corra npm run test -- -g=PATTERN, reempleazando el PATTERN con una expresión regular que coinciden con los test que le gustaría correr. Como un ejemplo: Si solo quiere correr pruebas IPC, usted debería correr npm run test -- -g ipc.

Pruebas preliminares de Node.js​

Si has realizado cambios que podrían afectar la forma en que Node.js se integra en Electron, tenemos un conjunto de pruebas que ejecuta todas las pruebas de Node.js utilizando la bifurcación personalizada de Node.js de Electron.

Para ejecutar todas las pruebas de Node.js:

$ node script/node-spec-runner.js

Para ejecutar una sola prueba de Node.js:

$ node script/node-spec-runner.js parallel/test-crypto-keygen

donde el argumento pasado al runner es la ruta al test en el árbol de código fuente de Node.js.

Probando en dispositivos Windows 10​

Pasos adicionales para ejecutar prueba unitaria:​

  1. Visual Studio 2019 debe estar instalado.

  2. Las cabeceras de Node han de estar compiladas para tu configuración.

    ninja -C out\Testing electron:node_headers

  3. El electron.lib ha de ser copiada como node.lib.

    cd out\Testing
    mkdir gen\node_headers\Release
    copy electron.lib gen\node_headers\Release\node.lib

Fuentes no encontradas​

Algunos dispositivos Windows 10 no se incluye la fuente Meiryo instalada, lo que puede causar que falle una prueba. Para instalar Meiryo:

  1. Presione la tecla Windows y busca Administrar herramientas opcionales.
  2. Haga clic en Añadir una herramienta.
  3. Seleccione Fuentes suplementarias japonesas y haga clic en Instalar.

Medidas de píxeles​

Algunas pruebas que dependen de medidas precisas a nivel de píxel pueden no funcionar correctamente en dispositivos con ajustes de pantalla Hi-DPI debido a errores de precisión de puntos flotantes. Para ejecutar correctamente estas pruebas, asegúrese de que el dispositivo está fijado para escalar el 100%.

Para configurar el escalamiento de pantalla:

  1. Presione la tecla Windows y busca Ajustes de pantalla.
  2. Bajo Escalar y disposición, asegúrese de que el dispositivo está fijado al 100%.