require-self-ref
v2.0.1
Published
Solves the relative path problem in Node.js by allowing a require call to reference the current package
Downloads
6,514
Readme
require-self-ref
Solves the relative path problem in Node.js by allowing a require
call to reference its containing package:
For example:
Given a JavaScript module at my-package/src/some/deeply/nested/path/foo/index.js
that needs to require my-package/src/util/bar.js
:
Without require-self-ref
:
require('../../../../../../util/bar');
:confused:
And with require-self-ref
installed:
require('~/src/util/bar');
:smile:
Installation
npm install require-self-ref
Usage
At the top of the main entry for your application add the following line:
require('require-self-ref');
Important
- Your package must have a
package.json
file at the root and thatpackage.json
file must have a"name"
property - Use at your own risk (this package monkey-patches the Node.js require system and it depends on internals of Node.js that may change in the future)
- Compatible with all versions of Node.js
Related projects:
- app-module-path - Simple module to add additional directories to the Node module search for top-level app modules
- wavy - Similar to this package, but requires a
postinstall
script and symbolic links
License
MIT