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.
Many of these checks are included as precommit hooks, so it's likely your error would be caught at commit time.
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.
The suite is driven by vitest: the vitest CLI runs under Node.js and starts several instances of the spec app, each of which runs one spec file at a time in Electron's main process. Suites that need the machine to themselves (window focus, the clipboard, the screen, global shortcuts) are declared with describe(title, { tags: ['serial'] }, fn) and run one at a time after everything else has finished. Set ELECTRON_SPEC_WORKERS to change how many Electron processes run at once.
To run only some spec files, pass them with --files: npm run test -- --files spec/api-app.spec.ts. To run only tests whose name matches a pattern, run npm run test -- -g=PATTERN, replacing PATTERN with a regex. Como un ejemplo: Si solo quiere correr pruebas IPC, usted debería correr npm run test -- -g ipc.
Specs import describe, it, expect and the hooks from vitest and assert with its matchers (expect(x).toBe(y), toEqual, toHaveProperty, ...); chai-style chains (expect(x).to.equal(y)) are rejected by the linter because their property form can silently assert nothing. A few Electron specific behaviours (a macrotask between tests, defer() cleanup, spec/disabled-tests.json) live in spec/vitest/runner.ts.
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:
-
Visual Studio 2019 debe estar instalado.
-
Las cabeceras de Node han de estar compiladas para tu configuración.
ninja -C out\Testing electron:node_headers -
El electron.lib ha de ser copiada como node.lib.
cd out\Testingmkdir gen\node_headers\Releasecopy 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:
- Presione la tecla Windows y busca Administrar herramientas opcionales.
- Haga clic en Añadir una herramienta.
- 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:
- Presione la tecla Windows y busca Ajustes de pantalla.
- Bajo Escalar y disposición, asegúrese de que el dispositivo está fijado al 100%.
Multi-Monitor Tests
Some Electron APIs require testing across multiple displays, such as screen detection, window positioning, and display-related events. For contributors working on these features, the virtualDisplay native addon enables you to create and position virtual displays programmatically, making it possible to test multi-monitor scenarios without any physical hardware.
For detailed information on using virtual displays in your tests, see Multi-Monitor Testing.
Platform support: macOS only