index.js 32 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159
  1. var jsReleases = require('node-releases/data/processed/envs.json')
  2. var agents = require('caniuse-lite/dist/unpacker/agents').agents
  3. var jsEOL = require('node-releases/data/release-schedule/release-schedule.json')
  4. var path = require('path')
  5. var e2c = require('electron-to-chromium/versions')
  6. var BrowserslistError = require('./error')
  7. var env = require('./node') // Will load browser.js in webpack
  8. var YEAR = 365.259641 * 24 * 60 * 60 * 1000
  9. var ANDROID_EVERGREEN_FIRST = 37
  10. var QUERY_OR = 1
  11. var QUERY_AND = 2
  12. function isVersionsMatch (versionA, versionB) {
  13. return (versionA + '.').indexOf(versionB + '.') === 0
  14. }
  15. function isEolReleased (name) {
  16. var version = name.slice(1)
  17. return jsReleases.some(function (i) {
  18. return isVersionsMatch(i.version, version)
  19. })
  20. }
  21. function normalize (versions) {
  22. return versions.filter(function (version) {
  23. return typeof version === 'string'
  24. })
  25. }
  26. function normalizeElectron (version) {
  27. var versionToUse = version
  28. if (version.split('.').length === 3) {
  29. versionToUse = version
  30. .split('.')
  31. .slice(0, -1)
  32. .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. // Helpers
  66. function fillUsage (result, name, data) {
  67. for (var i in data) {
  68. result[name + ' ' + i] = data[i]
  69. }
  70. }
  71. function generateFilter (sign, version) {
  72. version = parseFloat(version)
  73. if (sign === '>') {
  74. return function (v) {
  75. return parseFloat(v) > version
  76. }
  77. } else if (sign === '>=') {
  78. return function (v) {
  79. return parseFloat(v) >= version
  80. }
  81. } else if (sign === '<') {
  82. return function (v) {
  83. return parseFloat(v) < version
  84. }
  85. } else {
  86. return function (v) {
  87. return parseFloat(v) <= version
  88. }
  89. }
  90. }
  91. function generateSemverFilter (sign, version) {
  92. version = version.split('.').map(parseSimpleInt)
  93. version[1] = version[1] || 0
  94. version[2] = version[2] || 0
  95. if (sign === '>') {
  96. return function (v) {
  97. v = v.split('.').map(parseSimpleInt)
  98. return compareSemver(v, version) > 0
  99. }
  100. } else if (sign === '>=') {
  101. return function (v) {
  102. v = v.split('.').map(parseSimpleInt)
  103. return compareSemver(v, version) >= 0
  104. }
  105. } else if (sign === '<') {
  106. return function (v) {
  107. v = v.split('.').map(parseSimpleInt)
  108. return compareSemver(version, v) > 0
  109. }
  110. } else {
  111. return function (v) {
  112. v = v.split('.').map(parseSimpleInt)
  113. return compareSemver(version, v) >= 0
  114. }
  115. }
  116. }
  117. function parseSimpleInt (x) {
  118. return parseInt(x)
  119. }
  120. function compare (a, b) {
  121. if (a < b) return -1
  122. if (a > b) return +1
  123. return 0
  124. }
  125. function compareSemver (a, b) {
  126. return (
  127. compare(parseInt(a[0]), parseInt(b[0])) ||
  128. compare(parseInt(a[1] || '0'), parseInt(b[1] || '0')) ||
  129. compare(parseInt(a[2] || '0'), parseInt(b[2] || '0'))
  130. )
  131. }
  132. // this follows the npm-like semver behavior
  133. function semverFilterLoose (operator, range) {
  134. range = range.split('.').map(parseSimpleInt)
  135. if (typeof range[1] === 'undefined') {
  136. range[1] = 'x'
  137. }
  138. // ignore any patch version because we only return minor versions
  139. // range[2] = 'x'
  140. switch (operator) {
  141. case '<=':
  142. return function (version) {
  143. version = version.split('.').map(parseSimpleInt)
  144. return compareSemverLoose(version, range) <= 0
  145. }
  146. default:
  147. case '>=':
  148. return function (version) {
  149. version = version.split('.').map(parseSimpleInt)
  150. return compareSemverLoose(version, range) >= 0
  151. }
  152. }
  153. }
  154. // this follows the npm-like semver behavior
  155. function compareSemverLoose (version, range) {
  156. if (version[0] !== range[0]) {
  157. return version[0] < range[0] ? -1 : +1
  158. }
  159. if (range[1] === 'x') {
  160. return 0
  161. }
  162. if (version[1] !== range[1]) {
  163. return version[1] < range[1] ? -1 : +1
  164. }
  165. return 0
  166. }
  167. function resolveVersion (data, version) {
  168. if (data.versions.indexOf(version) !== -1) {
  169. return version
  170. } else if (browserslist.versionAliases[data.name][version]) {
  171. return browserslist.versionAliases[data.name][version]
  172. } else {
  173. return false
  174. }
  175. }
  176. function normalizeVersion (data, version) {
  177. var resolved = resolveVersion(data, version)
  178. if (resolved) {
  179. return resolved
  180. } else if (data.versions.length === 1) {
  181. return data.versions[0]
  182. } else {
  183. return false
  184. }
  185. }
  186. function filterByYear (since, context) {
  187. since = since / 1000
  188. return Object.keys(agents).reduce(function (selected, name) {
  189. var data = byName(name, context)
  190. if (!data) return selected
  191. var versions = Object.keys(data.releaseDate).filter(function (v) {
  192. return data.releaseDate[v] >= since
  193. })
  194. return selected.concat(versions.map(nameMapper(data.name)))
  195. }, [])
  196. }
  197. function cloneData (data) {
  198. return {
  199. name: data.name,
  200. versions: data.versions,
  201. released: data.released,
  202. releaseDate: data.releaseDate
  203. }
  204. }
  205. function mapVersions (data, map) {
  206. data.versions = data.versions.map(function (i) {
  207. return map[i] || i
  208. })
  209. data.released = data.versions.map(function (i) {
  210. return map[i] || i
  211. })
  212. var fixedDate = { }
  213. for (var i in data.releaseDate) {
  214. fixedDate[map[i] || i] = data.releaseDate[i]
  215. }
  216. data.releaseDate = fixedDate
  217. return data
  218. }
  219. function byName (name, context) {
  220. name = name.toLowerCase()
  221. name = browserslist.aliases[name] || name
  222. if (context.mobileToDesktop && browserslist.desktopNames[name]) {
  223. var desktop = browserslist.data[browserslist.desktopNames[name]]
  224. if (name === 'android') {
  225. return normalizeAndroidData(cloneData(browserslist.data[name]), desktop)
  226. } else {
  227. var cloned = cloneData(desktop)
  228. cloned.name = name
  229. if (name === 'op_mob') {
  230. cloned = mapVersions(cloned, { '10.0-10.1': '10' })
  231. }
  232. return cloned
  233. }
  234. }
  235. return browserslist.data[name]
  236. }
  237. function normalizeAndroidVersions (androidVersions, chromeVersions) {
  238. var firstEvergreen = ANDROID_EVERGREEN_FIRST
  239. var last = chromeVersions[chromeVersions.length - 1]
  240. return androidVersions
  241. .filter(function (version) { return /^(?:[2-4]\.|[34]$)/.test(version) })
  242. .concat(chromeVersions.slice(firstEvergreen - last - 1))
  243. }
  244. function normalizeAndroidData (android, chrome) {
  245. android.released = normalizeAndroidVersions(android.released, chrome.released)
  246. android.versions = normalizeAndroidVersions(android.versions, chrome.versions)
  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 `' + query + '`. ' +
  257. 'Maybe you are using old Browserslist or made typo in query.'
  258. )
  259. }
  260. function filterAndroid (list, versions, context) {
  261. if (context.mobileToDesktop) return list
  262. var released = browserslist.data.android.released
  263. var last = released[released.length - 1]
  264. var diff = last - ANDROID_EVERGREEN_FIRST - versions
  265. if (diff > 0) {
  266. return list.slice(-1)
  267. } else {
  268. return list.slice(diff - 1)
  269. }
  270. }
  271. /**
  272. * Resolves queries into a browser list.
  273. * @param {string|string[]} queries Queries to combine.
  274. * Either an array of queries or a long string of queries.
  275. * @param {object} [context] Optional arguments to
  276. * the select function in `queries`.
  277. * @returns {string[]} A list of browsers
  278. */
  279. function resolve (queries, context) {
  280. if (Array.isArray(queries)) {
  281. queries = flatten(queries.map(parse))
  282. } else {
  283. queries = parse(queries)
  284. }
  285. return queries.reduce(function (result, query, index) {
  286. var selection = query.queryString
  287. var isExclude = selection.indexOf('not ') === 0
  288. if (isExclude) {
  289. if (index === 0) {
  290. throw new BrowserslistError(
  291. 'Write any browsers query (for instance, `defaults`) ' +
  292. 'before `' + selection + '`')
  293. }
  294. selection = selection.slice(4)
  295. }
  296. for (var i = 0; i < QUERIES.length; i++) {
  297. var type = QUERIES[i]
  298. var match = selection.match(type.regexp)
  299. if (match) {
  300. var args = [context].concat(match.slice(1))
  301. var array = type.select.apply(browserslist, args).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. switch (query.type) {
  310. case QUERY_AND:
  311. if (isExclude) {
  312. return result.filter(function (j) {
  313. return array.indexOf(j) === -1
  314. })
  315. } else {
  316. return result.filter(function (j) {
  317. return array.indexOf(j) !== -1
  318. })
  319. }
  320. case QUERY_OR:
  321. default:
  322. if (isExclude) {
  323. var filter = { }
  324. array.forEach(function (j) {
  325. filter[j] = true
  326. })
  327. return result.filter(function (j) {
  328. return !filter[j]
  329. })
  330. }
  331. return result.concat(array)
  332. }
  333. }
  334. }
  335. throw unknownQuery(selection)
  336. }, [])
  337. }
  338. var cache = { }
  339. /**
  340. * Return array of browsers by selection queries.
  341. *
  342. * @param {(string|string[])} [queries=browserslist.defaults] Browser queries.
  343. * @param {object} [opts] Options.
  344. * @param {string} [opts.path="."] Path to processed file.
  345. * It will be used to find config files.
  346. * @param {string} [opts.env="production"] Processing environment.
  347. * It will be used to take right
  348. * queries from config file.
  349. * @param {string} [opts.config] Path to config file with queries.
  350. * @param {object} [opts.stats] Custom browser usage statistics
  351. * for "> 1% in my stats" query.
  352. * @param {boolean} [opts.ignoreUnknownVersions=false] Do not throw on unknown
  353. * version in direct query.
  354. * @param {boolean} [opts.dangerousExtend] Disable security checks
  355. * for extend query.
  356. * @param {boolean} [opts.mobileToDesktop] Alias mobile browsers to the desktop
  357. * version when Can I Use doesn't have
  358. * data about the specified version.
  359. * @returns {string[]} Array with browser names in Can I Use.
  360. *
  361. * @example
  362. * browserslist('IE >= 10, IE 8') //=> ['ie 11', 'ie 10', 'ie 8']
  363. */
  364. function browserslist (queries, opts) {
  365. if (typeof opts === 'undefined') opts = { }
  366. if (typeof opts.path === 'undefined') {
  367. opts.path = path.resolve ? path.resolve('.') : '.'
  368. }
  369. if (typeof queries === 'undefined' || queries === null) {
  370. var config = browserslist.loadConfig(opts)
  371. if (config) {
  372. queries = config
  373. } else {
  374. queries = browserslist.defaults
  375. }
  376. }
  377. if (!(typeof queries === 'string' || Array.isArray(queries))) {
  378. throw new BrowserslistError(
  379. 'Browser queries must be an array or string. Got ' + typeof queries + '.')
  380. }
  381. var context = {
  382. ignoreUnknownVersions: opts.ignoreUnknownVersions,
  383. dangerousExtend: opts.dangerousExtend,
  384. mobileToDesktop: opts.mobileToDesktop,
  385. env: opts.env
  386. }
  387. env.oldDataWarning(browserslist.data)
  388. var stats = env.getStat(opts, browserslist.data)
  389. if (stats) {
  390. context.customUsage = { }
  391. for (var browser in stats) {
  392. fillUsage(context.customUsage, browser, stats[browser])
  393. }
  394. }
  395. var cacheKey = JSON.stringify([queries, context])
  396. if (cache[cacheKey]) return cache[cacheKey]
  397. var result = uniq(resolve(queries, context)).sort(function (name1, name2) {
  398. name1 = name1.split(' ')
  399. name2 = name2.split(' ')
  400. if (name1[0] === name2[0]) {
  401. // assumptions on caniuse data
  402. // 1) version ranges never overlaps
  403. // 2) if version is not a range, it never contains `-`
  404. var version1 = name1[1].split('-')[0]
  405. var version2 = name2[1].split('-')[0]
  406. return compareSemver(version2.split('.'), version1.split('.'))
  407. } else {
  408. return compare(name1[0], name2[0])
  409. }
  410. })
  411. if (!process.env.BROWSERSLIST_DISABLE_CACHE) {
  412. cache[cacheKey] = result
  413. }
  414. return result
  415. }
  416. function parse (queries) {
  417. var qs = []
  418. do {
  419. queries = doMatch(queries, qs)
  420. } while (queries)
  421. return qs
  422. }
  423. function doMatch (string, qs) {
  424. var or = /^(?:,\s*|\s+or\s+)(.*)/i
  425. var and = /^\s+and\s+(.*)/i
  426. return find(string, function (parsed, n, max) {
  427. if (and.test(parsed)) {
  428. qs.unshift({ type: QUERY_AND, queryString: parsed.match(and)[1] })
  429. return true
  430. } else if (or.test(parsed)) {
  431. qs.unshift({ type: QUERY_OR, queryString: parsed.match(or)[1] })
  432. return true
  433. } else if (n === max) {
  434. qs.unshift({ type: QUERY_OR, queryString: parsed.trim() })
  435. return true
  436. }
  437. return false
  438. })
  439. }
  440. function find (string, predicate) {
  441. for (var n = 1, max = string.length; n <= max; n++) {
  442. var parsed = string.substr(-n, n)
  443. if (predicate(parsed, n, max)) {
  444. return string.slice(0, -n)
  445. }
  446. }
  447. return ''
  448. }
  449. function flatten (array) {
  450. if (!Array.isArray(array)) return [array]
  451. return array.reduce(function (a, b) {
  452. return a.concat(flatten(b))
  453. }, [])
  454. }
  455. // Will be filled by Can I Use data below
  456. browserslist.data = { }
  457. browserslist.usage = {
  458. global: { },
  459. custom: null
  460. }
  461. // Default browsers query
  462. browserslist.defaults = [
  463. '> 0.5%',
  464. 'last 2 versions',
  465. 'Firefox ESR',
  466. 'not dead'
  467. ]
  468. // Browser names aliases
  469. browserslist.aliases = {
  470. fx: 'firefox',
  471. ff: 'firefox',
  472. ios: 'ios_saf',
  473. explorer: 'ie',
  474. blackberry: 'bb',
  475. explorermobile: 'ie_mob',
  476. operamini: 'op_mini',
  477. operamobile: 'op_mob',
  478. chromeandroid: 'and_chr',
  479. firefoxandroid: 'and_ff',
  480. ucandroid: 'and_uc',
  481. qqandroid: 'and_qq'
  482. }
  483. // Can I Use only provides a few versions for some browsers (e.g. and_chr).
  484. // Fallback to a similar browser for unknown versions
  485. browserslist.desktopNames = {
  486. and_chr: 'chrome',
  487. and_ff: 'firefox',
  488. ie_mob: 'ie',
  489. op_mob: 'opera',
  490. android: 'chrome' // has extra processing logic
  491. }
  492. // Aliases to work with joined versions like `ios_saf 7.0-7.1`
  493. browserslist.versionAliases = { }
  494. browserslist.clearCaches = env.clearCaches
  495. browserslist.parseConfig = env.parseConfig
  496. browserslist.readConfig = env.readConfig
  497. browserslist.findConfig = env.findConfig
  498. browserslist.loadConfig = env.loadConfig
  499. /**
  500. * Return browsers market coverage.
  501. *
  502. * @param {string[]} browsers Browsers names in Can I Use.
  503. * @param {string|object} [stats="global"] Which statistics should be used.
  504. * Country code or custom statistics.
  505. * Pass `"my stats"` to load statistics
  506. * from Browserslist files.
  507. *
  508. * @return {number} Total market coverage for all selected browsers.
  509. *
  510. * @example
  511. * browserslist.coverage(browserslist('> 1% in US'), 'US') //=> 83.1
  512. */
  513. browserslist.coverage = function (browsers, stats) {
  514. var data
  515. if (typeof stats === 'undefined') {
  516. data = browserslist.usage.global
  517. } else if (stats === 'my stats') {
  518. var opts = {}
  519. opts.path = path.resolve ? path.resolve('.') : '.'
  520. var customStats = env.getStat(opts)
  521. if (!customStats) {
  522. throw new BrowserslistError('Custom usage statistics was not provided')
  523. }
  524. data = {}
  525. for (var browser in customStats) {
  526. fillUsage(data, browser, customStats[browser])
  527. }
  528. } else if (typeof stats === 'string') {
  529. if (stats.length > 2) {
  530. stats = stats.toLowerCase()
  531. } else {
  532. stats = stats.toUpperCase()
  533. }
  534. env.loadCountry(browserslist.usage, stats, browserslist.data)
  535. data = browserslist.usage[stats]
  536. } else {
  537. if ('dataByBrowser' in stats) {
  538. stats = stats.dataByBrowser
  539. }
  540. data = { }
  541. for (var name in stats) {
  542. for (var version in stats[name]) {
  543. data[name + ' ' + version] = stats[name][version]
  544. }
  545. }
  546. }
  547. return browsers.reduce(function (all, i) {
  548. var usage = data[i]
  549. if (usage === undefined) {
  550. usage = data[i.replace(/ \S+$/, ' 0')]
  551. }
  552. return all + (usage || 0)
  553. }, 0)
  554. }
  555. var QUERIES = [
  556. {
  557. regexp: /^last\s+(\d+)\s+major\s+versions?$/i,
  558. select: function (context, versions) {
  559. return Object.keys(agents).reduce(function (selected, name) {
  560. var data = byName(name, context)
  561. if (!data) return selected
  562. var list = getMajorVersions(data.released, versions)
  563. list = list.map(nameMapper(data.name))
  564. if (data.name === 'android') {
  565. list = filterAndroid(list, versions, context)
  566. }
  567. return selected.concat(list)
  568. }, [])
  569. }
  570. },
  571. {
  572. regexp: /^last\s+(\d+)\s+versions?$/i,
  573. select: function (context, versions) {
  574. return Object.keys(agents).reduce(function (selected, name) {
  575. var data = byName(name, context)
  576. if (!data) return selected
  577. var list = data.released.slice(-versions)
  578. list = list.map(nameMapper(data.name))
  579. if (data.name === 'android') {
  580. list = filterAndroid(list, versions, context)
  581. }
  582. return selected.concat(list)
  583. }, [])
  584. }
  585. },
  586. {
  587. regexp: /^last\s+(\d+)\s+electron\s+major\s+versions?$/i,
  588. select: function (context, versions) {
  589. var validVersions = getMajorVersions(Object.keys(e2c).reverse(), versions)
  590. return validVersions.map(function (i) {
  591. return 'chrome ' + e2c[i]
  592. })
  593. }
  594. },
  595. {
  596. regexp: /^last\s+(\d+)\s+(\w+)\s+major\s+versions?$/i,
  597. select: function (context, versions, name) {
  598. var data = checkName(name, context)
  599. var validVersions = getMajorVersions(data.released, versions)
  600. var list = validVersions.map(nameMapper(data.name))
  601. if (data.name === 'android') {
  602. list = filterAndroid(list, versions, context)
  603. }
  604. return list
  605. }
  606. },
  607. {
  608. regexp: /^last\s+(\d+)\s+electron\s+versions?$/i,
  609. select: function (context, versions) {
  610. return Object.keys(e2c).reverse().slice(-versions).map(function (i) {
  611. return 'chrome ' + e2c[i]
  612. })
  613. }
  614. },
  615. {
  616. regexp: /^last\s+(\d+)\s+(\w+)\s+versions?$/i,
  617. select: function (context, versions, name) {
  618. var data = checkName(name, context)
  619. var list = data.released.slice(-versions).map(nameMapper(data.name))
  620. if (data.name === 'android') {
  621. list = filterAndroid(list, versions, context)
  622. }
  623. return list
  624. }
  625. },
  626. {
  627. regexp: /^unreleased\s+versions$/i,
  628. select: function (context) {
  629. return Object.keys(agents).reduce(function (selected, name) {
  630. var data = byName(name, context)
  631. if (!data) return selected
  632. var list = data.versions.filter(function (v) {
  633. return data.released.indexOf(v) === -1
  634. })
  635. list = list.map(nameMapper(data.name))
  636. return selected.concat(list)
  637. }, [])
  638. }
  639. },
  640. {
  641. regexp: /^unreleased\s+electron\s+versions?$/i,
  642. select: function () {
  643. return []
  644. }
  645. },
  646. {
  647. regexp: /^unreleased\s+(\w+)\s+versions?$/i,
  648. select: function (context, name) {
  649. var data = checkName(name, context)
  650. return data.versions.filter(function (v) {
  651. return data.released.indexOf(v) === -1
  652. }).map(nameMapper(data.name))
  653. }
  654. },
  655. {
  656. regexp: /^last\s+(\d*.?\d+)\s+years?$/i,
  657. select: function (context, years) {
  658. return filterByYear(Date.now() - YEAR * years, context)
  659. }
  660. },
  661. {
  662. regexp: /^since (\d+)(?:-(\d+))?(?:-(\d+))?$/i,
  663. select: function (context, year, month, date) {
  664. year = parseInt(year)
  665. month = parseInt(month || '01') - 1
  666. date = parseInt(date || '01')
  667. return filterByYear(Date.UTC(year, month, date, 0, 0, 0), context)
  668. }
  669. },
  670. {
  671. regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%$/,
  672. select: function (context, sign, popularity) {
  673. popularity = parseFloat(popularity)
  674. var usage = browserslist.usage.global
  675. return Object.keys(usage).reduce(function (result, version) {
  676. if (sign === '>') {
  677. if (usage[version] > popularity) {
  678. result.push(version)
  679. }
  680. } else if (sign === '<') {
  681. if (usage[version] < popularity) {
  682. result.push(version)
  683. }
  684. } else if (sign === '<=') {
  685. if (usage[version] <= popularity) {
  686. result.push(version)
  687. }
  688. } else if (usage[version] >= popularity) {
  689. result.push(version)
  690. }
  691. return result
  692. }, [])
  693. }
  694. },
  695. {
  696. regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%\s+in\s+my\s+stats$/,
  697. select: function (context, sign, popularity) {
  698. popularity = parseFloat(popularity)
  699. if (!context.customUsage) {
  700. throw new BrowserslistError('Custom usage statistics was not provided')
  701. }
  702. var usage = context.customUsage
  703. return Object.keys(usage).reduce(function (result, version) {
  704. if (sign === '>') {
  705. if (usage[version] > popularity) {
  706. result.push(version)
  707. }
  708. } else if (sign === '<') {
  709. if (usage[version] < popularity) {
  710. result.push(version)
  711. }
  712. } else if (sign === '<=') {
  713. if (usage[version] <= popularity) {
  714. result.push(version)
  715. }
  716. } else if (usage[version] >= popularity) {
  717. result.push(version)
  718. }
  719. return result
  720. }, [])
  721. }
  722. },
  723. {
  724. regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%\s+in\s+(\S+)\s+stats$/,
  725. select: function (context, sign, popularity, name) {
  726. popularity = parseFloat(popularity)
  727. var stats = env.loadStat(context, name, browserslist.data)
  728. if (stats) {
  729. context.customUsage = { }
  730. for (var browser in stats) {
  731. fillUsage(context.customUsage, browser, stats[browser])
  732. }
  733. }
  734. if (!context.customUsage) {
  735. throw new BrowserslistError('Custom usage statistics was not provided')
  736. }
  737. var usage = context.customUsage
  738. return Object.keys(usage).reduce(function (result, version) {
  739. if (sign === '>') {
  740. if (usage[version] > popularity) {
  741. result.push(version)
  742. }
  743. } else if (sign === '<') {
  744. if (usage[version] < popularity) {
  745. result.push(version)
  746. }
  747. } else if (sign === '<=') {
  748. if (usage[version] <= popularity) {
  749. result.push(version)
  750. }
  751. } else if (usage[version] >= popularity) {
  752. result.push(version)
  753. }
  754. return result
  755. }, [])
  756. }
  757. },
  758. {
  759. regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%\s+in\s+((alt-)?\w\w)$/,
  760. select: function (context, sign, popularity, place) {
  761. popularity = parseFloat(popularity)
  762. if (place.length === 2) {
  763. place = place.toUpperCase()
  764. } else {
  765. place = place.toLowerCase()
  766. }
  767. env.loadCountry(browserslist.usage, place, browserslist.data)
  768. var usage = browserslist.usage[place]
  769. return Object.keys(usage).reduce(function (result, version) {
  770. if (sign === '>') {
  771. if (usage[version] > popularity) {
  772. result.push(version)
  773. }
  774. } else if (sign === '<') {
  775. if (usage[version] < popularity) {
  776. result.push(version)
  777. }
  778. } else if (sign === '<=') {
  779. if (usage[version] <= popularity) {
  780. result.push(version)
  781. }
  782. } else if (usage[version] >= popularity) {
  783. result.push(version)
  784. }
  785. return result
  786. }, [])
  787. }
  788. },
  789. {
  790. regexp: /^cover\s+(\d*\.?\d+)%(\s+in\s+(my\s+stats|(alt-)?\w\w))?$/,
  791. select: function (context, coverage, statMode) {
  792. coverage = parseFloat(coverage)
  793. var usage = browserslist.usage.global
  794. if (statMode) {
  795. if (statMode.match(/^\s+in\s+my\s+stats$/)) {
  796. if (!context.customUsage) {
  797. throw new BrowserslistError(
  798. 'Custom usage statistics was not provided'
  799. )
  800. }
  801. usage = context.customUsage
  802. } else {
  803. var match = statMode.match(/\s+in\s+((alt-)?\w\w)/)
  804. var place = match[1]
  805. if (place.length === 2) {
  806. place = place.toUpperCase()
  807. } else {
  808. place = place.toLowerCase()
  809. }
  810. env.loadCountry(browserslist.usage, place, browserslist.data)
  811. usage = browserslist.usage[place]
  812. }
  813. }
  814. var versions = Object.keys(usage).sort(function (a, b) {
  815. return usage[b] - usage[a]
  816. })
  817. var coveraged = 0
  818. var result = []
  819. var version
  820. for (var i = 0; i <= versions.length; i++) {
  821. version = versions[i]
  822. if (usage[version] === 0) break
  823. coveraged += usage[version]
  824. result.push(version)
  825. if (coveraged >= coverage) break
  826. }
  827. return result
  828. }
  829. },
  830. {
  831. regexp: /^electron\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  832. select: function (context, from, to) {
  833. var fromToUse = normalizeElectron(from)
  834. var toToUse = normalizeElectron(to)
  835. if (!e2c[fromToUse]) {
  836. throw new BrowserslistError('Unknown version ' + from + ' of electron')
  837. }
  838. if (!e2c[toToUse]) {
  839. throw new BrowserslistError('Unknown version ' + to + ' of electron')
  840. }
  841. from = parseFloat(from)
  842. to = parseFloat(to)
  843. return Object.keys(e2c).filter(function (i) {
  844. var parsed = parseFloat(i)
  845. return parsed >= from && parsed <= to
  846. }).map(function (i) {
  847. return 'chrome ' + e2c[i]
  848. })
  849. }
  850. },
  851. {
  852. regexp: /^node\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  853. select: function (context, from, to) {
  854. var nodeVersions = jsReleases.filter(function (i) {
  855. return i.name === 'nodejs'
  856. }).map(function (i) {
  857. return i.version
  858. })
  859. var semverRegExp = /^(0|[1-9]\d*)(\.(0|[1-9]\d*)){0,2}$/
  860. if (!semverRegExp.test(from)) {
  861. throw new BrowserslistError(
  862. 'Unknown version ' + from + ' of Node.js')
  863. }
  864. if (!semverRegExp.test(to)) {
  865. throw new BrowserslistError(
  866. 'Unknown version ' + to + ' of Node.js')
  867. }
  868. return nodeVersions
  869. .filter(semverFilterLoose('>=', from))
  870. .filter(semverFilterLoose('<=', to))
  871. .map(function (v) {
  872. return 'node ' + v
  873. })
  874. }
  875. },
  876. {
  877. regexp: /^(\w+)\s+([\d.]+)\s*-\s*([\d.]+)$/i,
  878. select: function (context, name, from, to) {
  879. var data = checkName(name, context)
  880. from = parseFloat(normalizeVersion(data, from) || from)
  881. to = parseFloat(normalizeVersion(data, to) || to)
  882. function filter (v) {
  883. var parsed = parseFloat(v)
  884. return parsed >= from && parsed <= to
  885. }
  886. return data.released.filter(filter).map(nameMapper(data.name))
  887. }
  888. },
  889. {
  890. regexp: /^electron\s*(>=?|<=?)\s*([\d.]+)$/i,
  891. select: function (context, sign, version) {
  892. var versionToUse = normalizeElectron(version)
  893. return Object.keys(e2c)
  894. .filter(generateFilter(sign, versionToUse))
  895. .map(function (i) {
  896. return 'chrome ' + e2c[i]
  897. })
  898. }
  899. },
  900. {
  901. regexp: /^node\s*(>=?|<=?)\s*([\d.]+)$/i,
  902. select: function (context, sign, version) {
  903. var nodeVersions = jsReleases.filter(function (i) {
  904. return i.name === 'nodejs'
  905. }).map(function (i) {
  906. return i.version
  907. })
  908. return nodeVersions
  909. .filter(generateSemverFilter(sign, version))
  910. .map(function (v) {
  911. return 'node ' + v
  912. })
  913. }
  914. },
  915. {
  916. regexp: /^(\w+)\s*(>=?|<=?)\s*([\d.]+)$/,
  917. select: function (context, name, sign, version) {
  918. var data = checkName(name, context)
  919. var alias = browserslist.versionAliases[data.name][version]
  920. if (alias) {
  921. version = alias
  922. }
  923. return data.released
  924. .filter(generateFilter(sign, version))
  925. .map(function (v) {
  926. return data.name + ' ' + v
  927. })
  928. }
  929. },
  930. {
  931. regexp: /^(firefox|ff|fx)\s+esr$/i,
  932. select: function () {
  933. return ['firefox 68']
  934. }
  935. },
  936. {
  937. regexp: /(operamini|op_mini)\s+all/i,
  938. select: function () {
  939. return ['op_mini all']
  940. }
  941. },
  942. {
  943. regexp: /^electron\s+([\d.]+)$/i,
  944. select: function (context, version) {
  945. var versionToUse = normalizeElectron(version)
  946. var chrome = e2c[versionToUse]
  947. if (!chrome) {
  948. throw new BrowserslistError(
  949. 'Unknown version ' + version + ' of electron')
  950. }
  951. return ['chrome ' + chrome]
  952. }
  953. },
  954. {
  955. regexp: /^node\s+(\d+(\.\d+)?(\.\d+)?)$/i,
  956. select: function (context, version) {
  957. var nodeReleases = jsReleases.filter(function (i) {
  958. return i.name === 'nodejs'
  959. })
  960. var matched = nodeReleases.filter(function (i) {
  961. return isVersionsMatch(i.version, version)
  962. })
  963. if (matched.length === 0) {
  964. if (context.ignoreUnknownVersions) {
  965. return []
  966. } else {
  967. throw new BrowserslistError(
  968. 'Unknown version ' + version + ' of Node.js')
  969. }
  970. }
  971. return ['node ' + matched[matched.length - 1].version]
  972. }
  973. },
  974. {
  975. regexp: /^current\s+node$/i,
  976. select: function (context) {
  977. return [env.currentNode(resolve, context)]
  978. }
  979. },
  980. {
  981. regexp: /^maintained\s+node\s+versions$/i,
  982. select: function (context) {
  983. var now = Date.now()
  984. var queries = Object.keys(jsEOL).filter(function (key) {
  985. return now < Date.parse(jsEOL[key].end) &&
  986. now > Date.parse(jsEOL[key].start) &&
  987. isEolReleased(key)
  988. }).map(function (key) {
  989. return 'node ' + key.slice(1)
  990. })
  991. return resolve(queries, context)
  992. }
  993. },
  994. {
  995. regexp: /^phantomjs\s+1.9$/i,
  996. select: function () {
  997. return ['safari 5']
  998. }
  999. },
  1000. {
  1001. regexp: /^phantomjs\s+2.1$/i,
  1002. select: function () {
  1003. return ['safari 6']
  1004. }
  1005. },
  1006. {
  1007. regexp: /^(\w+)\s+(tp|[\d.]+)$/i,
  1008. select: function (context, name, version) {
  1009. if (/^tp$/i.test(version)) version = 'TP'
  1010. var data = checkName(name, context)
  1011. var alias = normalizeVersion(data, version)
  1012. if (alias) {
  1013. version = alias
  1014. } else {
  1015. if (version.indexOf('.') === -1) {
  1016. alias = version + '.0'
  1017. } else {
  1018. alias = version.replace(/\.0$/, '')
  1019. }
  1020. alias = normalizeVersion(data, alias)
  1021. if (alias) {
  1022. version = alias
  1023. } else if (context.ignoreUnknownVersions) {
  1024. return []
  1025. } else {
  1026. throw new BrowserslistError(
  1027. 'Unknown version ' + version + ' of ' + name)
  1028. }
  1029. }
  1030. return [data.name + ' ' + version]
  1031. }
  1032. },
  1033. {
  1034. regexp: /^extends (.+)$/i,
  1035. select: function (context, name) {
  1036. return resolve(env.loadQueries(context, name), context)
  1037. }
  1038. },
  1039. {
  1040. regexp: /^defaults$/i,
  1041. select: function (context) {
  1042. return resolve(browserslist.defaults, context)
  1043. }
  1044. },
  1045. {
  1046. regexp: /^dead$/i,
  1047. select: function (context) {
  1048. var dead = [
  1049. 'ie <= 10',
  1050. 'ie_mob <= 11',
  1051. 'bb <= 10',
  1052. 'op_mob <= 12.1',
  1053. 'samsung 4'
  1054. ]
  1055. return resolve(dead, context)
  1056. }
  1057. },
  1058. {
  1059. regexp: /^(\w+)$/i,
  1060. select: function (context, name) {
  1061. if (byName(name, context)) {
  1062. throw new BrowserslistError(
  1063. 'Specify versions in Browserslist query for browser ' + name)
  1064. } else {
  1065. throw unknownQuery(name)
  1066. }
  1067. }
  1068. }
  1069. ];
  1070. // Get and convert Can I Use data
  1071. (function () {
  1072. for (var name in agents) {
  1073. var browser = agents[name]
  1074. browserslist.data[name] = {
  1075. name: name,
  1076. versions: normalize(agents[name].versions),
  1077. released: normalize(agents[name].versions.slice(0, -3)),
  1078. releaseDate: agents[name].release_date
  1079. }
  1080. fillUsage(browserslist.usage.global, name, browser.usage_global)
  1081. browserslist.versionAliases[name] = { }
  1082. for (var i = 0; i < browser.versions.length; i++) {
  1083. var full = browser.versions[i]
  1084. if (!full) continue
  1085. if (full.indexOf('-') !== -1) {
  1086. var interval = full.split('-')
  1087. for (var j = 0; j < interval.length; j++) {
  1088. browserslist.versionAliases[name][interval[j]] = full
  1089. }
  1090. }
  1091. }
  1092. }
  1093. }())
  1094. module.exports = browserslist