baseline-browser-mapping 2.11.13: getAllVersions

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 baseline-browser-mapping.getAllVersions in pkg:npm/baseline-browser-mapping@2.11.13
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/baseline-browser-mapping@2.11.13
Demonstrate these symbols/APIs:
  - baseline-browser-mapping.getAllVersions

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:5f9acb8d09d1374a336ba2c3241d85f9444b8fa5f9d435d1dc8ea7d69f7c02b3","contract":["getAllVersions returns browser versions in array format with version metadata and baseline status by default","getAllVersions returns nested map of browsers and versions when outputFormat is object","getAllVersions returns formatted CSV with headers when outputFormat is csv","getAllVersions includes downstream browser engines when includeDownstreamBrowsers is true","getAllVersions distinguishes widely and newly available status when useSupports is true","getAllVersions throws error when includeKaiOS is enabled without downstream browsers"],"goal":"verify baseline-browser-mapping.getAllVersions in pkg:npm/baseline-browser-mapping@2.11.13","kind":"HOW","packages":["pkg:npm/baseline-browser-mapping@2.11.13"],"schemaVersion":1,"symbols":["baseline-browser-mapping.getAllVersions"]},"contractCommand":["node","test/contract.js"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/baseline-browser-mapping@2.11.13"],"schemaVersion":1,"subject":"pkg:npm/baseline-browser-mapping@2.11.13","symbols":["baseline-browser-mapping.getAllVersions"],"verifierAdapter":"node-typescript@1"}

{
  "name": "baseline-browser-mapping-sample",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "baseline-browser-mapping-sample",
      "version": "1.0.0",
      "dependencies": {
        "baseline-browser-mapping": "2.11.13"
      }
    },
    "node_modules/baseline-browser-mapping": {
      "version": "2.11.13",
      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.11.13.tgz",
      "integrity": "sha512-k9HNuUVMlqVjQ9UHzfPjIqiDbWw7WqT1AoT7GL8VwvF3r0ZfArtgiSPAlmupyNquNgOJHTuH4CKYf8ttMTWBTQ==",
      "license": "Apache-2.0",
      "bin": {
        "baseline-browser-mapping": "dist/cli.cjs"
      },
      "engines": {
        "node": ">=6.0.0"
      }
    }
  }
}

{
  "name": "baseline-browser-mapping-sample",
  "version": "1.0.0",
  "dependencies": {
    "baseline-browser-mapping": "2.11.13"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify baseline-browser-mapping.getAllVersions in pkg:npm/baseline-browser-mapping@2.11.13",
  "kind": "HOW",
  "packages": [
    "pkg:npm/baseline-browser-mapping@2.11.13"
  ],
  "symbols": [
    "baseline-browser-mapping.getAllVersions"
  ]
}

const { getAllVersions } = require('baseline-browser-mapping');

/**
 * Retrieves all browser versions with their Baseline availability status.
 *
 * @param {import('baseline-browser-mapping/dist/types.js').AllVersionsOptions} [options]
 * @returns {any}
 */
function fetchAllBrowserVersions(options = {}) {
  return getAllVersions(options);
}

module.exports = {
  fetchAllBrowserVersions,
  getAllVersions,
};

const assert = require('node:assert/strict');
const {
  fetchAllBrowserVersions,
  getAllVersions,
} = require('../src/index.js');

// Contract 1: getAllVersions returns browser versions in array format with version metadata and baseline status by default
{
  const list = fetchAllBrowserVersions({ suppressWarnings: true });
  assert.ok(Array.isArray(list), 'getAllVersions should return an array');
  assert.ok(list.length > 0, 'list should not be empty');
  const chrome0 = list.find((b) => b.browser === 'chrome' && b.version === '1');
  assert.ok(chrome0, 'chrome version 1 should exist');
  assert.strictEqual(chrome0.browser, 'chrome');
  assert.strictEqual(chrome0.version, '1');
  assert.strictEqual(typeof chrome0.year, 'string');
  assert.strictEqual(typeof chrome0.wa_compatible, 'boolean');
  assert.ok('release_date' in chrome0);
}

// Contract 2: getAllVersions returns nested map of browsers and versions when outputFormat is object
{
  const obj = fetchAllBrowserVersions({ outputFormat: 'object', suppressWarnings: true });
  assert.strictEqual(typeof obj, 'object', 'outputFormat object should return an object');
  assert.ok(obj.chrome, 'nested chrome object should exist');
  assert.ok(obj.safari, 'nested safari object should exist');
  assert.ok(obj.firefox, 'nested firefox object should exist');
  assert.ok(obj.edge, 'nested edge object should exist');
  assert.strictEqual(typeof obj.chrome['1'], 'object');
  assert.strictEqual(obj.chrome['1'].year, 'pre_baseline');
  assert.strictEqual(obj.chrome['1'].wa_compatible, false);
}

// Contract 3: getAllVersions returns formatted CSV with headers when outputFormat is csv
{
  const csv = fetchAllBrowserVersions({ outputFormat: 'csv', suppressWarnings: true });
  assert.strictEqual(typeof csv, 'string', 'outputFormat csv should return a string');
  const lines = csv.trim().split('\n');
  assert.ok(lines.length > 1, 'CSV should have multiple lines');
  assert.strictEqual(lines[0], '"browser","version","year","wa_compatible","release_date","engine","engine_version"');
}

// Contract 4: getAllVersions includes downstream browser engines when includeDownstreamBrowsers is true
{
  const defaultList = fetchAllBrowserVersions({ suppressWarnings: true });
  const downstreamList = fetchAllBrowserVersions({ includeDownstreamBrowsers: true, suppressWarnings: true });
  assert.ok(downstreamList.length > defaultList.length, 'downstream list should have more versions');
  const browsers = new Set(downstreamList.map((b) => b.browser));
  assert.ok(browsers.has('opera'), 'should include opera');
  assert.ok(browsers.has('samsunginternet_android'), 'should include samsunginternet_android');
}

// Contract 5: getAllVersions distinguishes widely and newly available status when useSupports is true
{
  const withSupports = fetchAllBrowserVersions({ useSupports: true, suppressWarnings: true });
  assert.ok(Array.isArray(withSupports));
  const hasSupportsField = withSupports.some((item) => item.supports !== undefined);
  assert.ok(hasSupportsField, 'items should include supports property');
  const newlyItem = withSupports.find((item) => item.supports === 'newly');
  assert.ok(newlyItem, 'should have newly available items');
  const widelyItem = withSupports.find((item) => item.supports === 'widely');
  assert.ok(widelyItem, 'should have widely available items');

  const csvSupports = fetchAllBrowserVersions({ outputFormat: 'csv', useSupports: true, suppressWarnings: true });
  const firstLine = csvSupports.trim().split('\n')[0];
  assert.strictEqual(firstLine, '"browser","version","year","supports","release_date","engine","engine_version"');
}

// Contract 6: getAllVersions throws error when includeKaiOS is enabled without downstream browsers
{
  assert.throws(
    () => {
      getAllVersions({
        includeKaiOS: true,
        includeDownstreamBrowsers: false,
        suppressWarnings: true,
      });
    },
    /KaiOS is a downstream browser and can only be included if you include other downstream browsers/,
    'Should throw when includeKaiOS is true without includeDownstreamBrowsers'
  );
}

console.log('All pkg:npm/baseline-browser-mapping@2.11.13 baseline-browser-mapping.getAllVersions contracts passed successfully.');