# clear-require

> Clear a module from the `require` cache

Latest version **3.0.0** (published 2018-11-08) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

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

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2018-11-08 |
| First published | 2014-07-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/clear-require) |
| Module format | CommonJS |
| Node | >=4 |
| Dependencies | 2 |
| Unpacked size | 3.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 182 |
| Author | Sindre Sorhus |
| Maintainers | sindresorhus |
| Keywords | clear, require, cache, uncache, uncached, module, unrequire, derequire, delete, del, remove, rm |

## Links

- npm: https://www.npmjs.com/package/clear-require
- Repository: https://github.com/sindresorhus/clear-require
- Homepage: https://github.com/sindresorhus/clear-require#readme
- Issues: https://github.com/sindresorhus/clear-require/issues
- npm.io page: https://npm.io/package/clear-require

## Dependencies (2)

- [caller-path](https://npm.io/package/caller-path.md) ^2.0.0
- [resolve-from](https://npm.io/package/resolve-from.md) ^2.0.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 3.0.0 (latest) — 2018-11-08
- 2.0.0 — 2017-01-28
- 1.0.1 — 2014-07-20

## README

# clear-require [![Build Status](https://travis-ci.org/sindresorhus/clear-require.svg?branch=master)](https://travis-ci.org/sindresorhus/clear-require)

> Clear a module from the [`require` cache](https://nodejs.org/api/modules.html#modules_caching)

Useful for testing purposes when you need to freshly `require` a module.


## Install

```
$ npm install --save clear-require
```


## Usage

```js
// foo.js
let i = 0;
module.exports = () => ++i;
```

```js
const clearRequire = require('clear-require');

require('./foo')();
//=> 1

require('./foo')();
//=> 2

clearRequire('./foo');

require('./foo')();
//=> 1
```


## API

### clearRequire(moduleId)

#### moduleId

Type: `string`

What you would use with `require()`.

### clearRequire.all()

Clear all modules from the `require` cache.

### clearRequire.match(regex)

Clear all matching modules from the `require` cache.

#### regex

Type: `RegExp`

Regex to match against the module ID's.


## Related

- [require-uncached](https://github.com/sindresorhus/require-uncached) - Require a module bypassing the cache


## License

MIT © [Sindre Sorhus](https://sindresorhus.com)

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