index.js 37 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327
  1. var bbm = require('baseline-browser-mapping')
  2. var jsReleases = require('node-releases/data/processed/envs.json')
  3. var agents = require('caniuse-lite/dist/unpacker/agents').agents
  4. var e2c = require('electron-to-chromium/versions')
  5. var jsEOL = require('node-releases/data/release-schedule/release-schedule.json')
  6. var path = require('path')
  7. var BrowserslistError = require('./error')
  8. var env = require('./node')
  9. var parseWithoutCache = require('./parse') // Will load browser.js in webpack
  10. var YEAR = 365.259641 * 24 * 60 * 60 * 1000
  11. var ANDROID_EVERGREEN_FIRST = '37'
  12. var OP_MOB_BLINK_FIRST = 14
  13. var FIREFOX_ESR_VERSION = '140'
  14. // Helpers
  15. function isVersionsMatch(versionA, versionB) {
  16. return (versionA + '.').indexOf(versionB + '.') === 0
  17. }
  18. function isEolReleased(name) {
  19. var version = name.slice(1)
  20. return browserslist.nodeVersions.some(function (i) {
  21. return isVersionsMatch(i, version)
  22. })
  23. }
  24. function normalize(versions) {
  25. return versions.filter(function (version) {
  26. return typeof version === 'string'
  27. })
  28. }
  29. function normalizeElectron(version) {
  30. var versionToUse = version
  31. if (version.split('.').length === 3) {
  32. versionToUse = version.split('.').slice(0, -1).join('.')
  33. }
  34. return versionToUse
  35. }
  36. function nameMapper(name) {
  37. return function mapName(version) {
  38. return name + ' ' + version
  39. }
  40. }
  41. function getMajor(version) {
  42. return parseInt(version.split('.')[0])
  43. }
  44. function getMajorVersions(released, number) {
  45. if (released.length === 0) return []
  46. var majorVersions = uniq(released.map(getMajor))
  47. var minimum = majorVersions[majorVersions.length - number]
  48. if (!minimum) {
  49. return released
  50. }
  51. var selected = []
  52. for (var i = released.length - 1; i >= 0; i--) {
  53. if (minimum > getMajor(released[i])) break
  54. selected.unshift(released[i])
  55. }
  56. return selected
  57. }
  58. function uniq(array) {
  59. var filtered = []
  60. for (var i = 0; i < array.length; i++) {
  61. if (filtered.indexOf(array[i]) === -1) filtered.push(array[i])
  62. }
  63. return filtered
  64. }
  65. function fillUsage(result, name, data) {
  66. for (var i in data) {
  67. result[name + ' ' + i] = data[i]
  68. }
  69. }
  70. function generateFilter(sign, version) {
  71. version = parseFloat(version)
  72. if (sign === '>') {
  73. return function (v) {
  74. return parseLatestFloat(v) > version
  75. }
  76. } else if (sign === '>=') {
  77. return function (v) {
  78. return parseLatestFloat(v) >= version
  79. }
  80. } else if (sign === '<') {
  81. return function (v) {
  82. return parseFloat(v) < version
  83. }
  84. } else {
  85. return function (v) {
  86. return parseFloat(v) <= version
  87. }
  88. }
  89. function parseLatestFloat(v) {
  90. return parseFloat(v.split('-')[1] || v)
  91. }
  92. }
  93. function generateSemverFilter(sign, version) {
  94. version = version.split('.').map(parseSimpleInt)
  95. version[1] = version[1] || 0
  96. version[2] = version[2] || 0
  97. if (sign === '>') {
  98. return function (v) {
  99. v = v.split('.').map(parseSimpleInt)
  100. return compareSemver(v, version) > 0
  101. }
  102. } else if (sign === '>=') {
  103. return function (v) {
  104. v = v.split('.').map(parseSimpleInt)
  105. return compareSemver(v, version) >= 0
  106. }
  107. } else if (sign === '<') {
  108. return function (v) {
  109. v = v.split('.').map(parseSimpleInt)
  110. return compareSemver(version, v) > 0
  111. }
  112. } else {
  113. return function (v) {
  114. v = v.split('.').map(parseSimpleInt)
  115. return compareSemver(version, v) >= 0
  116. }
  117. }
  118. }
  119. function parseSimpleInt(x) {
  120. return parseInt(x)
  121. }
  122. function compare(a, b) {
  123. if (a < b) return -1
  124. if (a > b) return +1
  125. return 0
  126. }
  127. function compareSemver(a, b) {
  128. return (
  129. compare(parseInt(a[0]), parseInt(b[0])) ||
  130. compare(parseInt(a[1] || '0'), parseInt(b[1] || '0')) ||
  131. compare(parseInt(a[2] || '0'), parseInt(b[2] || '0'))
  132. )
  133. }
  134. // this follows the npm-like semver behavior
  135. function semverFilterLoose(operator, range) {
  136. range = range.split('.').map(parseSimpleInt)
  137. if (typeof range[1] === 'undefined') {
  138. range[1] = 'x'
  139. }
  140. // ignore any patch version because we only return minor versions
  141. // range[2] = 'x'
  142. switch (operator) {
  143. case '<=':
  144. return function (version) {
  145. version = version.split('.').map(parseSimpleInt)
  146. return compareSemverLoose(version, range) <= 0
  147. }
  148. case '>=':
  149. default:
  150. return function (version) {
  151. version = version.split('.').map(parseSimpleInt)
  152. return compareSemverLoose(version, range) >= 0
  153. }
  154. }
  155. }
  156. // this follows the npm-like semver behavior
  157. function compareSemverLoose(version, range) {
  158. if (version[0] !== range[0]) {
  159. return version[0] < range[0] ? -1 : +1
  160. }
  161. if (range[1] === 'x') {
  162. return 0
  163. }
  164. if (version[1] !== range[1]) {
  165. return version[1] < range[1] ? -1 : +1
  166. }
  167. return 0
  168. }
  169. function resolveVersion(data, version) {
  170. if (data.versions.indexOf(version) !== -1) {
  171. return version
  172. } else if (browserslist.versionAliases[data.name][version]) {
  173. return browserslist.versionAliases[data.name][version]
  174. } else {
  175. return false
  176. }
  177. }
  178. function normalizeVersion(data, version) {
  179. var resolved = resolveVersion(data, version)
  180. if (resolved) {
  181. return resolved
  182. } else if (data.versions.length === 1) {
  183. return data.versions[0]
  184. } else {
  185. return false
  186. }
  187. }
  188. function filterByYear(since, context) {
  189. since = since / 1000
  190. return Object.keys(agents).reduce(function (selected, name) {
  191. var data = byName(name, context)
  192. if (!data) return selected
  193. var versions = Object.keys(data.releaseDate).filter(function (v) {
  194. var date = data.releaseDate[v]
  195. return date !== null && date >= since
  196. })
  197. return selected.concat(versions.map(nameMapper(data.name)))
  198. }, [])
  199. }
  200. function cloneData(data) {
  201. return {
  202. name: data.name,
  203. versions: data.versions,
  204. released: data.released,
  205. releaseDate: data.releaseDate
  206. }
  207. }
  208. function byName(name, context) {
  209. name = name.toLowerCase()
  210. name = browserslist.aliases[name] || name
  211. if (context.mobileToDesktop && browserslist.desktopNames[name]) {
  212. var desktop = browserslist.data[browserslist.desktopNames[name]]
  213. if (name === 'android') {
  214. return normalizeAndroidData(cloneData(browserslist.data[name]), desktop)
  215. } else {
  216. var cloned = cloneData(desktop)
  217. cloned.name = name
  218. return cloned
  219. }
  220. }
  221. return browserslist.data[name]
  222. }
  223. function normalizeAndroidVersions(androidVersions, chromeVersions) {
  224. var iFirstEvergreen = chromeVersions.indexOf(ANDROID_EVERGREEN_FIRST)
  225. return androidVersions
  226. .filter(function (version) {
  227. return /^(?:[2-4]\.|[34]$)/.test(version)
  228. })
  229. .concat(chromeVersions.slice(iFirstEvergreen))
  230. }
  231. function copyObject(obj) {
  232. var copy = {}
  233. for (var key in obj) {
  234. copy[key] = obj[key]
  235. }
  236. return copy
  237. }
  238. function normalizeAndroidData(android, chrome) {
  239. android.released = normalizeAndroidVersions(android.released, chrome.released)
  240. android.versions = normalizeAndroidVersions(android.versions, chrome.versions)
  241. android.releaseDate = copyObject(android.releaseDate)
  242. android.released.forEach(function (v) {
  243. if (android.releaseDate[v] === undefined) {
  244. android.releaseDate[v] = chrome.releaseDate[v]
  245. }
  246. })
  247. return android
  248. }
  249. function checkName(name, context) {
  250. var data = byName(name, context)
  251. if (!data) throw new BrowserslistError('Unknown browser ' + name)
  252. return data
  253. }
  254. function unknownQuery(query) {
  255. return new BrowserslistError(
  256. 'Unknown browser query `' +
  257. query +
  258. '`. ' +
  259. 'Maybe you are using old Browserslist or made typo in query.'
  260. )
  261. }
  262. // Adjusts last X versions queries for some mobile browsers,
  263. // where caniuse data jumps from a legacy version to the latest
  264. function filterJumps(list, name, nVersions, context) {
  265. var jump = 1
  266. switch (name) {
  267. case 'android':
  268. if (context.mobileToDesktop) return list
  269. var released = browserslist.data.chrome.released
  270. jump = released.length - released.indexOf(ANDROID_EVERGREEN_FIRST)
  271. break
  272. case 'op_mob':
  273. var latest = browserslist.data.op_mob.released.slice(-1)[0]
  274. jump = getMajor(latest) - OP_MOB_BLINK_FIRST + 1
  275. break
  276. default:
  277. return list
  278. }
  279. if (nVersions <= jump) {
  280. return list.slice(-1)
  281. }
  282. return list.slice(jump - 1 - nVersions)
  283. }
  284. function isSupported(flags, withPartial) {
  285. return (
  286. typeof flags === 'string' &&
  287. (flags.indexOf('y') >= 0 || (withPartial && flags.indexOf('a') >= 0))
  288. )
  289. }
  290. function resolve(queries, context) {
  291. return parseQueries(queries).reduce(function (result, node, index) {
  292. if (node.not && index === 0) {
  293. throw new BrowserslistError(
  294. 'Write any browsers query (for instance, `defaults`) ' +
  295. 'before `' +
  296. node.query +
  297. '`'
  298. )
  299. }
  300. var type = QUERIES[node.type]
  301. var array = type.select.call(browserslist, context, node).map(function (j) {
  302. var parts = j.split(' ')
  303. if (parts[1] === '0') {
  304. return parts[0] + ' ' + byName(parts[0], context).versions[0]
  305. } else {
  306. return j
  307. }
  308. })
  309. if (node.compose === 'and') {
  310. if (node.not) {
  311. return result.filter(function (j) {
  312. return array.indexOf(j) === -1
  313. })
  314. } else {
  315. return result.filter(function (j) {
  316. return array.indexOf(j) !== -1
  317. })
  318. }
  319. } else {
  320. if (node.not) {
  321. var filter = {}
  322. array.forEach(function (j) {
  323. filter[j] = true
  324. })
  325. return result.filter(function (j) {
  326. return !filter[j]
  327. })
  328. }
  329. return result.concat(array)
  330. }
  331. }, [])
  332. }
  333. function prepareOpts(opts) {
  334. if (typeof opts === 'undefined') opts = {}
  335. if (typeof opts.path === 'undefined') {
  336. opts.path = path.resolve ? path.resolve('.') : '.'
  337. }
  338. return opts
  339. }
  340. function prepareQueries(queries, opts) {
  341. if (typeof queries === 'undefined' || queries === null) {
  342. var config = browserslist.loadConfig(opts)
  343. if (config) {
  344. queries = config
  345. } else {
  346. queries = browserslist.defaults
  347. }
  348. }
  349. return queries
  350. }
  351. function checkQueries(queries) {
  352. if (!(typeof queries === 'string' || Array.isArray(queries))) {
  353. throw new BrowserslistError(
  354. 'Browser queries must be an array or string. Got ' + typeof queries + '.'
  355. )
  356. }
  357. }
  358. var cache = {}
  359. var parseCache = {}
  360. function browserslist(queries, opts) {
  361. opts = prepareOpts(opts)
  362. queries = prepareQueries(queries, opts)
  363. checkQueries(queries)
  364. var needsPath = parseQueries(queries).some(function (node) {
  365. return QUERIES[node.type].needsPath
  366. })
  367. var context = {
  368. ignoreUnknownVersions: opts.ignoreUnknownVersions,
  369. dangerousExtend: opts.dangerousExtend,
  370. throwOnMissing: opts.throwOnMissing,
  371. mobileToDesktop: opts.mobileToDesktop,
  372. env: opts.env
  373. }
  374. // Removing to avoid using context.path without marking query as needsPath
  375. if (needsPath) {
  376. context.path = opts.path
  377. }
  378. env.oldDataWarning(browserslist.data)
  379. var stats = env.getStat(opts, browserslist.data)
  380. if (stats) {
  381. context.customUsage = {}
  382. for (var browser in stats) {
  383. fillUsage(context.customUsage, browser, stats[browser])
  384. }
  385. }
  386. var cacheKey = JSON.stringify([queries, context])
  387. if (cache[cacheKey]) return cache[cacheKey]
  388. var result = uniq(resolve(queries, context)).sort(function (name1, name2) {
  389. name1 = name1.split(' ')
  390. name2 = name2.split(' ')
  391. if (name1[0] === name2[0]) {
  392. // assumptions on caniuse data
  393. // 1) version ranges never overlaps
  394. // 2) if version is not a range, it never contains `-`
  395. var version1 = name1[1].split('-')[0]
  396. var version2 = name2[1].split('-')[0]
  397. return compareSemver(version2.split('.'), version1.split('.'))
  398. } else {
  399. return compare(name1[0], name2[0])
  400. }
  401. })
  402. if (!env.env.BROWSERSLIST_DISABLE_CACHE) {
  403. cache[cacheKey] = result
  404. }
  405. return result
  406. }
  407. function parseQueries(queries) {
  408. var cacheKey = JSON.stringify(queries)
  409. if (cacheKey in parseCache) return parseCache[cacheKey]
  410. var result = parseWithoutCache(QUERIES, queries)
  411. if (!env.env.BROWSERSLIST_DISABLE_CACHE) {
  412. parseCache[cacheKey] = result
  413. }
  414. return result
  415. }
  416. function loadCustomUsage(context, config) {
  417. var stats = env.loadStat(context, config, browserslist.data)
  418. if (stats) {
  419. context.customUsage = {}
  420. for (var browser in stats) {
  421. fillUsage(context.customUsage, browser, stats[browser])
  422. }
  423. }
  424. if (!context.customUsage) {
  425. throw new BrowserslistError('Custom usage statistics was not provided')
  426. }
  427. return context.customUsage
  428. }
  429. browserslist.parse = function (queries, opts) {
  430. opts = prepareOpts(opts)
  431. queries = prepareQueries(queries, opts)
  432. checkQueries(queries)
  433. return parseQueries(queries)
  434. }
  435. // Will be filled by Can I Use data below
  436. browserslist.cache = {}
  437. browserslist.data = {}
  438. browserslist.usage = {
  439. global: {},
  440. custom: null
  441. }
  442. // Default browsers query
  443. browserslist.defaults = ['> 0.5%', 'last 2 versions', 'Firefox ESR', 'not dead']
  444. // Browser names aliases
  445. browserslist.aliases = {
  446. fx: 'firefox',
  447. ff: 'firefox',
  448. ios: 'ios_saf',
  449. explorer: 'ie',
  450. blackberry: 'bb',
  451. explorermobile: 'ie_mob',
  452. operamini: 'op_mini',
  453. operamobile: 'op_mob',
  454. chromeandroid: 'and_chr',
  455. firefoxandroid: 'and_ff',
  456. ucandroid: 'and_uc',
  457. qqandroid: 'and_qq'
  458. }
  459. // Can I Use only provides a few versions for some browsers (e.g. and_chr).
  460. // Fallback to a similar browser for unknown versions
  461. // Note op_mob is not included as its chromium versions are not in sync with Opera desktop
  462. browserslist.desktopNames = {
  463. and_chr: 'chrome',
  464. and_ff: 'firefox',
  465. ie_mob: 'ie',
  466. android: 'chrome' // has extra processing logic
  467. }
  468. // Aliases to work with joined versions like `ios_saf 7.0-7.1`
  469. browserslist.versionAliases = {}
  470. browserslist.clearCaches = env.clearCaches
  471. browserslist.parseConfig = env.parseConfig
  472. browserslist.readConfig = env.readConfig
  473. browserslist.findConfigFile = env.findConfigFile
  474. browserslist.findConfig = env.findConfig
  475. browserslist.loadConfig = env.loadConfig
  476. browserslist.coverage = function (browsers, stats) {
  477. var data
  478. if (typeof stats === 'undefined') {
  479. data = browserslist.usage.global
  480. } else if (stats === 'my stats') {
  481. var opts = {}
  482. opts.path = path.resolve ? path.resolve('.') : '.'
  483. var customStats = env.getStat(opts)
  484. if (!customStats) {
  485. throw new BrowserslistError('Custom usage statistics was not provided')
  486. }
  487. data = {}
  488. for (var browser in customStats) {
  489. fillUsage(data, browser, customStats[browser])
  490. }
  491. } else if (typeof stats === 'string') {
  492. if (stats.length > 2) {
  493. stats = stats.toLowerCase()
  494. } else {
  495. stats = stats.toUpperCase()
  496. }
  497. env.loadCountry(browserslist.usage, stats, browserslist.data)
  498. data = browserslist.usage[stats]
  499. } else {
  500. if ('dataByBrowser' in stats) {
  501. stats = stats.dataByBrowser
  502. }
  503. data = {}
  504. for (var name in stats) {
  505. for (var version in stats[name]) {
  506. data[name + ' ' + version] = stats[name][version]
  507. }
  508. }
  509. }
  510. return browsers.reduce(function (all, i) {
  511. var usage = data[i]
  512. if (usage === undefined) {
  513. usage = data[i.replace(/ \S+$/, ' 0')]
  514. }
  515. return all + (usage || 0)
  516. }, 0)
  517. }
  518. function nodeQuery(context, node) {
  519. var matched = browserslist.nodeVersions.filter(function (i) {
  520. return isVersionsMatch(i, node.version)
  521. })
  522. if (matched.length === 0) {
  523. if (context.ignoreUnknownVersions) {
  524. return []
  525. } else {
  526. throw new BrowserslistError(
  527. 'Unknown version ' + node.version + ' of Node.js'
  528. )
  529. }
  530. }
  531. return ['node ' + matched[matched.length - 1]]
  532. }
  533. function sinceQuery(context, node) {
  534. var year = parseInt(node.year)
  535. var month = parseInt(node.month || '01') - 1
  536. var day = parseInt(node.day || '01')
  537. return filterByYear(Date.UTC(year, month, day, 0, 0, 0), context)
  538. }
  539. function bbmTransform(bbmVersions) {
  540. var browsers = {
  541. chrome: 'chrome',
  542. chrome_android: 'and_chr',
  543. edge: 'edge',
  544. firefox: 'firefox',
  545. firefox_android: 'and_ff',
  546. safari: 'safari',
  547. safari_ios: 'ios_saf',
  548. webview_android: 'android',
  549. samsunginternet_android: 'samsung',
  550. opera_android: 'op_mob',
  551. opera: 'opera',
  552. qq_android: 'and_qq',
  553. uc_android: 'and_uc',
  554. kai_os: 'kaios'
  555. }
  556. return bbmVersions
  557. .filter(function (version) {
  558. return Object.keys(browsers).indexOf(version.browser) !== -1
  559. })
  560. .map(function (version) {
  561. return browsers[version.browser] + ' >= ' + version.version
  562. })
  563. }
  564. function coverQuery(context, node) {
  565. var coverage = parseFloat(node.coverage)
  566. var usage = browserslist.usage.global
  567. if (node.place) {
  568. if (node.place.match(/^my\s+stats$/i)) {
  569. if (!context.customUsage) {
  570. throw new BrowserslistError('Custom usage statistics was not provided')
  571. }
  572. usage = context.customUsage
  573. } else {
  574. var place
  575. if (node.place.length === 2) {
  576. place = node.place.toUpperCase()
  577. } else {
  578. place = node.place.toLowerCase()
  579. }
  580. env.loadCountry(browserslist.usage, place, browserslist.data)
  581. usage = browserslist.usage[place]
  582. }
  583. } else if (node.config) {
  584. usage = loadCustomUsage(context, node.config)
  585. }
  586. var versions = Object.keys(usage).sort(function (a, b) {
  587. return usage[b] - usage[a]
  588. })
  589. var covered = 0
  590. var result = []
  591. var version
  592. for (var i = 0; i < versions.length; i++) {
  593. version = versions[i]
  594. if (usage[version] === 0) break
  595. covered += usage[version]
  596. result.push(version)
  597. if (covered >= coverage) break
  598. }
  599. return result
  600. }
  601. var QUERIES = {
  602. last_major_versions: {
  603. matches: ['versions'],
  604. regexp: /^last\s+(\d+)\s+major\s+versions?$/i,
  605. select: function (context, node) {
  606. return Object.keys(agents).reduce(function (selected, name) {
  607. var data = byName(name, context)
  608. if (!data) return selected
  609. var list = getMajorVersions(data.released, node.versions)
  610. list = list.map(nameMapper(data.name))
  611. list = filterJumps(list, data.name, node.versions, context)
  612. return selected.concat(list)
  613. }, [])
  614. }
  615. },
  616. last_versions: {
  617. matches: ['versions'],
  618. regexp: /^last\s+(\d+)\s+versions?$/i,
  619. select: function (context, node) {
  620. return Object.keys(agents).reduce(function (selected, name) {
  621. var data = byName(name, context)
  622. if (!data) return selected
  623. var list = data.released.slice(-node.versions)
  624. list = list.map(nameMapper(data.name))
  625. list = filterJumps(list, data.name, node.versions, context)
  626. return selected.concat(list)
  627. }, [])
  628. }
  629. },
  630. last_electron_major_versions: {
  631. matches: ['versions'],
  632. regexp: /^last\s+(\d+)\s+electron\s+major\s+versions?$/i,
  633. select: function (context, node) {
  634. var validVersions = getMajorVersions(Object.keys(e2c), node.versions)
  635. return validVersions.map(function (i) {
  636. return 'chrome ' + e2c[i]
  637. })
  638. }
  639. },
  640. last_node_major_versions: {
  641. matches: ['versions'],
  642. regexp: /^last\s+(\d+)\s+node\s+major\s+versions?$/i,
  643. select: function (context, node) {
  644. return getMajorVersions(browserslist.nodeVersions, node.versions).map(
  645. function (version) {
  646. return 'node ' + version
  647. }
  648. )
  649. }
  650. },
  651. last_browser_major_versions: {
  652. matches: ['versions', 'browser'],
  653. regexp: /^last\s+(\d+)\s+(\w+)\s+major\s+versions?$/i,
  654. select: function (context, node) {
  655. var data = checkName(node.browser, context)
  656. var validVersions = getMajorVersions(data.released, node.versions)
  657. var list = validVersions.map(nameMapper(data.name))
  658. list = filterJumps(list, data.name, node.versions, context)
  659. return list
  660. }
  661. },
  662. last_electron_versions: {
  663. matches: ['versions'],
  664. regexp: /^last\s+(\d+)\s+electron\s+versions?$/i,
  665. select: function (context, node) {
  666. return Object.keys(e2c)
  667. .slice(-node.versions)
  668. .map(function (i) {
  669. return 'chrome ' + e2c[i]
  670. })
  671. }
  672. },
  673. last_node_versions: {
  674. matches: ['versions'],
  675. regexp: /^last\s+(\d+)\s+node\s+versions?$/i,
  676. select: function (context, node) {
  677. return browserslist.nodeVersions
  678. .slice(-node.versions)
  679. .map(function (version) {
  680. return 'node ' + version
  681. })
  682. }
  683. },
  684. last_browser_versions: {
  685. matches: ['versions', 'browser'],
  686. regexp: /^last\s+(\d+)\s+(\w+)\s+versions?$/i,
  687. select: function (context, node) {
  688. var data = checkName(node.browser, context)
  689. var list = data.released.slice(-node.versions).map(nameMapper(data.name))
  690. list = filterJumps(list, data.name, node.versions, context)
  691. return list
  692. }
  693. },
  694. unreleased_versions: {
  695. matches: [],
  696. regexp: /^unreleased\s+versions$/i,
  697. select: function (context) {
  698. return Object.keys(agents).reduce(function (selected, name) {
  699. var data = byName(name, context)
  700. if (!data) return selected
  701. var list = data.versions.filter(function (v) {
  702. return data.released.indexOf(v) === -1
  703. })
  704. list = list.map(nameMapper(data.name))
  705. return selected.concat(list)
  706. }, [])
  707. }
  708. },
  709. unreleased_electron_versions: {
  710. matches: [],
  711. regexp: /^unreleased\s+electron\s+versions?$/i,
  712. select: function () {
  713. return []
  714. }
  715. },
  716. unreleased_browser_versions: {
  717. matches: ['browser'],
  718. regexp: /^unreleased\s+(\w+)\s+versions?$/i,
  719. select: function (context, node) {
  720. var data = checkName(node.browser, context)
  721. return data.versions
  722. .filter(function (v) {
  723. return data.released.indexOf(v) === -1
  724. })
  725. .map(nameMapper(data.name))
  726. }
  727. },
  728. last_years: {
  729. matches: ['years'],
  730. regexp: /^last\s+((\d+\.)?\d+)\s+years?$/i,
  731. select: function (context, node) {
  732. return filterByYear(Date.now() - YEAR * node.years, context)
  733. }
  734. },
  735. since_y: {
  736. matches: ['year'],
  737. regexp: /^since (\d+)$/i,
  738. select: sinceQuery
  739. },
  740. since_y_m: {
  741. matches: ['year', 'month'],
  742. regexp: /^since (\d+)-(\d+)$/i,
  743. select: sinceQuery
  744. },
  745. since_y_m_d: {
  746. matches: ['year', 'month', 'day'],
  747. regexp: /^since (\d+)-(\d+)-(\d+)$/i,
  748. select: sinceQuery
  749. },
  750. baseline: {
  751. matches: ['year', 'availability', 'date', 'downstream', 'kaios'],
  752. // Matches:
  753. // baseline 2024
  754. // baseline newly available
  755. // baseline widely available
  756. // baseline widely available on 2024-06-01
  757. // ...with downstream
  758. // ...including kaios
  759. regexp:
  760. /^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,
  761. select: function (context, node) {
  762. var baselineVersions
  763. var includeDownstream = !!node.downstream
  764. var includeKaiOS = !!node.kaios
  765. if (node.availability === 'newly' && node.date) {
  766. throw new BrowserslistError(
  767. 'Using newly available with a date is not supported, please use "widely available on YYYY-MM-DD" and add 30 months to the date you specified.'
  768. )
  769. }
  770. if (node.year) {
  771. baselineVersions = bbm.getCompatibleVersions({
  772. targetYear: node.year,
  773. includeDownstreamBrowsers: includeDownstream,
  774. includeKaiOS: includeKaiOS
  775. })
  776. } else if (node.date) {
  777. baselineVersions = bbm.getCompatibleVersions({
  778. widelyAvailableOnDate: node.date,
  779. includeDownstreamBrowsers: includeDownstream,
  780. includeKaiOS: includeKaiOS
  781. })
  782. } else if (node.availability === 'newly') {
  783. var future30months = new Date().setMonth(new Date().getMonth() + 30)
  784. baselineVersions = bbm.getCompatibleVersions({
  785. widelyAvailableOnDate: future30months,
  786. includeDownstreamBrowsers: includeDownstream,
  787. includeKaiOS: includeKaiOS
  788. })
  789. } else {
  790. baselineVersions = bbm.getCompatibleVersions({
  791. includeDownstreamBrowsers: includeDownstream,
  792. includeKaiOS: includeKaiOS
  793. })
  794. }
  795. return resolve(bbmTransform(baselineVersions), context)
  796. }
  797. },
  798. popularity: {
  799. matches: ['sign', 'popularity'],
  800. regexp: /^(>=?|<=?)\s*(\d+|\d+\.\d+|\.\d+)%$/,
  801. select: function (context, node) {
  802. var popularity = parseFloat(node.popularity)
  803. var usage = browserslist.usage.global
  804. return Object.keys(usage).reduce(function (result, version) {
  805. if (node.sign === '>') {
  806. if (usage[version] > popularity) {
  807. result.push(version)
  808. }
  809. } else if (node.sign === '<') {
  810. if (usage[version] < popularity) {
  811. result.push(version)
  812. }
  813. } else if (node.sign === '<=') {
  814. if (usage[version] <= popularity) {
  815. result.push(version)
  816. }
  817. } else if (usage[version] >= popularity) {
  818. result.push(version)
  819. }
  820. return result
  821. }, [])
  822. }
  823. },
  824. popularity_in_my_stats: {
  825. matches: ['sign', 'popularity'],
  826. regexp: /^(>=?|<=?)\s*(\d+|\d+\.\d+|\.\d+)%\s+in\s+my\s+stats$/,
  827. select: function (context, node) {
  828. var popularity = parseFloat(node.popularity)
  829. if (!context.customUsage) {
  830. throw new BrowserslistError('Custom usage statistics was not provided')
  831. }
  832. var usage = context.customUsage
  833. return Object.keys(usage).reduce(function (result, version) {
  834. var percentage = usage[version]
  835. if (percentage == null) {
  836. return result
  837. }
  838. if (node.sign === '>') {
  839. if (percentage > popularity) {
  840. result.push(version)
  841. }
  842. } else if (node.sign === '<') {
  843. if (percentage < popularity) {
  844. result.push(version)
  845. }
  846. } else if (node.sign === '<=') {
  847. if (percentage <= popularity) {
  848. result.push(version)
  849. }
  850. } else if (percentage >= popularity) {
  851. result.push(version)
  852. }
  853. return result
  854. }, [])
  855. }
  856. },
  857. popularity_in_config_stats: {
  858. matches: ['sign', 'popularity', 'config'],
  859. regexp: /^(>=?|<=?)\s*(\d+|\d+\.\d+|\.\d+)%\s+in\s+(\S+)\s+stats$/,
  860. select: function (context, node) {
  861. var popularity = parseFloat(node.popularity)
  862. var usage = loadCustomUsage(context, node.config)
  863. return Object.keys(usage).reduce(function (result, version) {
  864. var percentage = usage[version]
  865. if (percentage == null) {
  866. return result
  867. }
  868. if (node.sign === '>') {
  869. if (percentage > popularity) {
  870. result.push(version)
  871. }
  872. } else if (node.sign === '<') {
  873. if (percentage < popularity) {
  874. result.push(version)
  875. }
  876. } else if (node.sign === '<=') {
  877. if (percentage <= popularity) {
  878. result.push(version)
  879. }
  880. } else if (percentage >= popularity) {
  881. result.push(version)
  882. }
  883. return result
  884. }, [])
  885. }
  886. },
  887. popularity_in_place: {
  888. matches: ['sign', 'popularity', 'place'],
  889. regexp: /^(>=?|<=?)\s*(\d+|\d+\.\d+|\.\d+)%\s+in\s+((alt-)?\w\w)$/,
  890. select: function (context, node) {
  891. var popularity = parseFloat(node.popularity)
  892. var place = node.place
  893. if (place.length === 2) {
  894. place = place.toUpperCase()
  895. } else {
  896. place = place.toLowerCase()
  897. }
  898. env.loadCountry(browserslist.usage, place, browserslist.data)
  899. var usage = browserslist.usage[place]
  900. return Object.keys(usage).reduce(function (result, version) {
  901. var percentage = usage[version]
  902. if (percentage == null) {
  903. return result
  904. }
  905. if (node.sign === '>') {
  906. if (percentage > popularity) {
  907. result.push(version)
  908. }
  909. } else if (node.sign === '<') {
  910. if (percentage < popularity) {
  911. result.push(version)
  912. }
  913. } else if (node.sign === '<=') {
  914. if (percentage <= popularity) {
  915. result.push(version)
  916. }
  917. } else if (percentage >= popularity) {
  918. result.push(version)
  919. }
  920. return result
  921. }, [])
  922. }
  923. },
  924. cover: {
  925. matches: ['coverage'],
  926. regexp: /^cover\s+(\d+|\d+\.\d+|\.\d+)%$/i,
  927. select: coverQuery
  928. },
  929. cover_in: {
  930. matches: ['coverage', 'place'],
  931. regexp: /^cover\s+(\d+|\d+\.\d+|\.\d+)%\s+in\s+(my\s+stats|(alt-)?\w\w)$/i,
  932. select: coverQuery
  933. },
  934. cover_config: {
  935. matches: ['coverage', 'config'],
  936. regexp: /^cover\s+(\d+|\d+\.\d+|\.\d+)%\s+in\s+(\S+)\s+stats$/i,
  937. select: coverQuery
  938. },
  939. supports: {
  940. matches: ['supportType', 'feature'],
  941. regexp: /^(?:(fully|partially)\s+)?supports\s+([\w-]+)$/,
  942. select: function (context, node) {
  943. env.loadFeature(browserslist.cache, node.feature)
  944. var withPartial = node.supportType !== 'fully'
  945. var features = browserslist.cache[node.feature]
  946. var result = []
  947. for (var name in features) {
  948. var data = byName(name, context)
  949. // Only check desktop when latest released mobile has support
  950. var iMax = data.released.length - 1
  951. while (iMax >= 0) {
  952. if (data.released[iMax] in features[name]) break
  953. iMax--
  954. }
  955. var checkDesktop =
  956. context.mobileToDesktop &&
  957. name in browserslist.desktopNames &&
  958. isSupported(features[name][data.released[iMax]], withPartial)
  959. data.versions.forEach(function (version) {
  960. var flags = features[name][version]
  961. if (flags === undefined && checkDesktop) {
  962. flags = features[browserslist.desktopNames[name]][version]
  963. }
  964. if (isSupported(flags, withPartial)) {
  965. result.push(name + ' ' + version)
  966. }
  967. })
  968. }
  969. return result
  970. }
  971. },
  972. electron_range: {
  973. matches: ['from', 'to'],
  974. regexp: /^electron\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  975. select: function (context, node) {
  976. var fromToUse = normalizeElectron(node.from)
  977. var toToUse = normalizeElectron(node.to)
  978. var from = parseFloat(node.from)
  979. var to = parseFloat(node.to)
  980. if (!e2c[fromToUse]) {
  981. throw new BrowserslistError('Unknown version ' + from + ' of electron')
  982. }
  983. if (!e2c[toToUse]) {
  984. throw new BrowserslistError('Unknown version ' + to + ' of electron')
  985. }
  986. return Object.keys(e2c)
  987. .filter(function (i) {
  988. var parsed = parseFloat(i)
  989. return parsed >= from && parsed <= to
  990. })
  991. .map(function (i) {
  992. return 'chrome ' + e2c[i]
  993. })
  994. }
  995. },
  996. node_range: {
  997. matches: ['from', 'to'],
  998. regexp: /^node\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  999. select: function (context, node) {
  1000. return browserslist.nodeVersions
  1001. .filter(semverFilterLoose('>=', node.from))
  1002. .filter(semverFilterLoose('<=', node.to))
  1003. .map(function (v) {
  1004. return 'node ' + v
  1005. })
  1006. }
  1007. },
  1008. browser_range: {
  1009. matches: ['browser', 'from', 'to'],
  1010. regexp: /^(\w+)\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  1011. select: function (context, node) {
  1012. var data = checkName(node.browser, context)
  1013. var from = parseFloat(normalizeVersion(data, node.from) || node.from)
  1014. var to = parseFloat(normalizeVersion(data, node.to) || node.to)
  1015. function filter(v) {
  1016. var parsed = parseFloat(v)
  1017. return parsed >= from && parsed <= to
  1018. }
  1019. return data.released.filter(filter).map(nameMapper(data.name))
  1020. }
  1021. },
  1022. electron_ray: {
  1023. matches: ['sign', 'version'],
  1024. regexp: /^electron\s*(>=?|<=?)\s*([\d.]+)$/i,
  1025. select: function (context, node) {
  1026. var versionToUse = normalizeElectron(node.version)
  1027. return Object.keys(e2c)
  1028. .filter(generateFilter(node.sign, versionToUse))
  1029. .map(function (i) {
  1030. return 'chrome ' + e2c[i]
  1031. })
  1032. }
  1033. },
  1034. node_ray: {
  1035. matches: ['sign', 'version'],
  1036. regexp: /^node\s*(>=?|<=?)\s*([\d.]+)$/i,
  1037. select: function (context, node) {
  1038. return browserslist.nodeVersions
  1039. .filter(generateSemverFilter(node.sign, node.version))
  1040. .map(function (v) {
  1041. return 'node ' + v
  1042. })
  1043. }
  1044. },
  1045. browser_ray: {
  1046. matches: ['browser', 'sign', 'version'],
  1047. regexp: /^(\w+)\s*(>=?|<=?)\s*([\d.]+|esr)$/i,
  1048. select: function (context, node) {
  1049. var version = node.version
  1050. var data = checkName(node.browser, context)
  1051. var alias = browserslist.versionAliases[data.name][version.toLowerCase()]
  1052. if (alias) version = alias
  1053. if (!/[\d.]+/.test(version)) throw new BrowserslistError('Unknown version ' + version + ' of ' + node.browser);
  1054. return data.released
  1055. .filter(generateFilter(node.sign, version))
  1056. .map(function (v) {
  1057. return data.name + ' ' + v
  1058. })
  1059. }
  1060. },
  1061. firefox_esr: {
  1062. matches: [],
  1063. regexp: /^(firefox|ff|fx)\s+esr$/i,
  1064. select: function () {
  1065. return ['firefox ' + FIREFOX_ESR_VERSION]
  1066. }
  1067. },
  1068. opera_mini_all: {
  1069. matches: [],
  1070. regexp: /(operamini|op_mini)\s+all/i,
  1071. select: function () {
  1072. return ['op_mini all']
  1073. }
  1074. },
  1075. electron_version: {
  1076. matches: ['version'],
  1077. regexp: /^electron\s+([\d.]+)$/i,
  1078. select: function (context, node) {
  1079. var versionToUse = normalizeElectron(node.version)
  1080. var chrome = e2c[versionToUse]
  1081. if (!chrome) {
  1082. throw new BrowserslistError(
  1083. 'Unknown version ' + node.version + ' of electron'
  1084. )
  1085. }
  1086. return ['chrome ' + chrome]
  1087. }
  1088. },
  1089. node_major_version: {
  1090. matches: ['version'],
  1091. regexp: /^node\s+(\d+)$/i,
  1092. select: nodeQuery
  1093. },
  1094. node_minor_version: {
  1095. matches: ['version'],
  1096. regexp: /^node\s+(\d+\.\d+)$/i,
  1097. select: nodeQuery
  1098. },
  1099. node_patch_version: {
  1100. matches: ['version'],
  1101. regexp: /^node\s+(\d+\.\d+\.\d+)$/i,
  1102. select: nodeQuery
  1103. },
  1104. current_node: {
  1105. matches: [],
  1106. regexp: /^current\s+node$/i,
  1107. select: function (context) {
  1108. return [env.currentNode(resolve, context)]
  1109. }
  1110. },
  1111. maintained_node: {
  1112. matches: [],
  1113. regexp: /^maintained\s+node\s+versions$/i,
  1114. select: function (context) {
  1115. var now = Date.now()
  1116. var queries = Object.keys(jsEOL)
  1117. .filter(function (key) {
  1118. return (
  1119. now < Date.parse(jsEOL[key].end) &&
  1120. now > Date.parse(jsEOL[key].start) &&
  1121. isEolReleased(key)
  1122. )
  1123. })
  1124. .map(function (key) {
  1125. return 'node ' + key.slice(1)
  1126. })
  1127. return resolve(queries, context)
  1128. }
  1129. },
  1130. phantomjs_1_9: {
  1131. matches: [],
  1132. regexp: /^phantomjs\s+1.9$/i,
  1133. select: function () {
  1134. return ['safari 5']
  1135. }
  1136. },
  1137. phantomjs_2_1: {
  1138. matches: [],
  1139. regexp: /^phantomjs\s+2.1$/i,
  1140. select: function () {
  1141. return ['safari 6']
  1142. }
  1143. },
  1144. browser_version: {
  1145. matches: ['browser', 'version'],
  1146. regexp: /^(\w+)\s+(tp|[\d.]+)$/i,
  1147. select: function (context, node) {
  1148. var version = node.version
  1149. if (/^tp$/i.test(version)) version = 'TP'
  1150. var data = checkName(node.browser, context)
  1151. var alias = normalizeVersion(data, version)
  1152. if (alias) {
  1153. version = alias
  1154. } else {
  1155. if (version.indexOf('.') === -1) {
  1156. alias = version + '.0'
  1157. } else {
  1158. alias = version.replace(/\.0$/, '')
  1159. }
  1160. alias = normalizeVersion(data, alias)
  1161. if (alias) {
  1162. version = alias
  1163. } else if (context.ignoreUnknownVersions) {
  1164. return []
  1165. } else {
  1166. throw new BrowserslistError(
  1167. 'Unknown version ' + version + ' of ' + node.browser
  1168. )
  1169. }
  1170. }
  1171. return [data.name + ' ' + version]
  1172. }
  1173. },
  1174. browserslist_config: {
  1175. matches: [],
  1176. regexp: /^browserslist config$/i,
  1177. needsPath: true,
  1178. select: function (context) {
  1179. return browserslist(undefined, context)
  1180. }
  1181. },
  1182. extends: {
  1183. matches: ['config'],
  1184. regexp: /^extends (.+)$/i,
  1185. needsPath: true,
  1186. select: function (context, node) {
  1187. return resolve(env.loadQueries(context, node.config), context)
  1188. }
  1189. },
  1190. defaults: {
  1191. matches: [],
  1192. regexp: /^defaults$/i,
  1193. select: function (context) {
  1194. return resolve(browserslist.defaults, context)
  1195. }
  1196. },
  1197. dead: {
  1198. matches: [],
  1199. regexp: /^dead$/i,
  1200. select: function (context) {
  1201. var dead = [
  1202. 'Baidu >= 0',
  1203. 'ie <= 11',
  1204. 'ie_mob <= 11',
  1205. 'bb <= 10',
  1206. 'op_mob <= 12.1',
  1207. 'samsung 4'
  1208. ]
  1209. return resolve(dead, context)
  1210. }
  1211. },
  1212. unknown: {
  1213. matches: [],
  1214. regexp: /^(\w+)$/i,
  1215. select: function (context, node) {
  1216. if (byName(node.query, context)) {
  1217. throw new BrowserslistError(
  1218. 'Specify versions in Browserslist query for browser ' + node.query
  1219. )
  1220. } else {
  1221. throw unknownQuery(node.query)
  1222. }
  1223. }
  1224. }
  1225. }
  1226. // Get and convert Can I Use data
  1227. ;(function () {
  1228. for (var name in agents) {
  1229. var browser = agents[name]
  1230. browserslist.data[name] = {
  1231. name: name,
  1232. versions: normalize(agents[name].versions),
  1233. released: normalize(agents[name].versions.slice(0, -3)),
  1234. releaseDate: agents[name].release_date
  1235. }
  1236. fillUsage(browserslist.usage.global, name, browser.usage_global)
  1237. browserslist.versionAliases[name] = {}
  1238. for (var i = 0; i < browser.versions.length; i++) {
  1239. var full = browser.versions[i]
  1240. if (!full) continue
  1241. if (full.indexOf('-') !== -1) {
  1242. var interval = full.split('-')
  1243. for (var j = 0; j < interval.length; j++) {
  1244. browserslist.versionAliases[name][interval[j]] = full
  1245. }
  1246. }
  1247. }
  1248. }
  1249. browserslist.nodeVersions = jsReleases.map(function (release) {
  1250. return release.version
  1251. })
  1252. })()
  1253. browserslist.versionAliases.firefox.esr = FIREFOX_ESR_VERSION
  1254. module.exports = browserslist