baseline-browser-mapping 2.2.2 → 2.4.0

package/README.md

@@ -165,16 +165,34 @@ By default, this function returns an `Array` of `Objects` and excludes downstrea
 [
   ...
   {
-    browser: 'chrome_android', // Browser name
-    version: '68', // Browser version as a string
-    release_date: '2018-07-24', // Release date
-    year: 2019, //Baseline year feature set the version supports
-    waCompatible: false // Boolean indicating whether the version is compatible with Baseline Widely available
+    browser: "firefox_android", // Browser name
+    version: "125", // Browser version
+    release_date: "2024-04-16", // Release date
+    year: 2023, // Baseline year feature set the version supports
+    wa_compatible: true // Whether the browser version supports Widely available
   },
   ...
 ]
 ```
 
+### Understanding which browsers support Newly available features
+
+You may want to understand which recent browser versions support all Newly available features. You can replace the `wa_compatible` property with a `supports` property using the `useSupport` option:
+
+```javascript
+getAllVersions({
+  useSupports: true,
+});
+```
+
+The `supports` property has three possible values:
+
+- `year_only` for browser versions that do not support all Baseline Widely available Newly Available features.
+- `widely` for browser versions that support all Widely available features.
+- `newly` for browser versions that support all Newly available features.
+
+Browser versions that support all Newly available features also support all Widely available features.
+
 ### `getAllVersions()` Configuration options
 
 `getAllVersions()` accepts an `Object` as an argument with configuration options. The defaults are as follows:
@@ -202,13 +220,13 @@ Downstream browsers include the same properties as core browsers, as well as the
 [
   ...
   {
-    "browser": "samsunginternet_android",
-    "version": "18.0",
-    "release_date": "2022-08-08",
-    "engine": "Blink",
-    "engine_version": "99",
-    "year": 2021,
-    "waCompatible": false
+    browser: "samsunginternet_android",
+    version: "27.0",
+    release_date: "2024-11-06",
+    engine: "Blink",
+    engine_version: "125",
+    year: 2023,
+    supports: "widely"
   },
   ...
 ]
@@ -233,7 +251,7 @@ In thise case, `getAllVersions()` returns a nested object with the browser [IDs
   "chrome": {
     "53": {
       "year": 2016,
-      "wa_compatible": false,
+      "supports": "year_only",
       "release_date": "2016-09-07"
     },
     ...
@@ -248,7 +266,7 @@ Downstream browsers will include extra fields for `engine` and `engine_versions`
   "webview_android": {
     "53": {
       "year": 2016,
-      "waCompatible": false,
+      "supports": "year_only",
       "release_date": "2016-09-07",
       "engine": "Blink",
       "engine_version": "53"
@@ -268,10 +286,13 @@ getAllVersions({
 `getAllVersions` returns a `String` with a header row and comma-separated values for each browser version that you can write to a file or pass to another service. Core browsers will have "NULL" as the value for their `engine` and `engine_version`:
 
 ```csv
-"browser","version","year","wa_compatible","release_date","engine","engine_version"
-"chrome","53","2016","false","2016-09-07","NULL","NULL"
+"browser","version","year","supports","release_date","engine","engine_version"
+"chrome","53","2016","year_only","2016-09-07","NULL","NULL"
+...
+"firefox","135","2024","widely","2025-02-04","NULL","NULL"
+"firefox","136","2024","newly","2025-03-04","NULL","NULL"
 ...
