Approximates the current location of the Yandex browser across platforms.

yandex-location

• By default checks only stable. Optionally can cascade to beta.
• Supports macOS / Windows / Linux
• Works both as an ES module or CommonJS

Support table

This table lists the default locations where Yandex is typically installed for each supported platform and channel. By default, only the Stable channel is checked. When fallback is enabled, the package checks these paths (in order) and returns the first one found.

Returns the first existing path found (given selected channels), or null if none are found.

Usage

Via Node.js (strict by default):

import yandexLocation from "yandex-location";
import {
  locateYandexOrExplain,
  getInstallGuidance,
  getYandexVersion
} from "yandex-location";

// Strict (Stable only)
console.log(yandexLocation());
// => "/Applications/Yandex.app/Contents/MacOS/Yandex" or null

// Enable fallback (Stable / Beta)
console.log(yandexLocation(true));
// => first found among Stable/Beta or null

// Throw with a friendly guide when not found
try {
  const bin = locateYandexOrExplain({allowFallback: true});
  console.log(bin);

  // Cross-platform version (no exec by default)
  console.log(getYandexVersion(bin)); // e.g. "24.12.0.0" or null

  // Opt-in: allow executing the binary (Linux/other)
  console.log(getYandexVersion(bin, {allowExec: true}));
} catch (e) {
  console.error(String(e));
  // Or print getInstallGuidance() explicitly
}

Via CLI:

npx yandex-location
# Strict (Stable only)

npx yandex-location --fallback
# Enable cascade (Stable / Beta)

# Respect environment overrides
YANDEX_BINARY=/custom/path/to/yandex npx yandex-location

# Print browser version (empty + exit code 2 if unavailable)
npx yandex-location --yandex-version
npx yandex-location --browser-version

# Opt-in: allow executing the binary to fetch version
npx yandex-location --browser-version --allow-exec

Environment overrides

If this environment variable is set and points to an existing binary, it takes precedence:

• YANDEX_BINARY

API

• default export locateYandex(allowFallback?: boolean): string | null
• locateYandexOrExplain(options?: boolean | { allowFallback?: boolean }): string
• getYandexVersion(bin: string, opts?: { allowExec?: boolean }): string | null
• getInstallGuidance(): string

Related projects

• brave-location
• chrome-location2
• edge-location
• firefox-location2
• opera-location
• vivaldi-location

License

MIT (c) Cezar Augusto.