Electron

Electron ist ein Framework zum Erstellen von Desktop-Anwendungen mit JavaScript, HTML und CSS. Durch die Einbettung von Chromium und Node.js in seine Binärdatei ermöglicht Electron die Pflege einer JavaScript-Codebasis und die Erstellung plattformübergreifender Apps, die auf Windows, macOS und Linux funktionieren - ohne dass Erfahrung in nativer Entwicklung erforderlich ist.

WebdriverIO bietet einen integrierten Service, der die Interaktion mit Ihrer Electron-App vereinfacht und das Testen sehr einfach macht. Die Vorteile der Verwendung von WebdriverIO zum Testen von Electron-Anwendungen sind:

• 🚗 automatisches Setup des erforderlichen Chromedrivers
• 📦 automatische Pfaderkennung Ihrer Electron-Anwendung - unterstützt Electron Forge und Electron Builder
• 🧩 Zugriff auf Electron-APIs innerhalb Ihrer Tests
• 🕵️ Mocking von Electron-APIs über eine Vitest-ähnliche API

Sie benötigen nur wenige einfache Schritte, um loszulegen. Schauen Sie sich dieses einfache Schritt-für-Schritt-Tutorial für Einsteiger vom WebdriverIO YouTube-Kanal an:

Oder folgen Sie der Anleitung im folgenden Abschnitt.

Erste Schritte

Um ein neues WebdriverIO-Projekt zu starten, führen Sie aus:

npm create wdio@latest ./

Ein Installationsassistent führt Sie durch den Prozess. Stellen Sie sicher, dass Sie "Desktop Testing - of Electron Applications" auswählen, wenn Sie gefragt werden, welche Art von Tests Sie durchführen möchten. Geben Sie anschließend den Pfad zu Ihrer kompilierten Electron-Anwendung an, z.B. ./dist, und behalten Sie dann die Standardeinstellungen bei oder passen Sie sie nach Ihren Wünschen an.

Der Konfigurationsassistent installiert alle erforderlichen Pakete und erstellt eine wdio.conf.js oder wdio.conf.ts mit der notwendigen Konfiguration zum Testen Ihrer Anwendung. Wenn Sie der automatischen Generierung einiger Testdateien zustimmen, können Sie Ihren ersten Test über npm run wdio ausführen.

Manuelle Einrichtung

Wenn Sie WebdriverIO bereits in Ihrem Projekt verwenden, können Sie den Installationsassistenten überspringen und einfach die folgenden Abhängigkeiten hinzufügen:

npm install --save-dev wdio-electron-service

Dann können Sie die folgende Konfiguration verwenden:

// wdio.conf.ts
export const config: WebdriverIO.Config = {
    // ...
    services: [['electron', {
        appEntryPoint: './path/to/bundled/electron/main.bundle.js',
        appArgs: [/** ... */],
    }]]
}

Das war's 🎉

Erfahren Sie mehr darüber, wie Sie den Electron Service konfigurieren, wie Sie Electron-APIs mocken und wie Sie auf Electron-APIs zugreifen.