/*! * detect-file * * Copyright (c) 2016-2017, Brian Woodward. * Released under the MIT License. */ 'use strict'; var fs = require('fs'); var path = require('path'); /** * Detect the given `filepath` if it exists. * * ```js * var res = detect('package.json'); * console.log(res); * //=> "package.json" * * var res = detect('fake-file.json'); * console.log(res) * //=> null * ``` * * @param {String} `filepath` filepath to detect. * @param {Object} `options` Additional options. * @param {Boolean} `options.nocase` Set this to `true` to force case-insensitive filename checks. This is useful on case sensitive file systems. * @return {String} Returns the detected filepath if it exists, otherwise returns `null`. * @api public */ module.exports = function detect(filepath, options) { if (!filepath || (typeof filepath !== 'string')) { return null; } if (fs.existsSync(filepath)) { return path.resolve(filepath); } options = options || {}; if (options.nocase === true) { return nocase(filepath); } return null; }; /** * Check if the filepath exists by falling back to reading in the entire directory. * Returns the real filepath (for case sensitive file systems) if found. * * @param {String} `filepath` filepath to check. * @return {String} Returns found filepath if exists, otherwise null. */ function nocase(filepath) { filepath = path.resolve(filepath); var res = tryReaddir(filepath); if (res === null) { return null; } // "filepath" is a directory, an error would be // thrown if it doesn't exist. if we're here, it exists if (res.path === filepath) { return res.path; } // "filepath" is not a directory // compare against upper case later // see https://nodejs.org/en/docs/guides/working-with-different-filesystems/ var upper = filepath.toUpperCase(); var len = res.files.length; var idx = -1; while (++idx < len) { var fp = path.resolve(res.path, res.files[idx]); if (filepath === fp || upper === fp) { return fp; } var fpUpper = fp.toUpperCase(); if (filepath === fpUpper || upper === fpUpper) { return fp; } } return null; } /** * Try to read the filepath as a directory first, then fallback to the filepath's dirname. * * @param {String} `filepath` path of the directory to read. * @return {Object} Object containing `path` and `files` if succesful. Otherwise, null. */ function tryReaddir(filepath) { var ctx = { path: filepath, files: [] }; try { ctx.files = fs.readdirSync(filepath); return ctx; } catch (err) {} try { ctx.path = path.dirname(filepath); ctx.files = fs.readdirSync(ctx.path); return ctx; } catch (err) {} return null; }