index.js 38 KB

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