Skip to content

The free and privacy-friendly screen recorder with no limits 🎥

1.7 KB
Raw Blame
// Decides whether screen/window capture uses getDisplayMedia instead of
// chrome.desktopCapture. macOS system audio only works via getDisplayMedia
// (Chrome 141+/macOS 14.2+); desktopCapture has no macOS system-audio backend.
// Core predicate is pure (unit-tested in tests/unit/).

export function parseChromeMajor(ua) {
  const m = (ua || "").match(/Chrom(?:e|ium)\/(\d+)/);
  return m ? parseInt(m[1], 10) : 0;
}

export function isMacUserAgent(ua) {
  return /Mac/i.test(ua || "");
}

// force = storage override (E2E tests / escape hatch); disabled = kill-switch.
export function screenCaptureUsesDisplayMedia({
  chromeMajor = 0,
  isMac = false,
  force = false,
  disabled = false,
} = {}) {
  if (force === true) return true;
  if (disabled === true) return false;
  return isMac === true && Number(chromeMajor) >= 141;
}

// Resolves platform/version from navigator + the forceDisplayMediaScreen /
// macSystemAudioCapture storage flags.
export function shouldUseDisplayMediaForScreen(settings = {}) {
  const ua =
    typeof navigator !== "undefined" && navigator.userAgent
      ? navigator.userAgent
      : "";
  return screenCaptureUsesDisplayMedia({
    chromeMajor: parseChromeMajor(ua),
    isMac: isMacUserAgent(ua),
    force: settings.forceDisplayMediaScreen === true,
    disabled: settings.macSystemAudioCapture === false,
  });
}

// Chrome's "Share this tab instead" button; on by default, with
// disableSurfaceSwitching as a storage kill-switch. Not gated on mac/systemAudio
// (crbug 344876285 is Won't Fix, and sysTrack.onended keeps the take alive).
// Region/crop never reaches here (cropTo is bound to the original tab).
export function screenSurfaceSwitching(settings = {}) {
  return settings.disableSurfaceSwitching === true ? "exclude" : "include";
}