var path = require('path') var e2c = require('electron-to-chromium/versions') var agents = require('caniuse-lite/dist/unpacker/agents').agents var region = require('caniuse-lite/dist/unpacker/region').default var BrowserslistError = require('./error') var env = require('./node') // Will load browser.js in webpack var FLOAT_RANGE = /^\d+(\.\d+)?(-\d+(\.\d+)?)*$/ function normalize (versions) { return versions.filter(function (version) { return typeof version === 'string' }) } function nameMapper (name) { return function mapName (version) { return name + ' ' + version } } function getMajor (version) { return parseInt(version.split('.')[0]) } function getMajorVersions (released, number) { if (released.length === 0) return [] var minimum = getMajor(released[released.length - 1]) - parseInt(number) + 1 var selected = [] for (var i = released.length - 1; i >= 0; i--) { if (minimum > getMajor(released[i])) break selected.unshift(released[i]) } return selected } function uniq (array) { var filtered = [] for (var i = 0; i < array.length; i++) { if (filtered.indexOf(array[i]) === -1) filtered.push(array[i]) } return filtered } // Helpers function fillUsage (result, name, data) { for (var i in data) { result[name + ' ' + i] = data[i] } } function generateFilter (sign, version) { version = parseFloat(version) if (sign === '>') { return function (v) { return parseFloat(v) > version } } else if (sign === '>=') { return function (v) { return parseFloat(v) >= version } } else if (sign === '<') { return function (v) { return parseFloat(v) < version } } else { return function (v) { return parseFloat(v) <= version } } } function compareStrings (a, b) { if (a < b) return -1 if (a > b) return +1 return 0 } function normalizeVersion (data, version) { if (data.versions.indexOf(version) !== -1) { return version } else if (browserslist.versionAliases[data.name][version]) { return browserslist.versionAliases[data.name][version] } else if (data.versions.length === 1) { return data.versions[0] } else { return false } } function loadCountryStatistics (country) { country = country.replace(/[^\w-]/g, '') if (!browserslist.usage[country]) { var usage = { } // eslint-disable-next-line security/detect-non-literal-require var compressed = require('caniuse-lite/data/regions/' + country + '.js') var data = region(compressed) for (var i in data) { fillUsage(usage, i, data[i]) } browserslist.usage[country] = usage } } function filterByYear (since) { return Object.keys(agents).reduce(function (selected, name) { var data = byName(name) if (!data) return selected var versions = Object.keys(data.releaseDate).filter(function (v) { return data.releaseDate[v] >= since }) return selected.concat(versions.map(nameMapper(data.name))) }, []) } function byName (name) { name = name.toLowerCase() name = browserslist.aliases[name] || name return browserslist.data[name] } function checkName (name) { var data = byName(name) if (!data) throw new BrowserslistError('Unknown browser ' + name) return data } function resolve (queries, context) { return queries.reduce(function (result, selection, index) { selection = selection.trim() if (selection === '') return result var isExclude = selection.indexOf('not ') === 0 if (isExclude) { if (index === 0) { throw new BrowserslistError( 'Write any browsers query (for instance, `defaults`) ' + 'before `' + selection + '`') } selection = selection.slice(4) } for (var i = 0; i < QUERIES.length; i++) { var type = QUERIES[i] var match = selection.match(type.regexp) if (match) { var args = [context].concat(match.slice(1)) var array = type.select.apply(browserslist, args) if (isExclude) { array = array.concat(array.map(function (j) { return j.replace(/\s\d+/, ' 0') })) return result.filter(function (j) { return array.indexOf(j) === -1 }) } return result.concat(array) } } throw new BrowserslistError('Unknown browser query `' + selection + '`') }, []) } /** * Return array of browsers by selection queries. * * @param {(string|string[])} [queries=browserslist.defaults] Browser queries. * @param {object} opts Options. * @param {string} [opts.path="."] Path to processed file. * It will be used to find config files. * @param {string} [opts.env="development"] Processing environment. * It will be used to take right * queries from config file. * @param {string} [opts.config] Path to config file with queries. * @param {object} [opts.stats] Custom browser usage statistics * for "> 1% in my stats" query. * @return {string[]} Array with browser names in Can I Use. * * @example * browserslist('IE >= 10, IE 8') //=> ['ie 11', 'ie 10', 'ie 8'] */ function browserslist (queries, opts) { if (typeof opts === 'undefined') opts = { } if (!opts.hasOwnProperty('path')) { opts.path = path.resolve ? path.resolve('.') : '.' } if (typeof queries === 'undefined' || queries === null) { var config = env.loadConfig(opts) if (config) { queries = config } else { queries = browserslist.defaults } } if (typeof queries === 'string') { queries = queries.split(/,\s*/) } if (!Array.isArray(queries)) { throw new BrowserslistError( 'Browser queries must be an array. Got ' + typeof queries + '.') } var context = { dangerousExtend: opts.dangerousExtend } var stats = env.getStat(opts) if (stats) { if ('dataByBrowser' in stats) { stats = stats.dataByBrowser } context.customUsage = { } for (var browser in stats) { fillUsage(context.customUsage, browser, stats[browser]) } } var result = resolve(queries, context).map(function (i) { var parts = i.split(' ') var name = parts[0] var version = parts[1] if (version === '0') { return name + ' ' + byName(name).versions[0] } else { return i } }).sort(function (name1, name2) { name1 = name1.split(' ') name2 = name2.split(' ') if (name1[0] === name2[0]) { if (FLOAT_RANGE.test(name1[1]) && FLOAT_RANGE.test(name2[1])) { return parseFloat(name2[1]) - parseFloat(name1[1]) } else { return compareStrings(name2[1], name1[1]) } } else { return compareStrings(name1[0], name2[0]) } }) return uniq(result) } // Will be filled by Can I Use data below browserslist.data = { } browserslist.usage = { global: { }, custom: null } // Default browsers query browserslist.defaults = [ '> 1%', 'last 2 versions', 'Firefox ESR' ] // Browser names aliases browserslist.aliases = { fx: 'firefox', ff: 'firefox', ios: 'ios_saf', explorer: 'ie', blackberry: 'bb', explorermobile: 'ie_mob', operamini: 'op_mini', operamobile: 'op_mob', chromeandroid: 'and_chr', firefoxandroid: 'and_ff', ucandroid: 'and_uc', qqandroid: 'and_qq' } // Aliases to work with joined versions like `ios_saf 7.0-7.1` browserslist.versionAliases = { } browserslist.clearCaches = env.clearCaches browserslist.parseConfig = env.parseConfig browserslist.readConfig = env.readConfig browserslist.findConfig = env.findConfig /** * Return browsers market coverage. * * @param {string[]} browsers Browsers names in Can I Use. * @param {string} [country="global"] Which country statistics should be used. * * @return {number} Total market coverage for all selected browsers. * * @example * browserslist.coverage(browserslist('> 1% in US'), 'US') //=> 83.1 */ browserslist.coverage = function (browsers, country) { if (country && country !== 'global') { if (country.length > 2) { country = country.toLowerCase() } else { country = country.toUpperCase() } loadCountryStatistics(country) } else { country = 'global' } return browsers.reduce(function (all, i) { var usage = browserslist.usage[country][i] if (usage === undefined) { usage = browserslist.usage[country][i.replace(/ [\d.]+$/, ' 0')] } return all + (usage || 0) }, 0) } var QUERIES = [ { regexp: /^last\s+(\d+)\s+major versions?$/i, select: function (context, versions) { return Object.keys(agents).reduce(function (selected, name) { var data = byName(name) if (!data) return selected var array = getMajorVersions(data.released, versions) array = array.map(nameMapper(data.name)) return selected.concat(array) }, []) } }, { regexp: /^last\s+(\d+)\s+versions?$/i, select: function (context, versions) { return Object.keys(agents).reduce(function (selected, name) { var data = byName(name) if (!data) return selected var array = data.released.slice(-versions) array = array.map(nameMapper(data.name)) return selected.concat(array) }, []) } }, { regexp: /^last\s+(\d+)\s+electron\s+major versions?$/i, select: function (context, versions) { var validVersions = getMajorVersions(Object.keys(e2c).reverse(), versions) return validVersions.map(function (i) { return 'chrome ' + e2c[i] }) } }, { regexp: /^last\s+(\d+)\s+(\w+)\s+major versions?$/i, select: function (context, versions, name) { var data = checkName(name) var validVersions = getMajorVersions(data.released, versions) return validVersions.map(nameMapper(data.name)) } }, { regexp: /^last\s+(\d+)\s+electron\s+versions?$/i, select: function (context, versions) { return Object.keys(e2c).reverse().slice(-versions).map(function (i) { return 'chrome ' + e2c[i] }) } }, { regexp: /^last\s+(\d+)\s+(\w+)\s+versions?$/i, select: function (context, versions, name) { var data = checkName(name) return data.released.slice(-versions).map(nameMapper(data.name)) } }, { regexp: /^unreleased\s+versions$/i, select: function () { return Object.keys(agents).reduce(function (selected, name) { var data = byName(name) if (!data) return selected var array = data.versions.filter(function (v) { return data.released.indexOf(v) === -1 }) array = array.map(nameMapper(data.name)) return selected.concat(array) }, []) } }, { regexp: /^unreleased\s+electron\s+versions?$/i, select: function () { return [] } }, { regexp: /^unreleased\s+(\w+)\s+versions?$/i, select: function (context, name) { var data = checkName(name) return data.versions.filter(function (v) { return data.released.indexOf(v) === -1 }).map(nameMapper(data.name)) } }, { regexp: /^last\s+(\d+)\s+years?$/i, select: function (context, years) { var date = new Date() var since = date.setFullYear(date.getFullYear() - years) / 1000 return filterByYear(since) } }, { regexp: /^since (\d+)(?:-(\d+))?(?:-(\d+))?$/i, select: function (context, year, month, date) { year = parseInt(year) month = parseInt(month || '01') - 1 date = parseInt(date || '01') var since = Date.UTC(year, month, date, 0, 0, 0) / 1000 return filterByYear(since) } }, { regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%$/, select: function (context, sign, popularity) { popularity = parseFloat(popularity) var usage = browserslist.usage.global return Object.keys(usage).reduce(function (result, version) { if (sign === '>') { if (usage[version] > popularity) { result.push(version) } } else if (sign === '<') { if (usage[version] < popularity) { result.push(version) } } else if (sign === '<=') { if (usage[version] <= popularity) { result.push(version) } } else if (usage[version] >= popularity) { result.push(version) } return result }, []) } }, { regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%\s+in\s+my\s+stats$/, select: function (context, sign, popularity) { popularity = parseFloat(popularity) if (!context.customUsage) { throw new BrowserslistError('Custom usage statistics was not provided') } var usage = context.customUsage return Object.keys(usage).reduce(function (result, version) { if (sign === '>') { if (usage[version] > popularity) { result.push(version) } } else if (sign === '<') { if (usage[version] < popularity) { result.push(version) } } else if (sign === '<=') { if (usage[version] <= popularity) { result.push(version) } } else if (usage[version] >= popularity) { result.push(version) } return result }, []) } }, { regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%\s+in\s+((alt-)?\w\w)$/, select: function (context, sign, popularity, place) { popularity = parseFloat(popularity) if (place.length === 2) { place = place.toUpperCase() } else { place = place.toLowerCase() } loadCountryStatistics(place) var usage = browserslist.usage[place] return Object.keys(usage).reduce(function (result, version) { if (sign === '>') { if (usage[version] > popularity) { result.push(version) } } else if (sign === '<') { if (usage[version] < popularity) { result.push(version) } } else if (sign === '<=') { if (usage[version] <= popularity) { result.push(version) } } else if (usage[version] >= popularity) { result.push(version) } return result }, []) } }, { regexp: /^electron\s+([\d.]+)\s*-\s*([\d.]+)$/i, select: function (context, from, to) { if (!e2c[from]) { throw new BrowserslistError('Unknown version ' + from + ' of electron') } if (!e2c[to]) { throw new BrowserslistError('Unknown version ' + to + ' of electron') } from = parseFloat(from) to = parseFloat(to) return Object.keys(e2c).filter(function (i) { var parsed = parseFloat(i) return parsed >= from && parsed <= to }).map(function (i) { return 'chrome ' + e2c[i] }) } }, { regexp: /^(\w+)\s+([\d.]+)\s*-\s*([\d.]+)$/i, select: function (context, name, from, to) { var data = checkName(name) from = parseFloat(normalizeVersion(data, from) || from) to = parseFloat(normalizeVersion(data, to) || to) function filter (v) { var parsed = parseFloat(v) return parsed >= from && parsed <= to } return data.released.filter(filter).map(nameMapper(data.name)) } }, { regexp: /^electron\s*(>=?|<=?)\s*([\d.]+)$/i, select: function (context, sign, version) { return Object.keys(e2c) .filter(generateFilter(sign, version)) .map(function (i) { return 'chrome ' + e2c[i] }) } }, { regexp: /^(\w+)\s*(>=?|<=?)\s*([\d.]+)$/, select: function (context, name, sign, version) { var data = checkName(name) var alias = browserslist.versionAliases[data.name][version] if (alias) { version = alias } return data.released .filter(generateFilter(sign, version)) .map(function (v) { return data.name + ' ' + v }) } }, { regexp: /^(firefox|ff|fx)\s+esr$/i, select: function () { return ['firefox 52'] } }, { regexp: /(operamini|op_mini)\s+all/i, select: function () { return ['op_mini all'] } }, { regexp: /^electron\s+([\d.]+)$/i, select: function (context, version) { var chrome = e2c[version] if (!chrome) { throw new BrowserslistError( 'Unknown version ' + version + ' of electron') } return ['chrome ' + chrome] } }, { regexp: /^(\w+)\s+(tp|[\d.]+)$/i, select: function (context, name, version) { if (/^tp$/i.test(version)) version = 'TP' var data = checkName(name) var alias = normalizeVersion(data, version) if (alias) { version = alias } else { if (version.indexOf('.') === -1) { alias = version + '.0' } else if (/\.0$/.test(version)) { alias = version.replace(/\.0$/, '') } alias = normalizeVersion(data, alias) if (alias) { version = alias } else { throw new BrowserslistError( 'Unknown version ' + version + ' of ' + name) } } return [data.name + ' ' + version] } }, { regexp: /^extends (.+)$/i, select: function (context, name) { return resolve(env.loadQueries(context, name), context) } }, { regexp: /^defaults$/i, select: function () { return browserslist(browserslist.defaults) } } ]; // Get and convert Can I Use data (function () { for (var name in agents) { var browser = agents[name] browserslist.data[name] = { name: name, versions: normalize(agents[name].versions), released: normalize(agents[name].versions.slice(0, -3)), releaseDate: agents[name].release_date } fillUsage(browserslist.usage.global, name, browser.usage_global) browserslist.versionAliases[name] = { } for (var i = 0; i < browser.versions.length; i++) { var full = browser.versions[i] if (!full) continue if (full.indexOf('-') !== -1) { var interval = full.split('-') for (var j = 0; j < interval.length; j++) { browserslist.versionAliases[name][interval[j]] = full } } } } }()) module.exports = browserslist