Finds the absolute file path to the original source code that defines a value in node.
You may want to use this package if you're looking to do code introspection. When you import or require a file, it often isn't the file that actually defines the sourcecode for the variable you've just imported. This package lets you get the filepaths for the original source of your imported values.
$ npm install require-source-filepath
const getSourcePath = require('require-source-filepath');
const { value1, value2 } = require('./values');
const { value3 } = require('values');
const paths = getSourcePath([value1, value2, value3]);
// paths = [
// 'path/to/original/sourcefile/of/value1',
// 'path/to/original/sourcefile/of/value2',
// 'path/to/original/sourcefile/of/value3',
// ]
require-source-filepath
traverses node's global module
variable recursively comparing exports from each export against the arguments. When it finds the deepest leaf node it
returns the path of that file. It handles circular dependencies by traversing with a backtracking DFS.
Due to its implementation and the data-structure of module
,
require-source-filepath
may not always return the correct source file for any value types
(number, string, bool etc.) and is not recommended for their use.
If more than 2 files in the dependency tree export the same value type,
require-source-filepath
will return whichever file comes last in the dependency
tree, regardless of whether it was the actual imported value or not.
require-source-filepath
always returns the correct source file for all reference types (array's, function's, objects, classes, etc)