提交学习笔记专用
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

333 lines
11 KiB

  1. var fs = require('fs');
  2. var getHomedir = require('./homedir');
  3. var path = require('path');
  4. var caller = require('./caller');
  5. var nodeModulesPaths = require('./node-modules-paths');
  6. var normalizeOptions = require('./normalize-options');
  7. var isCore = require('is-core-module');
  8. var realpathFS = process.platform !== 'win32' && fs.realpath && typeof fs.realpath.native === 'function' ? fs.realpath.native : fs.realpath;
  9. var relativePathRegex = /^(?:\.\.?(?:\/|$)|\/|([A-Za-z]:)?[/\\])/;
  10. var windowsDriveRegex = /^\w:[/\\]*$/;
  11. var nodeModulesRegex = /[/\\]node_modules[/\\]*$/;
  12. var homedir = getHomedir();
  13. var defaultPaths = function () {
  14. return [
  15. path.join(homedir, '.node_modules'),
  16. path.join(homedir, '.node_libraries')
  17. ];
  18. };
  19. var defaultIsFile = function isFile(file, cb) {
  20. fs.stat(file, function (err, stat) {
  21. if (!err) {
  22. return cb(null, stat.isFile() || stat.isFIFO());
  23. }
  24. if (err.code === 'ENOENT' || err.code === 'ENOTDIR') return cb(null, false);
  25. return cb(err);
  26. });
  27. };
  28. var defaultIsDir = function isDirectory(dir, cb) {
  29. fs.stat(dir, function (err, stat) {
  30. if (!err) {
  31. return cb(null, stat.isDirectory());
  32. }
  33. if (err.code === 'ENOENT' || err.code === 'ENOTDIR') return cb(null, false);
  34. return cb(err);
  35. });
  36. };
  37. var defaultRealpath = function realpath(x, cb) {
  38. realpathFS(x, function (realpathErr, realPath) {
  39. if (realpathErr && realpathErr.code !== 'ENOENT') cb(realpathErr);
  40. else cb(null, realpathErr ? x : realPath);
  41. });
  42. };
  43. var maybeRealpath = function maybeRealpath(realpath, x, opts, cb) {
  44. if (opts && opts.preserveSymlinks === false) {
  45. realpath(x, cb);
  46. } else {
  47. cb(null, x);
  48. }
  49. };
  50. var defaultReadPackage = function defaultReadPackage(readFile, pkgfile, cb) {
  51. readFile(pkgfile, function (readFileErr, body) {
  52. if (readFileErr) cb(readFileErr);
  53. else {
  54. try {
  55. var pkg = JSON.parse(body);
  56. cb(null, pkg);
  57. } catch (jsonErr) {
  58. cb(null);
  59. }
  60. }
  61. });
  62. };
  63. var getPackageCandidates = function getPackageCandidates(x, start, opts) {
  64. var dirs = nodeModulesPaths(start, opts, x);
  65. for (var i = 0; i < dirs.length; i++) {
  66. dirs[i] = path.join(dirs[i], x);
  67. }
  68. return dirs;
  69. };
  70. module.exports = function resolve(x, options, callback) {
  71. var cb = callback;
  72. var opts = options;
  73. if (typeof options === 'function') {
  74. cb = opts;
  75. opts = {};
  76. }
  77. if (typeof x !== 'string') {
  78. var err = new TypeError('Path must be a string.');
  79. return process.nextTick(function () {
  80. cb(err);
  81. });
  82. }
  83. opts = normalizeOptions(x, opts);
  84. var isFile = opts.isFile || defaultIsFile;
  85. var isDirectory = opts.isDirectory || defaultIsDir;
  86. var readFile = opts.readFile || fs.readFile;
  87. var realpath = opts.realpath || defaultRealpath;
  88. var readPackage = opts.readPackage || defaultReadPackage;
  89. if (opts.readFile && opts.readPackage) {
  90. var conflictErr = new TypeError('`readFile` and `readPackage` are mutually exclusive.');
  91. return process.nextTick(function () {
  92. cb(conflictErr);
  93. });
  94. }
  95. var packageIterator = opts.packageIterator;
  96. var extensions = opts.extensions || ['.js'];
  97. var includeCoreModules = opts.includeCoreModules !== false;
  98. var basedir = opts.basedir || path.dirname(caller());
  99. var parent = opts.filename || basedir;
  100. opts.paths = opts.paths || defaultPaths();
  101. // ensure that `basedir` is an absolute path at this point, resolving against the process' current working directory
  102. var absoluteStart = path.resolve(basedir);
  103. maybeRealpath(
  104. realpath,
  105. absoluteStart,
  106. opts,
  107. function (err, realStart) {
  108. if (err) cb(err);
  109. else init(realStart);
  110. }
  111. );
  112. var res;
  113. function init(basedir) {
  114. if (relativePathRegex.test(x)) {
  115. res = path.resolve(basedir, x);
  116. if (x === '.' || x === '..' || x.slice(-1) === '/') res += '/';
  117. if (x.slice(-1) === '/' && res === basedir) {
  118. loadAsDirectory(res, opts.package, onfile);
  119. } else loadAsFile(res, opts.package, onfile);
  120. } else if (includeCoreModules && isCore(x)) {
  121. return cb(null, x);
  122. } else loadNodeModules(x, basedir, function (err, n, pkg) {
  123. if (err) cb(err);
  124. else if (n) {
  125. return maybeRealpath(realpath, n, opts, function (err, realN) {
  126. if (err) {
  127. cb(err);
  128. } else {
  129. cb(null, realN, pkg);
  130. }
  131. });
  132. } else {
  133. var moduleError = new Error("Cannot find module '" + x + "' from '" + parent + "'");
  134. moduleError.code = 'MODULE_NOT_FOUND';
  135. cb(moduleError);
  136. }
  137. });
  138. }
  139. function onfile(err, m, pkg) {
  140. if (err) cb(err);
  141. else if (m) cb(null, m, pkg);
  142. else loadAsDirectory(res, function (err, d, pkg) {
  143. if (err) cb(err);
  144. else if (d) {
  145. maybeRealpath(realpath, d, opts, function (err, realD) {
  146. if (err) {
  147. cb(err);
  148. } else {
  149. cb(null, realD, pkg);
  150. }
  151. });
  152. } else {
  153. var moduleError = new Error("Cannot find module '" + x + "' from '" + parent + "'");
  154. moduleError.code = 'MODULE_NOT_FOUND';
  155. cb(moduleError);
  156. }
  157. });
  158. }
  159. function loadAsFile(x, thePackage, callback) {
  160. var loadAsFilePackage = thePackage;
  161. var cb = callback;
  162. if (typeof loadAsFilePackage === 'function') {
  163. cb = loadAsFilePackage;
  164. loadAsFilePackage = undefined;
  165. }
  166. var exts = [''].concat(extensions);
  167. load(exts, x, loadAsFilePackage);
  168. function load(exts, x, loadPackage) {
  169. if (exts.length === 0) return cb(null, undefined, loadPackage);
  170. var file = x + exts[0];
  171. var pkg = loadPackage;
  172. if (pkg) onpkg(null, pkg);
  173. else loadpkg(path.dirname(file), onpkg);
  174. function onpkg(err, pkg_, dir) {
  175. pkg = pkg_;
  176. if (err) return cb(err);
  177. if (dir && pkg && opts.pathFilter) {
  178. var rfile = path.relative(dir, file);
  179. var rel = rfile.slice(0, rfile.length - exts[0].length);
  180. var r = opts.pathFilter(pkg, x, rel);
  181. if (r) return load(
  182. [''].concat(extensions.slice()),
  183. path.resolve(dir, r),
  184. pkg
  185. );
  186. }
  187. isFile(file, onex);
  188. }
  189. function onex(err, ex) {
  190. if (err) return cb(err);
  191. if (ex) return cb(null, file, pkg);
  192. load(exts.slice(1), x, pkg);
  193. }
  194. }
  195. }
  196. function loadpkg(dir, cb) {
  197. if (dir === '' || dir === '/') return cb(null);
  198. if (process.platform === 'win32' && windowsDriveRegex.test(dir)) {
  199. return cb(null);
  200. }
  201. if (nodeModulesRegex.test(dir)) return cb(null);
  202. maybeRealpath(realpath, dir, opts, function (unwrapErr, pkgdir) {
  203. if (unwrapErr) return loadpkg(path.dirname(dir), cb);
  204. var pkgfile = path.join(pkgdir, 'package.json');
  205. isFile(pkgfile, function (err, ex) {
  206. // on err, ex is false
  207. if (!ex) return loadpkg(path.dirname(dir), cb);
  208. readPackage(readFile, pkgfile, function (err, pkgParam) {
  209. if (err) cb(err);
  210. var pkg = pkgParam;
  211. if (pkg && opts.packageFilter) {
  212. pkg = opts.packageFilter(pkg, pkgfile);
  213. }
  214. cb(null, pkg, dir);
  215. });
  216. });
  217. });
  218. }
  219. function loadAsDirectory(x, loadAsDirectoryPackage, callback) {
  220. var cb = callback;
  221. var fpkg = loadAsDirectoryPackage;
  222. if (typeof fpkg === 'function') {
  223. cb = fpkg;
  224. fpkg = opts.package;
  225. }
  226. maybeRealpath(realpath, x, opts, function (unwrapErr, pkgdir) {
  227. if (unwrapErr) return cb(unwrapErr);
  228. var pkgfile = path.join(pkgdir, 'package.json');
  229. isFile(pkgfile, function (err, ex) {
  230. if (err) return cb(err);
  231. if (!ex) return loadAsFile(path.join(x, 'index'), fpkg, cb);
  232. readPackage(readFile, pkgfile, function (err, pkgParam) {
  233. if (err) return cb(err);
  234. var pkg = pkgParam;
  235. if (pkg && opts.packageFilter) {
  236. pkg = opts.packageFilter(pkg, pkgfile);
  237. }
  238. if (pkg && pkg.main) {
  239. if (typeof pkg.main !== 'string') {
  240. var mainError = new TypeError('package “' + pkg.name + '” `main` must be a string');
  241. mainError.code = 'INVALID_PACKAGE_MAIN';
  242. return cb(mainError);
  243. }
  244. if (pkg.main === '.' || pkg.main === './') {
  245. pkg.main = 'index';
  246. }
  247. loadAsFile(path.resolve(x, pkg.main), pkg, function (err, m, pkg) {
  248. if (err) return cb(err);
  249. if (m) return cb(null, m, pkg);
  250. if (!pkg) return loadAsFile(path.join(x, 'index'), pkg, cb);
  251. var dir = path.resolve(x, pkg.main);
  252. loadAsDirectory(dir, pkg, function (err, n, pkg) {
  253. if (err) return cb(err);
  254. if (n) return cb(null, n, pkg);
  255. loadAsFile(path.join(x, 'index'), pkg, cb);
  256. });
  257. });
  258. return;
  259. }
  260. loadAsFile(path.join(x, '/index'), pkg, cb);
  261. });
  262. });
  263. });
  264. }
  265. function processDirs(cb, dirs) {
  266. if (dirs.length === 0) return cb(null, undefined);
  267. var dir = dirs[0];
  268. isDirectory(path.dirname(dir), isdir);
  269. function isdir(err, isdir) {
  270. if (err) return cb(err);
  271. if (!isdir) return processDirs(cb, dirs.slice(1));
  272. loadAsFile(dir, opts.package, onfile);
  273. }
  274. function onfile(err, m, pkg) {
  275. if (err) return cb(err);
  276. if (m) return cb(null, m, pkg);
  277. loadAsDirectory(dir, opts.package, ondir);
  278. }
  279. function ondir(err, n, pkg) {
  280. if (err) return cb(err);
  281. if (n) return cb(null, n, pkg);
  282. processDirs(cb, dirs.slice(1));
  283. }
  284. }
  285. function loadNodeModules(x, start, cb) {
  286. var thunk = function () { return getPackageCandidates(x, start, opts); };
  287. processDirs(
  288. cb,
  289. packageIterator ? packageIterator(x, start, thunk, opts) : thunk()
  290. );
  291. }
  292. };