fx-runner is a Node.js command-line interface (CLI) tool developed by Mozilla, designed to control and interact with Firefox browsers programmatically from the terminal. It simplifies tasks such as launching Firefox with specific profiles, passing arguments directly to the browser binary, and managing browser instances for testing or automation purposes. The project is actively maintained, with the latest stable version being 1.4.0, released in January 2024. Releases appear to be ad-hoc, driven by bug fixes and minor feature additions rather than a fixed cadence. Unlike full-fledged browser automation libraries (like Puppeteer or Playwright), `fx-runner` focuses purely on direct CLI interaction, making it particularly suitable for scripting environments, shell-based workflows, and scenarios where a lightweight, non-programmatic JavaScript control is preferred. Its primary differentiator is this direct command-line control over the Firefox binary and its associated profiles.
npm install fx-runnerNo compatibility data collected yet for this library.
Demonstrates how to execute the `fx-runner` CLI using Node.js's `child_process.spawn` to launch Firefox with a custom profile and a specific URL.
Ensure that the `firefox` executable is correctly located in your system's PATH or explicitly specify the full path to the `firefox` binary using the `--binary <path>` option.
Upgrade to `fx-runner` version 1.0.11 or newer to ensure that `lodash` vulnerabilities (specifically those addressed in lodash versions >=4.17.10) are mitigated.
Update to at least `fx-runner` version 1.1.0 (for Windows fixes) or 1.0.13 (for macOS fixes) to benefit from improved Firefox discovery logic. If issues persist, explicitly provide the Firefox binary path and profile path using `--binary` and `--profile` options.
Upgrade `fx-runner` to the latest version. If using a custom Firefox installation, verify that the `firefox` executable is available or explicitly specify its path using the `--binary` option, e.g., `fx-runner start --binary /Applications/Firefox.app/Contents/MacOS/firefox`.
Ensure you provide a valid path or profile name. Example: `fx-runner start --profile /path/to/my/profile` or `fx-runner start --profile default`.
No dependency data recorded yet.