-"ya_android","20.12","2020","false","2020-12-20","Blink","87"
+"ya_android","20.12","2020","year_only","2020-12-20","Blink","87"
 ...
 ```
 
@@ -286,10 +307,18 @@ The outputs of `getAllVersions()` are available as JSON or CSV files generated o
   - [Array](https://web-platform-dx.github.io/baseline-browser-mapping/all_versions_array.json)
   - [Object](https://web-platform-dx.github.io/baseline-browser-mapping/all_versions_object.json)
   - [CSV](https://web-platform-dx.github.io/baseline-browser-mapping/all_versions.csv)
+    Core browsers only, with `supports` property
+  - [Array](https://web-platform-dx.github.io/baseline-browser-mapping/all_versions_array_with_supports.json)
+  - [Object](https://web-platform-dx.github.io/baseline-browser-mapping/all_versions_object_with_supports.json)
+  - [CSV](https://web-platform-dx.github.io/baseline-browser-mapping/all_versions_with_supports.csv)
 - Including downstream browsers
   - [Array](https://web-platform-dx.github.io/baseline-browser-mapping/with_downstream/all_versions_array.json)
   - [Object](https://web-platform-dx.github.io/baseline-browser-mapping/with_downstream/all_versions_object.json)
   - [CSV](https://web-platform-dx.github.io/baseline-browser-mapping/with_downstream/all_versions.csv)
+- Including downstream browsers with `supports` property
+  - [Array](https://web-platform-dx.github.io/baseline-browser-mapping/with_downstream/all_versions_array_with_supports.json)
+  - [Object](https://web-platform-dx.github.io/baseline-browser-mapping/with_downstream/all_versions_object_with_supports.json)
+  - [CSV](https://web-platform-dx.github.io/baseline-browser-mapping/with_downstream/all_versions_with_supports.csv)
 
 These files are updated on a daily basis.
 

package/dist/data/downstream-browsers.json

@@ -652,6 +652,24 @@
                     "engine_version": "130",
                     "status": "unknown",
                     "release_date": "2024-11-30"
+                },
+                "25.2": {
+                    "engine": "Blink",
+                    "engine_version": "132",
+                    "status": "unknown",
+                    "release_date": "2025-04-24"
+                },
+                "25.3": {
+                    "engine": "Blink",
+                    "engine_version": "132",
+                    "status": "unknown",
+                    "release_date": "2025-04-23"
+                },
+                "25.4": {
+                    "engine": "Blink",
+                    "engine_version": "134",
+                    "status": "unknown",
+                    "release_date": "2025-04-23"
                 }
             }
         },
@@ -1504,5 +1522,5 @@
             }
         }
     },
-    "lastUpdated": "2025-04-09T14:12:33.205Z"
+    "lastUpdated": "2025-04-30T13:52:05.731Z"
 }

package/dist/scripts/baseline-browser-versions.d.ts

@@ -6,18 +6,13 @@ type BrowserVersion = {
     engine_version?: string;
 };
 interface AllBrowsersBrowserVersion extends BrowserVersion {
-    year: number;
-    wa_compatible: boolean;
+    year: number | string;
+    supports?: string;
+    wa_compatible?: boolean;
 }
 type NestedBrowserVersions = {
     [browser: string]: {
-        [version: string]: {
-            year: number;
-            wa_compatible: boolean;
-            release_date?: string;
-            engine?: string;
-            engine_version?: string;
-        };
+        [version: string]: AllBrowsersBrowserVersion;
     };
 };
 type Options = {
@@ -38,7 +33,7 @@ type Options = {
      */
     widelyAvailableOnDate?: string | number;
     /**
-     * Pass a year between 2016 and the current year to get browser versions compatible with all
+     * Pass a year between 2015 and the current year to get browser versions compatible with all
      * Newly Available features as of the end of the year specified.
      * > NOTE: cannot be used with `widelyAvailableOnDate`.
      */
@@ -65,6 +60,11 @@ type AllVersionsOptions = {
      * Defaults to `false`.
      */
     includeDownstreamBrowsers?: boolean;
+    /**
+     * Whether to use the new "supports" property in place of "wa_compatible"
+     * Defaults to `false`
+     */
+    useSupports?: boolean;
 };
 /**
  * Returns all browser versions known to this module with their level of Baseline support either as an `Array` or a `String` CSV.

package/dist/scripts/baseline-browser-versions.js

@@ -23,7 +23,15 @@ const downstreamBrowserData = [
     ...Object.entries(bcdBrowsers.browsers).filter(([browserName]) => bcdDownstreamBrowserNames.includes(browserName)),
     ...Object.entries(otherBrowsers.browsers),
 ];
-const acceptableStatuses = ["current", "esr", "retired", "unknown"];
+const acceptableStatuses = [
+    "current",
+    "esr",
+    "retired",
+    "unknown",
+    "beta",
+    "nightly",
+];
+let suppressPre2015Warning = false;
 const stripLTEPrefix = (str) => {
     if (!str) {
         return str;
@@ -136,8 +144,11 @@ const getSubsequentVersions = (minimumVersions) => {
     return subsequentVersions;
 };
 const getCoreVersionsByDate = (date, listAllCompatibleVersions = false) => {
-    if (date.getFullYear() < 2016) {
-        throw new Error("There are no browser versions compatible with Baseline before 2016");
+    if (date.getFullYear() < 2015 && !suppressPre2015Warning) {
+        console.warn(new Error("There are no browser versions compatible with Baseline before 2015.  You may receive unexpected results."));
+    }
+    if (date.getFullYear() < 2002) {
+        throw new Error("None of the browsers in the core set were released before 2002.  Please use a date after 2002.");
     }
     if (date.getFullYear() > new Date().getFullYear()) {
         throw new Error("There are no browser versions compatible with Baseline in the future");
@@ -269,13 +280,15 @@ export function getCompatibleVersions(userOptions) {
  * - `outputFormat`: `array` (default), `object` or `csv`
  */
 export function getAllVersions(userOptions) {
+    suppressPre2015Warning = true;
     let incomingOptions = userOptions ?? {};
     let options = {
         outputFormat: incomingOptions.outputFormat ?? "array",
         includeDownstreamBrowsers: incomingOptions.includeDownstreamBrowsers ?? false,
+        useSupports: incomingOptions.useSupports ?? false,
     };
     let nextYear = new Date().getFullYear() + 1;
-    const yearArray = [...Array(nextYear).keys()].slice(2016);
+    const yearArray = [...Array(nextYear).keys()].slice(2002);
     const yearMinimumVersions = {};
     yearArray.forEach((year) => {
         yearMinimumVersions[year] = {};
@@ -289,8 +302,17 @@ export function getAllVersions(userOptions) {
     waMinimumVersions.forEach((version) => {
         waObject[version.browser] = version;
     });
+    const thirtyMonthsFromToday = new Date();
+    thirtyMonthsFromToday.setMonth(thirtyMonthsFromToday.getMonth() + 30);
+    const naMinimumVersions = getCompatibleVersions({
+        widelyAvailableOnDate: thirtyMonthsFromToday.toISOString().slice(0, 10),
+    });
+    const naObject = {};
+    naMinimumVersions.forEach((version) => {
+        naObject[version.browser] = version;
+    });
     const allVersions = getCompatibleVersions({
-        targetYear: 2016,
+        targetYear: 2002,
         listAllCompatibleVersions: true,
     });
     const outputArray = new Array();
@@ -301,6 +323,7 @@ export function getAllVersions(userOptions) {
             return compareVersions(a.version, b.version);
         });
         let waVersion = waObject[browserName]?.version ?? "0";
+        let naVersion = naObject[browserName]?.version ?? "0";
         yearArray.forEach((year) => {
             if (yearMinimumVersions[year]) {
                 let minBrowserVersionInfo = yearMinimumVersions[year][browserName] ?? {
@@ -312,12 +335,25 @@ export function getAllVersions(userOptions) {
                     ? thisBrowserAllVersions
                     : thisBrowserAllVersions.slice(0, sliceIndex);
                 subArray.forEach((version) => {
-                    let iswa_compatible = compareVersions(version.version, waVersion) >= 0 ? true : false;
-                    outputArray.push({
+                    let isWaCcompatible = compareVersions(version.version, waVersion) >= 0 ? true : false;
+                    let isNaCompatible = compareVersions(version.version, naVersion) >= 0 ? true : false;
+                    let versionToPush = {
                         ...version,
-                        year: year - 1,
-                        wa_compatible: iswa_compatible,
-                    });
+                        year: year <= 2015 ? "pre_baseline" : year - 1,
+                    };
+                    if (options.useSupports) {
+                        if (isWaCcompatible)
+                            versionToPush.supports = "widely";
+                        if (isNaCompatible)
+                            versionToPush.supports = "newly";
+                    }
+                    else {
+                        versionToPush = {
+                            ...versionToPush,
+                            wa_compatible: isWaCcompatible,
+                        };
+                    }
+                    outputArray.push(versionToPush);
                 });
                 thisBrowserAllVersions = thisBrowserAllVersions.slice(sliceIndex, thisBrowserAllVersions.length);
             }
@@ -329,24 +365,48 @@ export function getAllVersions(userOptions) {
             let correspondingChromiumVersion = outputArray.find((upstreamVersion) => upstreamVersion.browser === "chrome" &&
                 upstreamVersion.version === version.engine_version);
             if (correspondingChromiumVersion) {
-                outputArray.push({
-                    ...version,
-                    year: correspondingChromiumVersion.year,
-                    wa_compatible: correspondingChromiumVersion.wa_compatible,
-                });
+                if (options.useSupports) {
+                    outputArray.push({
+                        ...version,
+                        year: correspondingChromiumVersion.year,
+                        supports: correspondingChromiumVersion.supports,
+                    });
+                }
+                else {
+                    outputArray.push({
+                        ...version,
+                        year: correspondingChromiumVersion.year,
+                        wa_compatible: correspondingChromiumVersion.wa_compatible,
+                    });
+                }
             }
         });
     }
     outputArray.sort((a, b) => {
-        if (a.year < b.year) {
+        // Sort by year: "pre_baseline" first, then numerical year in ascending order
+        if (a.year === "pre_baseline" && b.year !== "pre_baseline") {
             return -1;
         }
-        else if (a.browser > b.browser) {
+        if (b.year === "pre_baseline" && a.year !== "pre_baseline") {
             return 1;
         }
-        else {
-            return compareVersions(a.version, b.version);
+        if (a.year !== "pre_baseline" && b.year !== "pre_baseline") {
+            if (a.year < b.year) {
+                return -1;
+            }
+            if (a.year > b.year) {
+                return 1;
+            }
+        }
+        // Sort by browser alphabetically
+        if (a.browser < b.browser) {
+            return -1;
+        }
+        if (a.browser > b.browser) {
+            return 1;
         }
+        // Sort by version using compareVersions
+        return compareVersions(a.version, b.version);
     });
     if (options.outputFormat === "object") {
         const outputObject = {};
@@ -354,30 +414,52 @@ export function getAllVersions(userOptions) {
             if (!outputObject[version.browser]) {
                 outputObject[version.browser] = {};
             }
-            //@ts-ignore
-            outputObject[version.browser][version.version] = {
+            let versionToAdd = {
                 year: version.year,
-                wa_compatible: version.wa_compatible,
                 release_date: version.release_date,
                 engine: version.engine,
                 engine_version: version.engine_version,
             };
+            if (options.useSupports) {
+                //@ts-ignore
+                outputObject[version.browser][version.version] = version.supports
+                    ? { ...versionToAdd, supports: version.supports }
+                    : versionToAdd;
+            }
+            else {
+                //@ts-ignores
+                outputObject[version.browser][version.version] = {
+                    ...versionToAdd,
+                    wa_compatible: version.wa_compatible,
+                };
+            }
         });
         return outputObject ?? {};
     }
     if (options.outputFormat === "csv") {
-        let outputString = `"browser","version","year","wa_compatible","release_date","engine","engine_version"`;
+        let outputString = `"browser","version","year",` +
+            `"${options.useSupports ? "supports" : "wa_compatible"}",` +
+            `"release_date","engine","engine_version"`;
         outputArray.forEach((version) => {
             let outputs = {
                 browser: version.browser,
                 version: version.version,
                 year: version.year,
-                wa_compatible: version.wa_compatible,
                 release_date: version.release_date ?? "NULL",
                 engine: version.engine ?? "NULL",
                 engine_version: version.engine_version ?? "NULL",
             };
-            outputString += `\n"${outputs.browser}","${outputs.version}","${outputs.year}","${outputs.wa_compatible}","${outputs.release_date}","${outputs.engine}","${outputs.engine_version}"`;
+            outputs = options.useSupports
+                ? { ...outputs, supports: version.supports ?? "" }
+                : { ...outputs, wa_compatible: version.wa_compatible };
+            outputString +=
+                `\n"${outputs.browser}","` +
+                    `${outputs.version}","` +
+                    `${outputs.year}","` +
+                    `${options.useSupports ? outputs.supports : outputs.wa_compatible}","` +
+                    `${outputs.release_date}","` +
+                    `${outputs.engine}","` +
+                    `${outputs.engine_version}"`;
         });
         return outputString;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baseline-browser-mapping",
-  "version": "2.2.2",
+  "version": "2.4.0",
   "description": "A library for obtaining browser versions with their maximum supported Baseline feature set and Widely Available status.",
   "exports": {
     ".": "./dist/index.js"
@@ -20,14 +20,12 @@
     "refresh-static": "npx tsx scripts/refresh-static.ts"
   },
   "license": "Apache-2.0",
-  "dependencies": {
-    "@mdn/browser-compat-data": "^6.0.1",
-    "web-features": "^2.31.0"
-  },
   "devDependencies": {
-    "@types/node": "^22.13.5",
+    "@types/node": "^22.15.17",
     "prettier": "^3.5.3",
-    "typescript": "^5.7.2"
+    "typescript": "^5.7.2",
+    "@mdn/browser-compat-data": "^6.0.13",
+    "web-features": "^2.34.2"
   },
   "repository": "git+https://github.com/web-platform-dx/baseline-browser-mapping.git"
 }