Add Electron test runner

- add Node/Electron test runner scripts with runtime version logging
- update npm scripts and .npmignore to use new runners
- run Electron tests on Ubuntu CI (AppArmor tweak + xvfb)
- clarify README testing section for Node vs Electron suites

Author: mathiask88

.github/workflows/test.yml

@@ -30,6 +30,17 @@ jobs:
 
       - name: Install
         run: npm install
-        
+
       - name: Test
         run: npm test
+
+      # https://github.com/electron/electron/issues/42510#issuecomment-2171583086
+      - name: Disable AppArmor restriction
+        if: matrix.os == 'ubuntu-latest'
+        run: sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
+
+      - name: Test Electron
+        if: matrix.os == 'ubuntu-latest' && matrix.node == '18'
+        uses: GabrielBB/xvfb-action@v1
+        with:
+          run: npm run test-electron

.npmignore

@@ -1,6 +1,7 @@
 .github/
 .vscode/
 test/
+scripts/
 build/
 .clang-format
 .gitignore

README.md

@@ -127,6 +127,11 @@ s7server.on('readWrite', (sender, operation, tag, buffer, done) => {
 s7server.StartTo('127.0.0.1');
 ```
 
+## Testing
+- Run Node.js tests (Node runtime): `npm test`
+- Run the same suite inside Electron's Node runtime: `npm run test-electron`  
+  On headless CI, wrap with `xvfb-run npm run test-electron`.
+
 ## License & copyright
 Copyright (c) 2025, Mathias Küsel
 

package.json

@@ -38,6 +38,7 @@
     "node-gyp-build": "~4.8.4"
   },
   "devDependencies": {
+    "electron": "^30.0.0",
     "node-addon-api": "~8.5.0",
     "node-gyp": "^12.1.0",
     "prebuildify": "^6.0.1",
@@ -48,7 +49,8 @@
     "install": "node-gyp-build",
     "rebuild": "npm run install --build-from-source",
     "prebuild": "prebuildify -t 18.20.8 --napi --strip",
-    "test": "node --test --test-concurrency=1",
+    "test": "node ./scripts/run-node-tests.js",
+    "test-electron": "node ./scripts/run-electron-tests.js",
     "download-prebuilds": "prebuildify-ci download",
     "prebuild-linux-arm": "prebuildify-cross -i linux-armv6 -i linux-armv7 -i linux-arm64-lts -t 18.20.8 --napi --strip",
     "prebuild-android-arm": "prebuildify-cross -i android-armv7 -i android-arm64 -t 18.20.8 --napi --strip",

scripts/run-electron-tests.js

@@ -0,0 +1,56 @@
+const { spawn, spawnSync } = require('child_process');
+const electronBinary = require('electron');
+const os = require('os');
+
+function getElectronProcessVersions() {
+  try {
+    const result = spawnSync(
+      electronBinary,
+      ['-e', 'console.log(JSON.stringify(process.versions))'],
+      {
+        env: { ...process.env, ELECTRON_RUN_AS_NODE: '1' },
+        encoding: 'utf8'
+      }
+    );
+    if (result.status === 0 && result.stdout) {
+      return JSON.parse(result.stdout.trim());
+    }
+  } catch {
+    // ignore and fall back to empty object
+  }
+  return {};
+}
+
+const electronVersions = getElectronProcessVersions();
+const electronNode = electronVersions.node || 'unknown';
+const electronChrome = electronVersions.chrome || 'unknown';
+const electronV8 = electronVersions.v8 || 'unknown';
+const electronNapi = electronVersions.napi || 'unknown';
+const electronVersion = electronVersions.electron || 'unknown';
+
+console.log(
+  `[electron-tests] electron ${electronVersion} (node ${electronNode}, chrome ${electronChrome}, v8 ${electronV8}, napi ${electronNapi}); runner node ${process.version} (v8 ${process.versions.v8}, napi ${process.versions.napi})${os.EOL}`
+);
+
+// Use Electron's embedded Node to run the Node.js test runner on the collected files.
+// Keep concurrency at 1 to avoid port collisions in integration tests.
+const child = spawn(
+  electronBinary,
+  ['--test', '--test-concurrency=1'],
+  {
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      ELECTRON_RUN_AS_NODE: '1'
+    }
+  }
+);
+
+child.on('exit', code => {
+  process.exit(code);
+});
+
+child.on('error', err => {
+  console.error('Failed to start Electron for tests:', err);
+  process.exit(1);
+});

scripts/run-node-tests.js

@@ -0,0 +1,24 @@
+const { spawn } = require('child_process');
+const os = require('os');
+
+console.log(
+  `[node-tests] node ${process.version} (v8 ${process.versions.v8}, napi ${process.versions.napi})${os.EOL}`
+);
+
+const child = spawn(
+  process.execPath,
+  ['--test', '--test-concurrency=1'],
+  {
+    stdio: 'inherit',
+    env: process.env
+  }
+);
+
+child.on('exit', code => {
+  process.exit(code);
+});
+
+child.on('error', err => {
+  console.error('Failed to start Node tests:', err);
+  process.exit(1);
+});