browserslist 4.28.3 → 4.28.4

package/cli.js

@@ -38,6 +38,7 @@ if (isArg('--help') || isArg('-h')) {
 } else if (isArg('--version') || isArg('-v')) {
   process.stdout.write('browserslist ' + pkg.version + '\n')
 } else if (isArg('--update-db')) {
+  /* c8 ignore next 8 */
   process.stdout.write(
     'The --update-db command is deprecated.\n' +
       'Please use npx update-browserslist-db@latest instead.\n'

package/index.js

@@ -7,13 +7,14 @@ var path = require('path')
 
 var BrowserslistError = require('./error')
 var env = require('./node')
-var parseWithoutCache = require('./parse')
+var parseWithoutCache = require('./parse') // Will load browser.js in webpack
 
 var YEAR = 365.259641 * 24 * 60 * 60 * 1000
 var ANDROID_EVERGREEN_FIRST = '37'
 var OP_MOB_BLINK_FIRST = 14
 var FIREFOX_ESR_VERSION = '140'
 
+// Helpers
 
 function isVersionsMatch(versionA, versionB) {
   return (versionA + '.').indexOf(versionB + '.') === 0
@@ -149,11 +150,14 @@ function compareSemver(a, b) {
   )
 }
 
+// this follows the npm-like semver behavior
 function semverFilterLoose(operator, range) {
   range = range.split('.').map(parseSimpleInt)
   if (typeof range[1] === 'undefined') {
     range[1] = 'x'
   }
+  // ignore any patch version because we only return minor versions
+  // range[2] = 'x'
   switch (operator) {
     case '<=':
       return function (version) {
@@ -169,6 +173,7 @@ function semverFilterLoose(operator, range) {
   }
 }
 
+// this follows the npm-like semver behavior
 function compareSemverLoose(version, range) {
   if (version[0] !== range[0]) {
     return version[0] < range[0] ? -1 : +1
@@ -289,6 +294,8 @@ function unknownQuery(query) {
   )
 }
 
+// Adjusts last X versions queries for some mobile browsers,
+// where caniuse data jumps from a legacy version to the latest
 function filterJumps(list, name, nVersions, context) {
   var jump = 1
   switch (name) {
@@ -411,6 +418,7 @@ function browserslist(queries, opts) {
     mobileToDesktop: opts.mobileToDesktop,
     env: opts.env
   }
+  // Removing to avoid using context.path without marking query as needsPath
   if (needsPath) {
     context.path = opts.path
   }
@@ -431,6 +439,9 @@ function browserslist(queries, opts) {
     name1 = name1.split(' ')
     name2 = name2.split(' ')
     if (name1[0] === name2[0]) {
+      // assumptions on caniuse data
+      // 1) version ranges never overlaps
+      // 2) if version is not a range, it never contains `-`
       var version1 = name1[1].split('-')[0]
       var version2 = name2[1].split('-')[0]
       return compareSemver(version2.split('.'), version1.split('.'))
@@ -475,6 +486,7 @@ browserslist.parse = function (queries, opts) {
   return parseQueries(queries)
 }
 
+// Will be filled by Can I Use data below
 browserslist.cache = {}
 browserslist.data = {}
 browserslist.usage = {
@@ -482,8 +494,10 @@ browserslist.usage = {
   custom: null
 }
 
+// Default browsers query
 browserslist.defaults = ['> 0.5%', 'last 2 versions', 'Firefox ESR', 'not dead']
 
+// Browser names aliases
 browserslist.aliases = {
   fx: 'firefox',
   ff: 'firefox',
@@ -499,13 +513,17 @@ browserslist.aliases = {
   qqandroid: 'and_qq'
 }
 
+// Can I Use only provides a few versions for some browsers (e.g. and_chr).
+// Fallback to a similar browser for unknown versions
+// Note op_mob is not included as its chromium versions are not in sync with Opera desktop
 browserslist.desktopNames = {
   and_chr: 'chrome',
   and_ff: 'firefox',
   ie_mob: 'ie',
-  android: 'chrome'
+  android: 'chrome' // has extra processing logic
 }
 
+// Aliases to work with joined versions like `ios_saf 7.0-7.1`
 browserslist.versionAliases = {}
 
 browserslist.clearCaches = env.clearCaches
@@ -798,6 +816,13 @@ var QUERIES = {
   },
   baseline: {
     matches: ['year', 'availability', 'date', 'downstream', 'kaios'],
+    // Matches:
+    //   baseline 2024
+    //   baseline newly available
+    //   baseline widely available
+    //   baseline widely available on 2024-06-01
+    //   ...with downstream
+    //   ...including kaios
     regexp:
       /^baseline\s+(?:(\d+)|(newly|widely)\s+available(?:\s+on\s+(\d{4}-\d{2}-\d{2}))?)?(\s+with\s+downstream)?(\s+including\s+kaios)?$/i,
     select: function (context, node) {
@@ -996,6 +1021,7 @@ var QUERIES = {
       var result = []
       for (var name in features) {
         var data = byName(name, context)
+        // Only check desktop when latest released mobile has support
         var iMax = data.released.length - 1
         while (iMax >= 0) {
           if (data.released[iMax] in features[name]) break
@@ -1277,6 +1303,7 @@ var QUERIES = {
   }
 }
 
+// Get and convert Can I Use data
 
 ;(function () {
   for (var name in agents) {

package/node.js

@@ -27,7 +27,7 @@ function checkExtend(name) {
       'Browserslist config needs `browserslist-config-` prefix. ' + use
     )
   }
-  if (name.replace(/^@[^/]+\
+  if (name.replace(/^@[^/]+\//, '').indexOf('.') !== -1) {
     throw new BrowserslistError(
       '`.` not allowed in Browserslist config name. ' + use
     )
@@ -44,6 +44,7 @@ function getPathType(filepath) {
   try {
     stats = fs.existsSync(filepath) && fs.statSync(filepath)
   } catch (err) {
+    /* c8 ignore start */
     if (
       err.code !== 'ENOENT' &&
       err.code !== 'EACCES' &&
@@ -51,6 +52,7 @@ function getPathType(filepath) {
     ) {
       throw err
     }
+    /* c8 ignore end */
   }
 
   if (stats && stats.isDirectory()) return PATHTYPE_DIR
@@ -237,6 +239,8 @@ function normalizeStats(data, stats) {
 function normalizeUsageData(usageData, data) {
   for (var browser in usageData) {
     var browserUsage = usageData[browser]
+    // https://github.com/browserslist/browserslist/issues/431#issuecomment-565230615
+    // caniuse-db returns { 0: "percentage" } for `and_*` regional stats
     if ('0' in browserUsage) {
       var versions = data[browser].versions
       browserUsage[versions[versions.length - 1]] = browserUsage[0]
@@ -275,6 +279,7 @@ module.exports = {
       checkExtend(name)
     }
     var stats = require(
+      // Use forward slashes for module paths, also on Windows.
       require.resolve(path.posix.join(name, 'browserslist-stats.json'), {
         paths: ['.']
       })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserslist",
-  "version": "4.28.3",
+  "version": "4.28.4",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "browsers",