electron-to-chromium 1.5.403: electronToBrowserList

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify electron-to-chromium.electronToBrowserList in pkg:npm/electron-to-chromium@1.5.403
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/electron-to-chromium@1.5.403
Demonstrate these symbols/APIs:
  - electron-to-chromium.electronToBrowserList

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:0fad6e995b41fbde102794135cfbb19ba800e5ee6364408c2183aed5db725ebb","contract":["electronToBrowserList is exported as a function from electron-to-chromium","electronToBrowserList converts Electron string version to Chrome browserlist query format","electronToBrowserList converts numeric version and handles integer 1 mapping to 1.0","electronToBrowserList returns undefined for numeric versions missing exact minor key in versions map","electronToBrowserList returns undefined for unknown or invalid version queries"],"goal":"verify electron-to-chromium.electronToBrowserList in pkg:npm/electron-to-chromium@1.5.403","kind":"HOW","packages":["pkg:npm/electron-to-chromium@1.5.403"],"schemaVersion":1,"symbols":["electron-to-chromium.electronToBrowserList"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/electron-to-chromium@1.5.403"],"schemaVersion":1,"subject":"pkg:npm/electron-to-chromium@1.5.403","symbols":["electron-to-chromium.electronToBrowserList"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-electron-to-chromium-electrontobrowserlist",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-electron-to-chromium-electrontobrowserlist",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "electron-to-chromium": "1.5.403"
      }
    },
    "node_modules/electron-to-chromium": {
      "version": "1.5.403",
      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.403.tgz",
      "integrity": "sha512-MQsYmdaLzvaCX5j+ZZBr5Fm6uCCnPQcRtlvmvRlWqrXy+BH2O4ffXIAScF+JQznQWB9brWp4lSD9Z4yNmaf2BA==",
      "license": "ISC"
    }
  }
}

{
  "name": "sample-electron-to-chromium-electrontobrowserlist",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room code sample for electron-to-chromium.electronToBrowserList in electron-to-chromium@1.5.403",
  "main": "src/index.js",
  "license": "MIT-0",
  "dependencies": {
    "electron-to-chromium": "1.5.403"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify electron-to-chromium.electronToBrowserList in pkg:npm/electron-to-chromium@1.5.403",
  "kind": "HOW",
  "packages": [
    "pkg:npm/electron-to-chromium@1.5.403"
  ],
  "symbols": [
    "electron-to-chromium.electronToBrowserList"
  ]
}

const {
  electronToBrowserList,
  electronToChromium,
  chromiumToElectron,
  versions,
  fullVersions,
  chromiumVersions,
  fullChromiumVersions
} = require('electron-to-chromium');

/**
 * Converts an Electron version query into a Browserlist-compatible Chrome query string.
 *
 * @param {string|number} query - The Electron version string (e.g. '1.4', '30.0') or numeric shorthand (e.g. 1, 1.4).
 * @returns {string|undefined} Formatted string like 'Chrome >= <version>' or undefined if not found.
 */
function getBrowserListTarget(query) {
  return electronToBrowserList(query);
}

module.exports = {
  electronToBrowserList,
  electronToChromium,
  chromiumToElectron,
  versions,
  fullVersions,
  chromiumVersions,
  fullChromiumVersions,
  getBrowserListTarget
};

import assert from 'node:assert/strict';
import { createRequire } from 'node:module';

const require = createRequire(import.meta.url);
const {
  electronToBrowserList,
  getBrowserListTarget
} = require('../src/index.js');

async function runTests() {
  // 1. electronToBrowserList is exported as a function from electron-to-chromium
  assert.equal(typeof electronToBrowserList, 'function', 'electronToBrowserList must be a function');
  assert.equal(typeof getBrowserListTarget, 'function', 'getBrowserListTarget must be a function');

  // 2. electronToBrowserList converts Electron string version to Chrome browserlist query format
  assert.equal(electronToBrowserList('1.4'), 'Chrome >= 53', 'Electron 1.4 should map to Chrome >= 53');
  assert.equal(electronToBrowserList('30.0'), 'Chrome >= 124', 'Electron 30.0 should map to Chrome >= 124');
  assert.equal(electronToBrowserList('44.0'), 'Chrome >= 152', 'Electron 44.0 should map to Chrome >= 152');
  assert.equal(getBrowserListTarget('30.0'), 'Chrome >= 124', 'Helper getBrowserListTarget should return Chrome >= 124');

  // 3. electronToBrowserList converts numeric version and handles integer 1 mapping to 1.0
  assert.equal(electronToBrowserList(1), 'Chrome >= 49', 'Integer 1 maps to 1.0 which corresponds to Chrome >= 49');
  assert.equal(electronToBrowserList(1.4), 'Chrome >= 53', 'Float 1.4 maps to string "1.4" and Chrome >= 53');

  // 4. electronToBrowserList returns undefined for numeric versions missing exact minor key in versions map
  assert.equal(electronToBrowserList(30), undefined, 'Numeric 30 becomes "30" which does not match "30.0" key');

  // 5. electronToBrowserList returns undefined for unknown or invalid version queries
  assert.equal(electronToBrowserList('999.0'), undefined, 'Unknown major.minor version should return undefined');
  assert.equal(electronToBrowserList('unknown-query'), undefined, 'Invalid string query should return undefined');
  assert.equal(electronToBrowserList(''), undefined, 'Empty string should return undefined');

  console.log('All contract assertions for electron-to-chromium.electronToBrowserList passed successfully.');
}

runTests().catch((err) => {
  console.error('Contract test failed:', err);
  process.exit(1);
});