undergroundwires/privacy.sexy

View on GitHub
src/infrastructure/RuntimeEnvironment/Browser/BrowserOs/BrowserConditions.ts

Summary

Maintainability
A
0 mins
Test Coverage
import { OperatingSystem } from '@/domain/OperatingSystem';
import { type BrowserCondition, TouchSupportExpectation } from './BrowserCondition';

// They include "Android", "iPhone" in their user agents.
const WindowsMobileIdentifiers: readonly string[] = [
  'Windows Phone',
  'Windows Mobile',
] as const;

export const BrowserConditions: readonly BrowserCondition[] = [
  {
    operatingSystem: OperatingSystem.KaiOS,
    existingPartsInSameUserAgent: ['KAIOS'],
  },
  {
    operatingSystem: OperatingSystem.ChromeOS,
    existingPartsInSameUserAgent: ['CrOS'],
  },
  {
    operatingSystem: OperatingSystem.BlackBerryOS,
    existingPartsInSameUserAgent: ['BlackBerry'],
  },
  {
    operatingSystem: OperatingSystem.BlackBerryTabletOS,
    existingPartsInSameUserAgent: ['RIM Tablet OS'],
  },
  {
    operatingSystem: OperatingSystem.BlackBerry10,
    existingPartsInSameUserAgent: ['BB10'],
  },
  {
    operatingSystem: OperatingSystem.Android,
    existingPartsInSameUserAgent: ['Android'],
    notExistingPartsInUserAgent: [...WindowsMobileIdentifiers],
  },
  {
    operatingSystem: OperatingSystem.Android,
    existingPartsInSameUserAgent: ['Adr'],
    notExistingPartsInUserAgent: [...WindowsMobileIdentifiers],
  },
  {
    operatingSystem: OperatingSystem.iOS,
    existingPartsInSameUserAgent: ['iPhone'],
    notExistingPartsInUserAgent: [...WindowsMobileIdentifiers],
  },
  {
    operatingSystem: OperatingSystem.iOS,
    existingPartsInSameUserAgent: ['iPod'],
  },
  {
    operatingSystem: OperatingSystem.iPadOS,
    existingPartsInSameUserAgent: ['iPad'],
    // On Safari, only for older iPads running ≤ iOS 12 reports `iPad`
    // Other browsers report `iPad` both for older devices (≤ iOS 12) and newer (≥ iPadOS 13)
    // We detect all as `iPadOS` for simplicity.
  },
  {
    operatingSystem: OperatingSystem.iPadOS,
    existingPartsInSameUserAgent: ['Macintosh'], // Reported by Safari on iPads running ≥ iPadOS 13
    notExistingPartsInUserAgent: ['Electron'], // Electron supports only macOS, not iPadOS
    touchSupport: TouchSupportExpectation.MustExist, // Safari same user agent as desktop macOS
  },
  {
    operatingSystem: OperatingSystem.Linux,
    existingPartsInSameUserAgent: ['Linux'],
    notExistingPartsInUserAgent: ['Android', 'Adr'],
  },
  {
    operatingSystem: OperatingSystem.Windows,
    existingPartsInSameUserAgent: ['Windows'],
    notExistingPartsInUserAgent: [...WindowsMobileIdentifiers],
  },
  ...['Windows Phone OS', 'Windows Phone 8'].map((userAgentPart) => ({
    operatingSystem: OperatingSystem.WindowsPhone,
    existingPartsInSameUserAgent: [userAgentPart],
  })),
  ...['Windows Mobile', 'Windows Phone 10'].map((userAgentPart) => ({
    operatingSystem: OperatingSystem.Windows10Mobile,
    existingPartsInSameUserAgent: [userAgentPart],
  })),
  {
    operatingSystem: OperatingSystem.macOS,
    existingPartsInSameUserAgent: ['Macintosh'],
    notExistingPartsInUserAgent: ['like Mac OS X'], // Eliminate iOS and iPadOS for Safari
    touchSupport: TouchSupportExpectation.MustNotExist, // Distinguish from iPadOS for Safari
  },
  ...generateJsdomBrowserConditions(),
] as const;

function generateJsdomBrowserConditions(): readonly BrowserCondition[] {
  // jsdom user agent format: `Mozilla/5.0 (${process.platform || "unknown OS"}) ...` (https://archive.ph/2023.02.14-193200/https://github.com/jsdom/jsdom#advanced-configuration)
  const operatingSystemPlatformMap: Partial<Record<
  OperatingSystem,
  NodeJS.Platform> // Enforce right platform constants at compile time
  > = {
    [OperatingSystem.Linux]: 'linux',
    [OperatingSystem.Windows]: 'win32',
    [OperatingSystem.macOS]: 'darwin',
  } as const;
  return Object
    .entries(operatingSystemPlatformMap)
    .map(([operatingSystemKey, platformString]): BrowserCondition => ({
      operatingSystem: Number(operatingSystemKey),
      existingPartsInSameUserAgent: ['jsdom', platformString],
    }));
}