Débogage et tests Electron

Les applications Electron impliquentle processus principal et le processus de rendudeux environnements d'exécution, donc des stratégies de débogage et de test doivent être conçues pour différents processus.
De bons processus de débogage et de test peuvent améliorer l'efficacité du développement et la stabilité des applications.


Débogage du processus principal

Débogage avec Chrome DevTools

  • Le processus principal d'Electron est accessible via--inspectou--inspect-brkLancer et déboguer avec Chrome DevTools.
  • Exemple de lancement :

    electron --inspect=9222 .
  • Saisir dans la barre d'adresse de Chromechrome://inspect, qui se connecte au processus principal pour le débogage avec points d'arrêt, la visualisation des piles d'appels et l'exécution d'expressions.

Débogage avec points d'arrêt dans VS Code

  • Configurer dans VS Codelaunch.json:

    {
      "type": "node",
      "request": "launch",
      "name": "Electron Main",
      "program": "${workspaceFolder}/node_modules/electron/cli.js",
      "args": ["."],
      "runtimeExecutable": null,
      "windows": { "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron.cmd" },
      "sourceMaps": true,
      "protocol": "inspector"
    }
  • Cela vous permet de définir des points d'arrêt directement dans les fichiers du processus principal, de déboguer la logique et la communication IPC.

Journalisation

  • Utilisationconsole.logou des bibliothèques de journalisation tierces (par ex.winstonEnregistrer les informations d'exécution du processus principal.
  • Catégories de journal recommandées : info, warn, error, pour faciliter le dépannage des problèmes.

Déboguer le processus de rendu.

Ouvrir les outils de développement.

  • Appeler dans le processus de rendu :

    mainWindow.webContents.openDevTools()
  • Vous pouvez directement consulter le DOM, le débogage JS, les requêtes réseau et les panneaux de performance.

Débogage à distance

  • Le processus de rendu peut également activer un port de débogage à distance :

    electron --remote-debugging-port=9223 .
  • Vous pouvez vous connecter au débogage à distance dans Chrome DevTools, adapté au débogage multi-fenêtres ou multi-appareils.

React / Vue DevTools

  • Pour les processus de rendu utilisant des frameworks frontend, installez les DevTools correspondants :

    npm install --save-dev electron-devtools-installer
  • Exemple :

    const { default: installExtension, REACT_DEVELOPER_TOOLS } = require('electron-devtools-installer')
    
    app.whenReady().then(() => {
      installExtension(REACT_DEVELOPER_TOOLS)
        .then(name => console.log(`已安装: ${name}`))
        .catch(err => console.log('安装失败:', err))
    })
  • Vous pouvez déboguer l’état, les props et les événements des composants, ce qui améliore l’efficacité du développement frontend.

Tests automatisés

Framework de tests Spectron

  • Spectron est l’outil de test de bout en bout officiellement recommandé pour Electron, basé sur WebDriver.
  • Vous pouvez tester le démarrage de l’application, le comportement des fenêtres, les clics sur les boutons et les appels IPC.
    npm install --save-dev spectron mocha chai
  • Exemple :

    const Application = require('spectron').Application
    const assert = require('chai').assert
    const path = require('path')
    
    describe('应用启动测试', function () {
      this.timeout(10000)
      let app
    
      before(async () => {
        app = new Application({
          path: require('electron'), // Electron 可执行文件
          args: [path.join(__dirname, '..')]
        })
        await app.start()
      })
    
      after(async () => { if (app && app.isRunning()) await app.stop() })
    
      it('窗口数量应为 1', async () => {
        const count = await app.client.getWindowCount()
        assert.equal(count, 1)
      })
    })

Tests unitaires

  • Vous pouvez écrire des tests unitaires pour la logique du processus principal et les modules du processus de rendu.
  • Il est recommandé d'utiliser Jest ou Mocha + Chai :npm install --save-dev jest

Tests de bout en bout

  • Tester les flux d'opérations utilisateur, notamment le bon fonctionnement des clics sur les boutons, de l'ouverture de nouvelles fenêtres et des interactions avec les données.
  • Peut être combiné avec Spectron ou Playwright + Electron.

Intégration CI/CD

Configurer les tests Electron dans les plateformes d'intégration continue (GitHub Actions, GitLab CI) :

  • Installer Node.js + Electron
  • Exécuter les tests unitaires et les tests de bout en bout
  • Générer des rapports de couverture et les téléverser

Résumé

Points clés du débogage et des tests Electron :

  • processus principal: Chrome DevTools ou débogage avec points d'arrêt dans VS Code + journaux
  • Processus de rendu: outils de développement + DevTools du framework frontend
  • Tests automatisés: Spectron, tests unitaires, tests de bout en bout + CI/CD
  • Objectif: Améliorer l'efficacité de développement, découvrir les problèmes potentiels, garantir la stabilité de l'application
autres extensions