index.js 37 KB

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