Karma Chrome Launcher

// The package exports Karma DI modules, typically used via Karma configuration
const karmaChromeLauncher = require('karma-chrome-launcher');

// Or when installed as a plugin, Karma loads it automatically:
// plugins: ['karma-chrome-launcher']

// karma.conf.js
module.exports = function(config) {
  config.set({
    // Basic browser configuration
    browsers: ['Chrome', 'ChromeHeadless'],
    
    // Custom launcher with flags
    customLaunchers: {
      Chrome_without_security: {
        base: 'Chrome',
        flags: ['--disable-web-security', '--disable-site-isolation-trials']
      },
      Chrome_with_debugging: {
        base: 'Chrome',
        chromeDataDir: path.resolve(__dirname, '.chrome')
      }
    },
    
    // Include the plugin
    plugins: [
      'karma-chrome-launcher',
      // other plugins...
    ]
  });
};

// Main module exports - Karma DI configuration object
module.exports = {
  'launcher:Chrome': ['type', ChromeBrowser],
  'launcher:ChromeHeadless': ['type', ChromeHeadlessBrowser], 
  'launcher:ChromeCanary': ['type', ChromeCanaryBrowser],
  'launcher:ChromeCanaryHeadless': ['type', ChromeCanaryHeadlessBrowser],
  'launcher:Chromium': ['type', ChromiumBrowser],
  'launcher:ChromiumHeadless': ['type', ChromiumHeadlessBrowser],
  'launcher:Dartium': ['type', DartiumBrowser]
};

interface LauncherArgs {
  /** Array of command-line flags to pass to the browser */
  flags?: string[];
  /** Custom Chrome user data directory path (overrides default temp directory) */
  chromeDataDir?: string;
}

/** Browser launcher constructor function signature */
type BrowserLauncher = (baseBrowserDecorator: Function, args: LauncherArgs) => void;

/** Browser launcher prototype with required properties */
interface BrowserPrototype {
  /** Browser name identifier */
  name: string;
  /** Platform-specific default command paths */
  DEFAULT_CMD: {
    linux?: string | null;
    darwin?: string | null;
    win32?: string | null;
  };
  /** Environment variable name for binary path override */
  ENV_CMD: string;
  /** Internal method to generate browser command-line options */
  _getOptions(url: string): string[];
}

// Used in Karma configuration
browsers: ['Chrome']

// Environment variable override
CHROME_BIN=/path/to/chrome karma start

--user-data-dir=<temp-dir>
--enable-automation
--no-default-browser-check
--no-first-run
--disable-default-apps
--disable-popup-blocking
--disable-translate
--disable-background-timer-throttling
--disable-renderer-backgrounding
--disable-device-discovery-notifications

// Used in Karma configuration  
browsers: ['ChromeHeadless']

// Automatically adds headless flags:
// --headless, --disable-gpu, --disable-dev-shm-usage
// --remote-debugging-port=9222 (if not already specified)

// Used in Karma configuration
browsers: ['ChromeCanary']

// Environment variable override  
CHROME_CANARY_BIN=/path/to/chrome-canary karma start

// Automatically adds performance flags:
// --js-flags=--nocrankshaft --noopt

// Used in Karma configuration
browsers: ['ChromeCanaryHeadless']

// Used in Karma configuration
browsers: ['Chromium']

// Environment variable override
CHROMIUM_BIN=/path/to/chromium karma start

--user-data-dir=<temp-dir>
--no-default-browser-check
--no-first-run
--disable-default-apps
--disable-popup-blocking
--disable-translate
--disable-background-timer-throttling

// Used in Karma configuration
browsers: ['ChromiumHeadless']

// Used in Karma configuration
browsers: ['Dartium']

// Environment variable override
DARTIUM_BIN=/path/to/dartium karma start

// karma.conf.js
customLaunchers: {
  Chrome_without_security: {
    base: 'Chrome',
    flags: [
      '--disable-web-security',
      '--disable-site-isolation-trials',
      '--allow-running-insecure-content'
    ]
  }
}

// karma.conf.js
const path = require('path');

customLaunchers: {
  Chrome_with_debugging: {
    base: 'Chrome',
    chromeDataDir: path.resolve(__dirname, '.chrome')
  }
}

customLaunchers: {
  Chrome_with_js_flags: {
    base: 'Chrome',
    flags: ['--js-flags="--expose-gc --harmony"']
  }
}

// karma.conf.js
process.env.CHROME_BIN = require('puppeteer').executablePath();

module.exports = function(config) {
  config.set({
    browsers: ['ChromeHeadless']
  });
};

// Available on module.exports.test
const testUtils = require('karma-chrome-launcher').test;

/**
 * Check if a flag is a JS flags parameter
 * @param {string} flag - Command line flag to check
 * @returns {boolean} True if flag starts with --js-flags=
 */
function isJSFlags(flag);

/**
 * Sanitize JS flags by removing quotes
 * @param {string} flag - JS flags parameter to sanitize
 * @returns {string} Sanitized flag without quotes
 */
function sanitizeJSFlags(flag);

/**
 * Generate headless browser options
 * @param {string} url - Target URL
 * @param {object} args - Launcher arguments
 * @param {function} parent - Parent options function
 * @returns {string[]} Array of command line options
 */
function headlessGetOptions(url, args, parent);

/**
 * Generate Chrome Canary browser options  
 * @param {string} url - Target URL
 * @param {object} args - Launcher arguments
 * @param {function} parent - Parent options function
 * @returns {string[]} Array of command line options
 */
function canaryGetOptions(url, args, parent);

/**
 * Get Chrome executable path on Windows
 * @param {string} chromeDirName - Chrome directory name ('Chrome' or 'Chrome SxS')
 * @returns {string|null} Path to chrome.exe or null if not found
 */
function getChromeExe(chromeDirName);

/**
 * Get Chromium executable path on Windows  
 * @returns {string|null} Path to chromium chrome.exe or null if not found
 */
function getChromiumExe();

/**
 * Find binary using which command on Linux
 * @param {string[]} commands - Array of command names to search for
 * @returns {string|null} First found command or null
 */
function getBin(commands);

/**
 * Get Chrome path on macOS with user directory fallback
 * @param {string} defaultPath - Default application path
 * @returns {string} Resolved Chrome path
 */
function getChromeDarwin(defaultPath);