![\"Firefox\"](\"https://cdn.jsdelivr.net/gh/extension-js/media@db5deb23fbfa85530f8146718812972998e13a4d/browser_logos/svg/firefox.svg\")
\n\n- By default checks only `stable`. Optionally can cascade to `esr` / `developer edition` / `nightly`.\n- Supports macOS / Windows / Linux\n- Works both as an ES module or CommonJS\n\n## Installation\n\n```bash\nnpm i firefox-location2\n```\n\n## Usage\n\n**Via Node.js (strict by default):**\n\n```js\nimport firefoxLocation from 'firefox-location2'\nimport {getFirefoxVersion} from 'firefox-location2'\n\n// Strict (Stable only)\nconsole.log(firefoxLocation())\n// => \"/Applications/Firefox.app/Contents/MacOS/firefox\" or null\n\n// Enable fallback (Stable / ESR / Developer Edition / Nightly)\nconsole.log(firefoxLocation(true))\n// => first found among Stable/ESR/Developer/Nightly or null\n\n// Throw with an install guide when not found\nimport {locateFirefoxOrExplain, getInstallGuidance} from 'firefox-location2'\ntry {\n const path = locateFirefoxOrExplain({allowFallback: true})\n console.log(path)\n\n // Cross-platform version (no exec by default)\n const v = getFirefoxVersion(path)\n console.log(v) // e.g. \"130.0.1\" or null\n\n // Opt-in: allow executing the binary to fetch version on platforms without metadata (e.g. Linux)\n const v2 = getFirefoxVersion(path, {allowExec: true})\n console.log(v2)\n} catch (e) {\n console.error(String(e))\n // Or print getInstallGuidance() explicitly\n}\n```\n\n**CommonJS:**\n\n```js\nconst api = require('firefox-location2')\nconst locateFirefox = api.default || api\n```\n\n**Via CLI:**\n\n```bash\nnpx firefox-location2\n# Strict (Stable only)\n\nnpx firefox-location2 --fallback\n# Enable cascade (Stable / ESR / Developer / Nightly)\n\n# Output is colorized when printed to a TTY\n\n# Respect Puppeteer cache (after you install once):\nnpx @puppeteer/browsers install firefox@stable\nnpx firefox-location2\n```\n\n### Environment overrides\n\nIf this environment variable is set and points to an existing binary, it takes precedence:\n\n- `FIREFOX_BINARY`\n\nExit behavior:\n\n- Prints the resolved path on success\n- Exits with code 1 and prints a guidance message if nothing suitable is found\n\nNotes:\n\n- Output is colorized when printed to a TTY (green success, red error)\n- After you run `npx @puppeteer/browsers install firefox@stable` once, we auto-detect Firefox from Puppeteer's cache on all platforms. No env vars needed.\n\n## Support table\n\nBy default, only the Stable channel is checked. When fallback is enabled, ESR, Developer Edition, and Nightly are also checked (in that order) and the first existing path is returned.\n\nDefault locations checked per platform and channel
\n\n| Platform | \nChannel | \nPaths checked | \n
|---|---|---|
![\"\"](\"https://cdn.jsdelivr.net/gh/extension-js/media@db5deb23fbfa85530f8146718812972998e13a4d/platform_logos/macos.png\") macOS | \n Firefox (Stable) | \n\n
| \n
| Firefox ESR | \n\n
| \n |
| Firefox Developer Edition | \n\n
| \n |
| Firefox Nightly | \n\n
| \n |
![\"\"](\"https://cdn.jsdelivr.net/gh/extension-js/media@db5deb23fbfa85530f8146718812972998e13a4d/platform_logos/windows.png\") Windows | \n Firefox (Stable) | \n\n
| \n
| Firefox ESR | \n\n
| \n |
| Firefox Developer Edition | \n\n
| \n |
| Firefox Nightly | \n\n
| \n |
![\"\"](\"https://cdn.jsdelivr.net/gh/extension-js/media@db5deb23fbfa85530f8146718812972998e13a4d/platform_logos/linux.png\") Linux/other | \n Firefox (Stable) | \n\n
| \n
| Firefox ESR | \n\n
| \n |
| Firefox Developer Edition | \n\n
| \n |
| Firefox Nightly | \n\n
| \n |
| Common locations | \n\n
| \n