node.js 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388
  1. var feature = require('caniuse-lite/dist/unpacker/feature').default
  2. var region = require('caniuse-lite/dist/unpacker/region').default
  3. var path = require('path')
  4. var fs = require('fs')
  5. var BrowserslistError = require('./error')
  6. var IS_SECTION = /^\s*\[(.+)]\s*$/
  7. var CONFIG_PATTERN = /^browserslist-config-/
  8. var SCOPED_CONFIG__PATTERN = /@[^/]+\/browserslist-config(-|$|\/)/
  9. var TIME_TO_UPDATE_CANIUSE = 6 * 30 * 24 * 60 * 60 * 1000
  10. var FORMAT = 'Browserslist config should be a string or an array ' +
  11. 'of strings with browser queries'
  12. var dataTimeChecked = false
  13. var filenessCache = { }
  14. var configCache = { }
  15. function checkExtend (name) {
  16. var use = ' Use `dangerousExtend` option to disable.'
  17. if (!CONFIG_PATTERN.test(name) && !SCOPED_CONFIG__PATTERN.test(name)) {
  18. throw new BrowserslistError(
  19. 'Browserslist config needs `browserslist-config-` prefix. ' + use)
  20. }
  21. if (name.replace(/^@[^/]+\//, '').indexOf('.') !== -1) {
  22. throw new BrowserslistError(
  23. '`.` not allowed in Browserslist config name. ' + use)
  24. }
  25. if (name.indexOf('node_modules') !== -1) {
  26. throw new BrowserslistError(
  27. '`node_modules` not allowed in Browserslist config.' + use)
  28. }
  29. }
  30. function isFile (file) {
  31. if (file in filenessCache) {
  32. return filenessCache[file]
  33. }
  34. var result = fs.existsSync(file) && fs.statSync(file).isFile()
  35. if (!process.env.BROWSERSLIST_DISABLE_CACHE) {
  36. filenessCache[file] = result
  37. }
  38. return result
  39. }
  40. function eachParent (file, callback) {
  41. var dir = isFile(file) ? path.dirname(file) : file
  42. var loc = path.resolve(dir)
  43. do {
  44. var result = callback(loc)
  45. if (typeof result !== 'undefined') return result
  46. } while (loc !== (loc = path.dirname(loc)))
  47. return undefined
  48. }
  49. function check (section) {
  50. if (Array.isArray(section)) {
  51. for (var i = 0; i < section.length; i++) {
  52. if (typeof section[i] !== 'string') {
  53. throw new BrowserslistError(FORMAT)
  54. }
  55. }
  56. } else if (typeof section !== 'string') {
  57. throw new BrowserslistError(FORMAT)
  58. }
  59. }
  60. function pickEnv (config, opts) {
  61. if (typeof config !== 'object') return config
  62. var name
  63. if (typeof opts.env === 'string') {
  64. name = opts.env
  65. } else if (process.env.BROWSERSLIST_ENV) {
  66. name = process.env.BROWSERSLIST_ENV
  67. } else if (process.env.NODE_ENV) {
  68. name = process.env.NODE_ENV
  69. } else {
  70. name = 'production'
  71. }
  72. return config[name] || config.defaults
  73. }
  74. function parsePackage (file) {
  75. var config = JSON.parse(fs.readFileSync(file))
  76. if (config.browserlist && !config.browserslist) {
  77. throw new BrowserslistError(
  78. '`browserlist` key instead of `browserslist` in ' + file
  79. )
  80. }
  81. var list = config.browserslist
  82. if (Array.isArray(list) || typeof list === 'string') {
  83. list = { defaults: list }
  84. }
  85. for (var i in list) {
  86. check(list[i])
  87. }
  88. return list
  89. }
  90. function latestReleaseTime (agents) {
  91. var latest = 0
  92. for (var name in agents) {
  93. var dates = agents[name].releaseDate || { }
  94. for (var key in dates) {
  95. if (latest < dates[key]) {
  96. latest = dates[key]
  97. }
  98. }
  99. }
  100. return latest * 1000
  101. }
  102. function normalizeStats (data, stats) {
  103. if (!data) {
  104. data = {}
  105. }
  106. if (stats && 'dataByBrowser' in stats) {
  107. stats = stats.dataByBrowser
  108. }
  109. if (typeof stats !== 'object') return undefined
  110. var normalized = { }
  111. for (var i in stats) {
  112. var versions = Object.keys(stats[i])
  113. if (
  114. versions.length === 1 &&
  115. data[i] &&
  116. data[i].versions.length === 1
  117. ) {
  118. var normal = data[i].versions[0]
  119. normalized[i] = { }
  120. normalized[i][normal] = stats[i][versions[0]]
  121. } else {
  122. normalized[i] = stats[i]
  123. }
  124. }
  125. return normalized
  126. }
  127. function normalizeUsageData (usageData, data) {
  128. for (var browser in usageData) {
  129. var browserUsage = usageData[browser]
  130. // eslint-disable-next-line max-len
  131. // https://github.com/browserslist/browserslist/issues/431#issuecomment-565230615
  132. // caniuse-db returns { 0: "percentage" } for `and_*` regional stats
  133. if ('0' in browserUsage) {
  134. var versions = data[browser].versions
  135. browserUsage[versions[versions.length - 1]] = browserUsage[0]
  136. delete browserUsage[0]
  137. }
  138. }
  139. }
  140. module.exports = {
  141. loadQueries: function loadQueries (ctx, name) {
  142. if (!ctx.dangerousExtend && !process.env.BROWSERSLIST_DANGEROUS_EXTEND) {
  143. checkExtend(name)
  144. }
  145. // eslint-disable-next-line security/detect-non-literal-require
  146. var queries = require(require.resolve(name, { paths: ['.'] }))
  147. if (queries) {
  148. if (Array.isArray(queries)) {
  149. return queries
  150. } else if (typeof queries === 'object') {
  151. if (!queries.defaults) queries.defaults = []
  152. return pickEnv(queries, ctx, name)
  153. }
  154. }
  155. throw new BrowserslistError(
  156. '`' + name + '` config exports not an array of queries' +
  157. ' or an object of envs'
  158. )
  159. },
  160. loadStat: function loadStat (ctx, name, data) {
  161. if (!ctx.dangerousExtend && !process.env.BROWSERSLIST_DANGEROUS_EXTEND) {
  162. checkExtend(name)
  163. }
  164. // eslint-disable-next-line security/detect-non-literal-require
  165. var stats = require(
  166. require.resolve(
  167. path.join(name, 'browserslist-stats.json'),
  168. { paths: ['.'] }
  169. )
  170. )
  171. return normalizeStats(data, stats)
  172. },
  173. getStat: function getStat (opts, data) {
  174. var stats
  175. if (opts.stats) {
  176. stats = opts.stats
  177. } else if (process.env.BROWSERSLIST_STATS) {
  178. stats = process.env.BROWSERSLIST_STATS
  179. } else if (opts.path && path.resolve && fs.existsSync) {
  180. stats = eachParent(opts.path, function (dir) {
  181. var file = path.join(dir, 'browserslist-stats.json')
  182. return isFile(file) ? file : undefined
  183. })
  184. }
  185. if (typeof stats === 'string') {
  186. try {
  187. stats = JSON.parse(fs.readFileSync(stats))
  188. } catch (e) {
  189. throw new BrowserslistError('Can\'t read ' + stats)
  190. }
  191. }
  192. return normalizeStats(data, stats)
  193. },
  194. loadConfig: function loadConfig (opts) {
  195. if (process.env.BROWSERSLIST) {
  196. return process.env.BROWSERSLIST
  197. } else if (opts.config || process.env.BROWSERSLIST_CONFIG) {
  198. var file = opts.config || process.env.BROWSERSLIST_CONFIG
  199. if (path.basename(file) === 'package.json') {
  200. return pickEnv(parsePackage(file), opts)
  201. } else {
  202. return pickEnv(module.exports.readConfig(file), opts)
  203. }
  204. } else if (opts.path) {
  205. return pickEnv(module.exports.findConfig(opts.path), opts)
  206. } else {
  207. return undefined
  208. }
  209. },
  210. loadCountry: function loadCountry (usage, country, data) {
  211. var code = country.replace(/[^\w-]/g, '')
  212. if (!usage[code]) {
  213. // eslint-disable-next-line security/detect-non-literal-require
  214. var compressed = require('caniuse-lite/data/regions/' + code + '.js')
  215. var usageData = region(compressed)
  216. normalizeUsageData(usageData, data)
  217. usage[country] = { }
  218. for (var i in usageData) {
  219. for (var j in usageData[i]) {
  220. usage[country][i + ' ' + j] = usageData[i][j]
  221. }
  222. }
  223. }
  224. },
  225. loadFeature: function loadFeature (features, name) {
  226. name = name.replace(/[^\w-]/g, '')
  227. if (features[name]) return
  228. // eslint-disable-next-line security/detect-non-literal-require
  229. var compressed = require('caniuse-lite/data/features/' + name + '.js')
  230. var stats = feature(compressed).stats
  231. features[name] = { }
  232. for (var i in stats) {
  233. for (var j in stats[i]) {
  234. features[name][i + ' ' + j] = stats[i][j]
  235. }
  236. }
  237. },
  238. parseConfig: function parseConfig (string) {
  239. var result = { defaults: [] }
  240. var sections = ['defaults']
  241. string.toString()
  242. .replace(/#[^\n]*/g, '')
  243. .split(/\n|,/)
  244. .map(function (line) {
  245. return line.trim()
  246. })
  247. .filter(function (line) {
  248. return line !== ''
  249. })
  250. .forEach(function (line) {
  251. if (IS_SECTION.test(line)) {
  252. sections = line.match(IS_SECTION)[1].trim().split(' ')
  253. sections.forEach(function (section) {
  254. if (result[section]) {
  255. throw new BrowserslistError(
  256. 'Duplicate section ' + section + ' in Browserslist config'
  257. )
  258. }
  259. result[section] = []
  260. })
  261. } else {
  262. sections.forEach(function (section) {
  263. result[section].push(line)
  264. })
  265. }
  266. })
  267. return result
  268. },
  269. readConfig: function readConfig (file) {
  270. if (!isFile(file)) {
  271. throw new BrowserslistError('Can\'t read ' + file + ' config')
  272. }
  273. return module.exports.parseConfig(fs.readFileSync(file))
  274. },
  275. findConfig: function findConfig (from) {
  276. from = path.resolve(from)
  277. var passed = []
  278. var resolved = eachParent(from, function (dir) {
  279. if (dir in configCache) {
  280. return configCache[dir]
  281. }
  282. passed.push(dir)
  283. var config = path.join(dir, 'browserslist')
  284. var pkg = path.join(dir, 'package.json')
  285. var rc = path.join(dir, '.browserslistrc')
  286. var pkgBrowserslist
  287. if (isFile(pkg)) {
  288. try {
  289. pkgBrowserslist = parsePackage(pkg)
  290. } catch (e) {
  291. if (e.name === 'BrowserslistError') throw e
  292. console.warn(
  293. '[Browserslist] Could not parse ' + pkg + '. Ignoring it.'
  294. )
  295. }
  296. }
  297. if (isFile(config) && pkgBrowserslist) {
  298. throw new BrowserslistError(
  299. dir + ' contains both browserslist and package.json with browsers'
  300. )
  301. } else if (isFile(rc) && pkgBrowserslist) {
  302. throw new BrowserslistError(
  303. dir + ' contains both .browserslistrc and package.json with browsers'
  304. )
  305. } else if (isFile(config) && isFile(rc)) {
  306. throw new BrowserslistError(
  307. dir + ' contains both .browserslistrc and browserslist'
  308. )
  309. } else if (isFile(config)) {
  310. return module.exports.readConfig(config)
  311. } else if (isFile(rc)) {
  312. return module.exports.readConfig(rc)
  313. } else {
  314. return pkgBrowserslist
  315. }
  316. })
  317. if (!process.env.BROWSERSLIST_DISABLE_CACHE) {
  318. passed.forEach(function (dir) {
  319. configCache[dir] = resolved
  320. })
  321. }
  322. return resolved
  323. },
  324. clearCaches: function clearCaches () {
  325. dataTimeChecked = false
  326. filenessCache = { }
  327. configCache = { }
  328. this.cache = { }
  329. },
  330. oldDataWarning: function oldDataWarning (agentsObj) {
  331. if (dataTimeChecked) return
  332. dataTimeChecked = true
  333. if (process.env.BROWSERSLIST_IGNORE_OLD_DATA) return
  334. var latest = latestReleaseTime(agentsObj)
  335. var halfYearAgo = Date.now() - TIME_TO_UPDATE_CANIUSE
  336. if (latest !== 0 && latest < halfYearAgo) {
  337. console.warn(
  338. 'Browserslist: caniuse-lite is outdated. Please run:\n' +
  339. ' npx browserslist@latest --update-db\n' +
  340. ' Why you should do it regularly: ' +
  341. 'https://github.com/browserslist/browserslist#browsers-data-updating'
  342. )
  343. }
  344. },
  345. currentNode: function currentNode () {
  346. return 'node ' + process.versions.node
  347. }
  348. }