index.js 37 KB

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