# safe-require

> Safe version of require that returns undefined rather than throwing an error when the module is not found.

Latest version **1.0.4** (published 2020-07-19) · Fair license · 0 weekly downloads

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

## Install

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

## Health

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

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.0.4 |
| Published | 2020-07-19 |
| First published | 2014-10-28 |
| Weekly downloads | 0 |
| License | Fair |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 3.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Talles L |
| Maintainers | talles |
| Keywords | safe, require |

## Links

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

## Recent versions

- 1.0.4 (latest) — 2020-07-19
- 1.0.3 — 2016-07-17
- 1.0.2 — 2016-07-10
- 1.0.1 — 2014-11-09
- 1.0.0 — 2014-10-28

## README

# safe-require

[![][build-img]][build]
[![][coverage-img]][coverage]
[![][dependencies-img]][dependencies]
[![][devdependencies-img]][devdependencies]
[![][npm-img]][npm]

A function that acts pretty much like [require](http://nodejs.org/api/globals.html#globals_require) but returns
undefined when the module is not found (instead of throwing an exception).

[build]:               https://travis-ci.org/tallesl/node-safe-require
[build-img]:           https://travis-ci.org/tallesl/node-safe-require.svg
[coverage]:            https://coveralls.io/r/tallesl/node-safe-require?branch=master
[coverage-img]:        https://coveralls.io/repos/tallesl/node-safe-require/badge.svg?branch=master
[dependencies]:        https://david-dm.org/tallesl/node-safe-require
[dependencies-img]:    https://david-dm.org/tallesl/node-safe-require.svg
[devdependencies]:     https://david-dm.org/tallesl/node-safe-require#info=devDependencies
[devdependencies-img]: https://david-dm.org/tallesl/node-safe-require/dev-status.svg
[npm]:                 https://www.npmjs.com/package/safe-require
[npm-img]:             https://badge.fury.io/js/safe-require.svg

## Usage

```
$ npm install safe-require
(...)
$ node
> var safeRequire = require('safe-require')
undefined
> safeRequire('url') // loads any module, local or not, just as require()
{ parse: [Function: urlParse],
  resolve: [Function: urlResolve],
  resolveObject: [Function: urlResolveObject],
  format: [Function: urlFormat],
  Url: [Function: Url] }
> safeRequire('nonexistent') // require('nonexistent') would throw "Cannot find module 'nonexistent'"
undefined
```

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