Function parseUserAgent

packages/common/server/parser-user-agent.ts:243–288

(
  ua?: string | null,
  overrides?: Record<string, unknown>,
)

export type UserAgentInfo = ReturnType<typeof parseUserAgent>;
export type UserAgentResult = ReturnType<typeof parseUserAgent>;
export function parseUserAgent(
  ua?: string | null,
  overrides?: Record<string, unknown>,
) {
  if (!ua) return parsedServerUa;
  const res = parse(ua);

  if (isServer(res)) {
    return parsedServerUa;
  }

  const model =
    typeof overrides?.__model === 'string' && overrides?.__model
      ? overrides?.__model
      : res.device.model;

  return {
    os:
      typeof overrides?.__os === 'string' && overrides?.__os
        ? overrides?.__os
        : res.os.name,
    osVersion:
      typeof overrides?.__osVersion === 'string' && overrides?.__osVersion
        ? overrides?.__osVersion
        : res.os.version,
    browser:
      typeof overrides?.__browser === 'string' && overrides?.__browser
        ? overrides?.__browser
        : res.browser.name,
    browserVersion:
      typeof overrides?.__browserVersion === 'string' &&
      overrides?.__browserVersion
        ? overrides?.__browserVersion
        : res.browser.version,
    device:
      typeof overrides?.__device === 'string' && overrides?.__device
        ? overrides?.__device
        : res.device.type || getDevice(ua, model),
    brand:
      typeof overrides?.__brand === 'string' && overrides?.__brand
        ? overrides?.__brand
        : res.device.vendor,
    model,
    isServer: false,
  } as const;
}

function isServer(res: UAParser.IResult) {
  // Matches user agents like "Go-http-client/1.0" or "Go Http Client/1.0"