# require-reload

> Reload a require'd module/file. Useful for hot-reloading classes.

Latest version **0.2.2** (published 2015-02-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install require-reload
pnpm add require-reload
yarn add require-reload
bun add require-reload
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.2 |
| Published | 2015-02-11 |
| First published | 2015-02-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.6.21 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 50 |
| Author | James Hartig |
| Maintainers | fastest963 |
| Keywords | hot-reload, modules, require, reload |

## Links

- npm: https://www.npmjs.com/package/require-reload
- Repository: https://github.com/fastest963/require-reload
- Issues: https://github.com/fastest963/require-reload/issues
- npm.io page: https://npm.io/package/require-reload

## Recent versions

- 0.2.2 (latest) — 2015-02-11
- 0.2.1 — 2015-02-11
- 0.2.0 — 2015-02-11
- 0.0.1 — 2015-02-11

## README

# require-reload #

require-reload facilitates hot-reloading files in node.js. Each call will re-fetch the file/module and `require` it.

## Example ##
```JS
//things will work just the same with require('require-reload') but see note after this example
var reload = require('require-reload')(require),
    api = reload('api.js');
//sometime later if you make changes to api.js, you can hot-reload it by calling
//this could also just be in a setInterval
try {
    api = reload('api.js');
} catch (e) {
    //if this threw an error, the api variable is still set to the old, working version
    console.error("Failed to reload api.js! Error: ", e);
}
```

## Notes/Caveats ##
Keep in mind that the cache is shared between child modules and their parents. If you want to reload your depdencies when
you're reloaded then you must also use `require-reload`. This is on purpose so things are not unintentionally reloaded.

Note: This uses internal methods to the module system without a context. These APIs may change at any time. I will keep this
maintained to support all version of Node.js >=0.6 and io.js >=1.0.4. Version management will be handled through npm.

**Because of this, it is recommend you use `require('require-reload')(require)` which works without any internal methods.**

## Advanced Usage ##

### reload([otherContext]) ###
If you want to run reload in the context of another module/file then pass in the `require` variable into `reload` to get an
instance that is bound to that context. The other module must return its require context to use this.
```JS
var otherModule = require('other-module'),
    reloadInContext = require('require-reload')(otherModule.requireCtx);
/*
 * other-module would need to do:
 * exports.requireCtx = require;
 */
```

### emptyCache([context]) ###
Empties the whole cache. Useful if you want to reload a file/module AND reload its dependencies. Optionally accepts a context
to clear another context's cache.

---
_Source: https://npm.io/package/require-reload · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._