Test improvements: - Capture titles for all macOS windows, not just the frontmost. - Incorporate missing application log files. - Improve log clarity with enriched context. - Improve application termination on macOS by reducing grace period. - Ensure complete application termination on macOS. - Validate Vue application loading through an initial log. - Support ignoring environment-specific `stderr` errors. - Do not fail the test if working directory cannot be deleted. - Use retry pattern when installing dependencies due to network errors. Refactorings: - Migrate the test code to TypeScript. - Replace deprecated `rmdir` with `rm` for error-resistant directory removal. - Improve sanity checking by shifting from App.vue to Vue bootstrapper. - Centralize environment variable management with `EnvironmentVariables` construct. - Rename infrastructure/Environment to RuntimeEnvironment for clarity. - Isolate WindowVariables and SystemOperations from RuntimeEnvironment. - Inject logging via preloader. - Correct mislabeled RuntimeSanity tests. Configuration: - Introduce `npm run check:desktop` for simplified execution. - Omit `console.log` override due to `nodeIntegration` restrictions and reveal logging functionality using context-bridging.
30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# check-desktop-runtime-errors
|
|
|
|
This script automates the processes of:
|
|
|
|
1) Building
|
|
2) Packaging
|
|
3) Installing
|
|
4) Executing
|
|
5) Verifying Electron distributions
|
|
|
|
It runs the application for a duration and detects runtime errors in the packaged application via:
|
|
|
|
- **Log verification**: Checking application logs for errors and validating successful application initialization.
|
|
- **`stderr` monitoring**: Continuous listening to the `stderr` stream for unexpected errors.
|
|
- **Window title inspection**: Checking for window titles that indicate crashes before logging becomes possible.
|
|
|
|
Upon error, the script captures a screenshot (if `--screenshot` is provided) and terminates.
|
|
|
|
## Options
|
|
|
|
- `--build`: Clears the electron distribution directory and forces a rebuild of the Electron app.
|
|
- `--screenshot`: Takes a screenshot of the desktop environment after running the application.
|
|
|
|
This module provides utilities for building, executing, and validating Electron desktop apps.
|
|
It can be used to automate checking for runtime errors during development.
|
|
|
|
## Configs
|
|
|
|
Configurations are defined in [`config.ts`](./config.ts).
|