index.js 37 KB

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