A Node.js package that retrieves the system’s currently configured default web browser. It works on macOS, Linux, and Windows and returns browser details such as the name and id, useful for applications that need to open links in the user’s preferred browser.
Project status
- Actively maintained: Updates continue into 2026 (last upstream push and newest update on 2026-02-02 for v5.5.0), indicating ongoing maintenance rather than dormancy.
- Update cadence: Recent changes are fairly paced, with v5.4.0 on 2025-11-15 (about 2.5 months before v5.5.0) and v5.3.0 on 2025-11-12 (just days before v5.4.0).
AI summary generated
Recent updates
v5.5.0
v5.5.0 improves Windows default browser detection by matching ProgIds that include hash-like suffixes (using dot and hyphen separators). It also changes how unknown ProgIds are handled during Windows parsing. The release notes mention both improvements.
v5.4.0
v5.4.0 updates the Windows browser detection logic to recognize additional Windows browser ProgIds. The release notes only mention broader Windows support, but the code diff shows concrete changes to the mapping of browser channels to browser IDs.
BreakingFeaturesv5.3.0
v5.3.0 adds detection support for Microsoft Edge Beta on Windows. The code change maps the Edge Beta ProgId to the browser name "Edge Beta" so existing default-browser resolution can recognize it.
Featuresv5.2.1
v5.2.1 makes a small Linux-specific change to the defaultBrowser() implementation. The documented intent is to fix getting the default browser on Linux (likely related to how xdg-mime output is handled).
v5.2.0
Release v5.2.0 primarily claims to reduce dependencies. The code changes remove the use of `execa` and `titleize` and replace them with Node built-ins (`child_process.execFile` and an inlined titleize implementation), along with a few dependency version bumps.
v5.1.0
Release v5.1.0 adds support for detecting Brave as the Windows default browser by mapping Brave ProgIds to the corresponding browser identifiers. The code change is localized to Windows ProgId parsing, with added test coverage for stable, beta, and nightly variants.
Featuresv5.0.0
v5.0.0 raises the supported Node.js version to 18 and updates the package metadata and dependency set. The release notes only mention the Node.js requirement, but the diff also shows a change to package exports, multiple dependency major bumps, and an updated TypeScript definition comment for the browser.id field.
Breakingv4.0.0
v4.0.0 raises the supported Node.js version and updates the implementation and dependency stack for determining the system default browser. The main functional change is on Linux, where browser detection now shells out to `xdg-mime` and formats the display name, instead of using `xdg-default-browser`.
Breakingv3.1.0
Release v3.1.0 updates the Windows default browser detection logic to improve the error message when an unknown browser ID is encountered. The only code change is in how the unknown ID is extracted and reported in the UnknownBrowserError.
v3.0.0
v3.0.0 makes the package incompatible with older Node.js runtimes and switches the module format to pure ESM. It also adds Windows support and includes TypeScript type definitions for improved developer experience.
BreakingFeatures