@agent-infra/browser-finder
Advanced tools
A cross-platform browser path finder that helps you locate installed browsers on Windows, macOS, and Linux.
npm install @agent-infra/browser-finder
import { BrowserFinder } from '@agent-infra/browser-finder';
const finder = new BrowserFinder();
// Find any available browser (tries Chrome -> Edge -> Firefox)
const browser = finder.findBrowser();
console.log(browser.path); // "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
console.log(browser.type); // "chrome"
import { BrowserFinder } from '@agent-infra/browser-finder';
const finder = new BrowserFinder();
// Find Chrome specifically
const chrome = finder.findBrowser('chrome');
// Find Edge specifically
const edge = finder.findBrowser('edge');
// Find Firefox specifically
const firefox = finder.findBrowser('firefox');
import { BrowserFinder } from '@agent-infra/browser-finder';
const customLogger = {
info: (msg: string, ...args: any[]) => console.log(`INFO: \${msg}`, ...args),
warn: (msg: string, ...args: any[]) => console.warn(`WARN: \${msg}`, ...args),
error: (msg: string, ...args: any[]) =>
console.error(`ERROR: \${msg}`, ...args),
// ... other logger methods
};
const finder = new BrowserFinder(customLogger);
const browser = finder.findBrowser();
new BrowserFinder(logger?: Logger)
logger (optional): Custom logger instance. If not provided, uses the default logger.Finds a browser and returns its path and type.
Parameters:
name (optional): Specific browser to find ('chrome' | 'edge' | 'firefox')Returns:
{
path: string; // Full path to browser executable
type: BrowserType; // Browser type ('chrome' | 'edge' | 'firefox')
}
Examples:
// Find any browser (automatic fallback)
const anyBrowser = finder.findBrowser();
// Find specific browser
const chrome = finder.findBrowser('chrome');
const edge = finder.findBrowser('edge');
const firefox = finder.findBrowser('firefox');
The library throws descriptive errors when browsers cannot be found:
try {
const browser = finder.findBrowser('chrome');
} catch (error) {
if (error.name === 'ChromePathsError') {
console.log('Chrome not found on this system');
}
}
ChromePathsError - Chrome browser not foundEdgePathsError - Edge browser not found (from edge-paths package)FirefoxPathsError - Firefox browser not foundBrowserPathsError - No browser found when using automatic detectionThis library is optimized for fast browser detection:
lsregister -dump operations used by some other librarieswhich command for quick binary lookupwhich - Cross-platform executable finderedge-paths - Edge browser path detection@agent-infra/logger - Logging functionalityApache License 2.0.
Special thanks to the open source projects that inspired this toolkit:
See CHANGELOG.md for release history.
FAQs
find browser in your system
We found that @agent-infra/browser-finder demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 5 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
GitHub has revoked npm classic tokens for publishing; maintainers must migrate, but OpenJS warns OIDC trusted publishing still has risky gaps for critical projects.
Security News
Rust’s crates.io team is advancing an RFC to add a Security tab that surfaces RustSec vulnerability and unsoundness advisories directly on crate pages.
Security News
/Research
Socket found a Rust typosquat (finch-rust) that loads sha-rust to steal credentials, using impersonation and an unpinned dependency to auto-deliver updates.