index.js 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335
  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. suppressWarnings: true
  776. })
  777. } else if (node.date) {
  778. baselineVersions = bbm.getCompatibleVersions({
  779. widelyAvailableOnDate: node.date,
  780. includeDownstreamBrowsers: includeDownstream,
  781. includeKaiOS: includeKaiOS,
  782. suppressWarnings: true
  783. })
  784. } else if (node.availability === 'newly') {
  785. var future30months = new Date().setMonth(new Date().getMonth() + 30)
  786. baselineVersions = bbm.getCompatibleVersions({
  787. widelyAvailableOnDate: future30months,
  788. includeDownstreamBrowsers: includeDownstream,
  789. includeKaiOS: includeKaiOS,
  790. suppressWarnings: true
  791. })
  792. } else {
  793. baselineVersions = bbm.getCompatibleVersions({
  794. includeDownstreamBrowsers: includeDownstream,
  795. includeKaiOS: includeKaiOS,
  796. suppressWarnings: true
  797. })
  798. }
  799. return resolve(bbmTransform(baselineVersions), context)
  800. }
  801. },
  802. popularity: {
  803. matches: ['sign', 'popularity'],
  804. regexp: /^(>=?|<=?)\s*(\d+|\d+\.\d+|\.\d+)%$/,
  805. select: function (context, node) {
  806. var popularity = parseFloat(node.popularity)
  807. var usage = browserslist.usage.global
  808. return Object.keys(usage).reduce(function (result, version) {
  809. 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 (node.sign === '<=') {
  818. if (usage[version] <= popularity) {
  819. result.push(version)
  820. }
  821. } else if (usage[version] >= popularity) {
  822. result.push(version)
  823. }
  824. return result
  825. }, [])
  826. }
  827. },
  828. popularity_in_my_stats: {
  829. matches: ['sign', 'popularity'],
  830. regexp: /^(>=?|<=?)\s*(\d+|\d+\.\d+|\.\d+)%\s+in\s+my\s+stats$/,
  831. select: function (context, node) {
  832. var popularity = parseFloat(node.popularity)
  833. if (!context.customUsage) {
  834. throw new BrowserslistError('Custom usage statistics was not provided')
  835. }
  836. var usage = context.customUsage
  837. return Object.keys(usage).reduce(function (result, version) {
  838. var percentage = usage[version]
  839. if (percentage == null) {
  840. return result
  841. }
  842. 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 (node.sign === '<=') {
  851. if (percentage <= popularity) {
  852. result.push(version)
  853. }
  854. } else if (percentage >= popularity) {
  855. result.push(version)
  856. }
  857. return result
  858. }, [])
  859. }
  860. },
  861. popularity_in_config_stats: {
  862. matches: ['sign', 'popularity', 'config'],
  863. regexp: /^(>=?|<=?)\s*(\d+|\d+\.\d+|\.\d+)%\s+in\s+(\S+)\s+stats$/,
  864. select: function (context, node) {
  865. var popularity = parseFloat(node.popularity)
  866. var usage = loadCustomUsage(context, node.config)
  867. return Object.keys(usage).reduce(function (result, version) {
  868. var percentage = usage[version]
  869. if (percentage == null) {
  870. return result
  871. }
  872. 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 (node.sign === '<=') {
  881. if (percentage <= popularity) {
  882. result.push(version)
  883. }
  884. } else if (percentage >= popularity) {
  885. result.push(version)
  886. }
  887. return result
  888. }, [])
  889. }
  890. },
  891. popularity_in_place: {
  892. matches: ['sign', 'popularity', 'place'],
  893. regexp: /^(>=?|<=?)\s*(\d+|\d+\.\d+|\.\d+)%\s+in\s+((alt-)?\w\w)$/,
  894. select: function (context, node) {
  895. var popularity = parseFloat(node.popularity)
  896. var place = node.place
  897. if (place.length === 2) {
  898. place = place.toUpperCase()
  899. } else {
  900. place = place.toLowerCase()
  901. }
  902. env.loadCountry(browserslist.usage, place, browserslist.data)
  903. var usage = browserslist.usage[place]
  904. return Object.keys(usage).reduce(function (result, version) {
  905. var percentage = usage[version]
  906. if (percentage == null) {
  907. return result
  908. }
  909. 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 (node.sign === '<=') {
  918. if (percentage <= popularity) {
  919. result.push(version)
  920. }
  921. } else if (percentage >= popularity) {
  922. result.push(version)
  923. }
  924. return result
  925. }, [])
  926. }
  927. },
  928. cover: {
  929. matches: ['coverage'],
  930. regexp: /^cover\s+(\d+|\d+\.\d+|\.\d+)%$/i,
  931. select: coverQuery
  932. },
  933. cover_in: {
  934. matches: ['coverage', 'place'],
  935. regexp: /^cover\s+(\d+|\d+\.\d+|\.\d+)%\s+in\s+(my\s+stats|(alt-)?\w\w)$/i,
  936. select: coverQuery
  937. },
  938. cover_config: {
  939. matches: ['coverage', 'config'],
  940. regexp: /^cover\s+(\d+|\d+\.\d+|\.\d+)%\s+in\s+(\S+)\s+stats$/i,
  941. select: coverQuery
  942. },
  943. supports: {
  944. matches: ['supportType', 'feature'],
  945. regexp: /^(?:(fully|partially)\s+)?supports\s+([\w-]+)$/,
  946. select: function (context, node) {
  947. env.loadFeature(browserslist.cache, node.feature)
  948. var withPartial = node.supportType !== 'fully'
  949. var features = browserslist.cache[node.feature]
  950. var result = []
  951. for (var name in features) {
  952. var data = byName(name, context)
  953. // Only check desktop when latest released mobile has support
  954. var iMax = data.released.length - 1
  955. while (iMax >= 0) {
  956. if (data.released[iMax] in features[name]) break
  957. iMax--
  958. }
  959. var checkDesktop =
  960. context.mobileToDesktop &&
  961. name in browserslist.desktopNames &&
  962. isSupported(features[name][data.released[iMax]], withPartial)
  963. data.versions.forEach(function (version) {
  964. var flags = features[name][version]
  965. if (flags === undefined && checkDesktop) {
  966. flags = features[browserslist.desktopNames[name]][version]
  967. }
  968. if (isSupported(flags, withPartial)) {
  969. result.push(name + ' ' + version)
  970. }
  971. })
  972. }
  973. return result
  974. }
  975. },
  976. electron_range: {
  977. matches: ['from', 'to'],
  978. regexp: /^electron\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  979. select: function (context, node) {
  980. var fromToUse = normalizeElectron(node.from)
  981. var toToUse = normalizeElectron(node.to)
  982. var from = parseFloat(node.from)
  983. var to = parseFloat(node.to)
  984. if (!e2c[fromToUse]) {
  985. throw new BrowserslistError('Unknown version ' + from + ' of electron')
  986. }
  987. if (!e2c[toToUse]) {
  988. throw new BrowserslistError('Unknown version ' + to + ' of electron')
  989. }
  990. return Object.keys(e2c)
  991. .filter(function (i) {
  992. var parsed = parseFloat(i)
  993. return parsed >= from && parsed <= to
  994. })
  995. .map(function (i) {
  996. return 'chrome ' + e2c[i]
  997. })
  998. }
  999. },
  1000. node_range: {
  1001. matches: ['from', 'to'],
  1002. regexp: /^node\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  1003. select: function (context, node) {
  1004. return browserslist.nodeVersions
  1005. .filter(semverFilterLoose('>=', node.from))
  1006. .filter(semverFilterLoose('<=', node.to))
  1007. .map(function (v) {
  1008. return 'node ' + v
  1009. })
  1010. }
  1011. },
  1012. browser_range: {
  1013. matches: ['browser', 'from', 'to'],
  1014. regexp: /^(\w+)\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  1015. select: function (context, node) {
  1016. var data = checkName(node.browser, context)
  1017. var from = parseFloat(normalizeVersion(data, node.from) || node.from)
  1018. var to = parseFloat(normalizeVersion(data, node.to) || node.to)
  1019. function filter(v) {
  1020. var parsed = parseFloat(v)
  1021. return parsed >= from && parsed <= to
  1022. }
  1023. return data.released.filter(filter).map(nameMapper(data.name))
  1024. }
  1025. },
  1026. electron_ray: {
  1027. matches: ['sign', 'version'],
  1028. regexp: /^electron\s*(>=?|<=?)\s*([\d.]+)$/i,
  1029. select: function (context, node) {
  1030. var versionToUse = normalizeElectron(node.version)
  1031. return Object.keys(e2c)
  1032. .filter(generateFilter(node.sign, versionToUse))
  1033. .map(function (i) {
  1034. return 'chrome ' + e2c[i]
  1035. })
  1036. }
  1037. },
  1038. node_ray: {
  1039. matches: ['sign', 'version'],
  1040. regexp: /^node\s*(>=?|<=?)\s*([\d.]+)$/i,
  1041. select: function (context, node) {
  1042. return browserslist.nodeVersions
  1043. .filter(generateSemverFilter(node.sign, node.version))
  1044. .map(function (v) {
  1045. return 'node ' + v
  1046. })
  1047. }
  1048. },
  1049. browser_ray: {
  1050. matches: ['browser', 'sign', 'version'],
  1051. regexp: /^(\w+)\s*(>=?|<=?)\s*([\d.]+|esr)$/i,
  1052. select: function (context, node) {
  1053. var version = node.version
  1054. var data = checkName(node.browser, context)
  1055. var alias = browserslist.versionAliases[data.name][version.toLowerCase()]
  1056. if (alias) version = alias
  1057. if (!/[\d.]+/.test(version)) {
  1058. throw new BrowserslistError(
  1059. 'Unknown version ' + version + ' of ' + node.browser
  1060. )
  1061. }
  1062. return data.released
  1063. .filter(generateFilter(node.sign, version))
  1064. .map(function (v) {
  1065. return data.name + ' ' + v
  1066. })
  1067. }
  1068. },
  1069. firefox_esr: {
  1070. matches: [],
  1071. regexp: /^(firefox|ff|fx)\s+esr$/i,
  1072. select: function () {
  1073. return ['firefox ' + FIREFOX_ESR_VERSION]
  1074. }
  1075. },
  1076. opera_mini_all: {
  1077. matches: [],
  1078. regexp: /(operamini|op_mini)\s+all/i,
  1079. select: function () {
  1080. return ['op_mini all']
  1081. }
  1082. },
  1083. electron_version: {
  1084. matches: ['version'],
  1085. regexp: /^electron\s+([\d.]+)$/i,
  1086. select: function (context, node) {
  1087. var versionToUse = normalizeElectron(node.version)
  1088. var chrome = e2c[versionToUse]
  1089. if (!chrome) {
  1090. throw new BrowserslistError(
  1091. 'Unknown version ' + node.version + ' of electron'
  1092. )
  1093. }
  1094. return ['chrome ' + chrome]
  1095. }
  1096. },
  1097. node_major_version: {
  1098. matches: ['version'],
  1099. regexp: /^node\s+(\d+)$/i,
  1100. select: nodeQuery
  1101. },
  1102. node_minor_version: {
  1103. matches: ['version'],
  1104. regexp: /^node\s+(\d+\.\d+)$/i,
  1105. select: nodeQuery
  1106. },
  1107. node_patch_version: {
  1108. matches: ['version'],
  1109. regexp: /^node\s+(\d+\.\d+\.\d+)$/i,
  1110. select: nodeQuery
  1111. },
  1112. current_node: {
  1113. matches: [],
  1114. regexp: /^current\s+node$/i,
  1115. select: function (context) {
  1116. return [env.currentNode(resolve, context)]
  1117. }
  1118. },
  1119. maintained_node: {
  1120. matches: [],
  1121. regexp: /^maintained\s+node\s+versions$/i,
  1122. select: function (context) {
  1123. var now = Date.now()
  1124. var queries = Object.keys(jsEOL)
  1125. .filter(function (key) {
  1126. return (
  1127. now < Date.parse(jsEOL[key].end) &&
  1128. now > Date.parse(jsEOL[key].start) &&
  1129. isEolReleased(key)
  1130. )
  1131. })
  1132. .map(function (key) {
  1133. return 'node ' + key.slice(1)
  1134. })
  1135. return resolve(queries, context)
  1136. }
  1137. },
  1138. phantomjs_1_9: {
  1139. matches: [],
  1140. regexp: /^phantomjs\s+1.9$/i,
  1141. select: function () {
  1142. return ['safari 5']
  1143. }
  1144. },
  1145. phantomjs_2_1: {
  1146. matches: [],
  1147. regexp: /^phantomjs\s+2.1$/i,
  1148. select: function () {
  1149. return ['safari 6']
  1150. }
  1151. },
  1152. browser_version: {
  1153. matches: ['browser', 'version'],
  1154. regexp: /^(\w+)\s+(tp|[\d.]+)$/i,
  1155. select: function (context, node) {
  1156. var version = node.version
  1157. if (/^tp$/i.test(version)) version = 'TP'
  1158. var data = checkName(node.browser, context)
  1159. var alias = normalizeVersion(data, version)
  1160. if (alias) {
  1161. version = alias
  1162. } else {
  1163. if (version.indexOf('.') === -1) {
  1164. alias = version + '.0'
  1165. } else {
  1166. alias = version.replace(/\.0$/, '')
  1167. }
  1168. alias = normalizeVersion(data, alias)
  1169. if (alias) {
  1170. version = alias
  1171. } else if (context.ignoreUnknownVersions) {
  1172. return []
  1173. } else {
  1174. throw new BrowserslistError(
  1175. 'Unknown version ' + version + ' of ' + node.browser
  1176. )
  1177. }
  1178. }
  1179. return [data.name + ' ' + version]
  1180. }
  1181. },
  1182. browserslist_config: {
  1183. matches: [],
  1184. regexp: /^browserslist config$/i,
  1185. needsPath: true,
  1186. select: function (context) {
  1187. return browserslist(undefined, context)
  1188. }
  1189. },
  1190. extends: {
  1191. matches: ['config'],
  1192. regexp: /^extends (.+)$/i,
  1193. needsPath: true,
  1194. select: function (context, node) {
  1195. return resolve(env.loadQueries(context, node.config), context)
  1196. }
  1197. },
  1198. defaults: {
  1199. matches: [],
  1200. regexp: /^defaults$/i,
  1201. select: function (context) {
  1202. return resolve(browserslist.defaults, context)
  1203. }
  1204. },
  1205. dead: {
  1206. matches: [],
  1207. regexp: /^dead$/i,
  1208. select: function (context) {
  1209. var dead = [
  1210. 'Baidu >= 0',
  1211. 'ie <= 11',
  1212. 'ie_mob <= 11',
  1213. 'bb <= 10',
  1214. 'op_mob <= 12.1',
  1215. 'samsung 4'
  1216. ]
  1217. return resolve(dead, context)
  1218. }
  1219. },
  1220. unknown: {
  1221. matches: [],
  1222. regexp: /^(\w+)$/i,
  1223. select: function (context, node) {
  1224. if (byName(node.query, context)) {
  1225. throw new BrowserslistError(
  1226. 'Specify versions in Browserslist query for browser ' + node.query
  1227. )
  1228. } else {
  1229. throw unknownQuery(node.query)
  1230. }
  1231. }
  1232. }
  1233. }
  1234. // Get and convert Can I Use data
  1235. ;(function () {
  1236. for (var name in agents) {
  1237. var browser = agents[name]
  1238. browserslist.data[name] = {
  1239. name: name,
  1240. versions: normalize(agents[name].versions),
  1241. released: normalize(agents[name].versions.slice(0, -3)),
  1242. releaseDate: agents[name].release_date
  1243. }
  1244. fillUsage(browserslist.usage.global, name, browser.usage_global)
  1245. browserslist.versionAliases[name] = {}
  1246. for (var i = 0; i < browser.versions.length; i++) {
  1247. var full = browser.versions[i]
  1248. if (!full) continue
  1249. if (full.indexOf('-') !== -1) {
  1250. var interval = full.split('-')
  1251. for (var j = 0; j < interval.length; j++) {
  1252. browserslist.versionAliases[name][interval[j]] = full
  1253. }
  1254. }
  1255. }
  1256. }
  1257. browserslist.nodeVersions = jsReleases.map(function (release) {
  1258. return release.version
  1259. })
  1260. })()
  1261. browserslist.versionAliases.firefox.esr = FIREFOX_ESR_VERSION
  1262. module.exports = browserslist