# rechoir

[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Travis Build Status][travis-image]][travis-url] [![AppVeyor Build Status][appveyor-image]][appveyor-url] [![Coveralls Status][coveralls-image]][coveralls-url] [![Gitter chat][gitter-image]][gitter-url]

[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Coveralls Status][coveralls-image]][coveralls-url]

Prepare a node environment to require files with different extensions.

## What is it?

This module, in conjunction with [interpret]-like objects, can register any filetype the npm ecosystem has a module loader for. This library is a dependency of [Liftoff].

This module, in conjunction with [interpret]-like objects, can register any filetype the npm ecosystem has a module loader for. This library is a dependency of [liftoff].

**Note:** While `rechoir` will automatically load and register transpilers like `coffee-script`, you must provide a local installation. The transpilers are **not** bundled with this module.

## rechoir for enterprise

Available as part of the Tidelift Subscription

The maintainers of rechoir and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-rechoir?utm_source=npm-rechoir&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)

## Usage

```js

### `prepare(config, filepath, [cwd], [noThrow])`

Look for a module loader associated with the provided file and attempt require it. If necessary, run any setup required to inject it into [require.extensions](http://nodejs.org/api/globals.html#globals_require_extensions).

Look for a module loader associated with the provided file and attempt require it. If necessary, run any setup required to inject it into [require.extensions].

`config` An [interpret]-like configuration object.

`filepath` A file whose type you'd like to register a module loader for.

`cwd` An optional path to start searching for the module required to load the requested file. Defaults to the directory of `filepath`.

`cwd` An optional path to start searching for the module required to load the requested file. Defaults to the directory of `filepath`.

`noThrow` An optional boolean indicating if the method should avoid throwing.

MIT

[interpret]: http://github.com/gulpjs/interpret

[Liftoff]: http://github.com/gulpjs/liftoff

[downloads-image]: http://img.shields.io/npm/dm/rechoir.svg

<!-- prettier-ignore-start -->

[downloads-image]: https://img.shields.io/npm/dm/rechoir.svg?style=flat-square

[npm-url]: https://www.npmjs.com/package/rechoir

[npm-image]: http://img.shields.io/npm/v/rechoir.svg

[travis-url]: https://travis-ci.org/gulpjs/rechoir

[travis-image]: http://img.shields.io/travis/gulpjs/rechoir.svg?label=travis-ci

[npm-image]: https://img.shields.io/npm/v/rechoir.svg?style=flat-square

[appveyor-url]: https://ci.appveyor.com/project/gulpjs/rechoir

[appveyor-image]: https://img.shields.io/appveyor/ci/gulpjs/rechoir.svg?label=appveyor

[ci-url]: https://github.com/gulpjs/rechoir/actions?query=workflow:dev

[ci-image]: https://img.shields.io/github/workflow/status/gulpjs/rechoir/dev?style=flat-square

[coveralls-url]: https://coveralls.io/r/gulpjs/rechoir

[coveralls-image]: http://img.shields.io/coveralls/gulpjs/rechoir/master.svg

[gitter-url]: https://gitter.im/gulpjs/gulp

[gitter-image]: https://badges.gitter.im/gulpjs/gulp.svg

[coveralls-image]: https://img.shields.io/coveralls/gulpjs/rechoir/master.svg

<!-- prettier-ignore-end -->

<!-- prettier-ignore-start -->

[interpret]: https://github.com/gulpjs/interpret

[require.extensions]: https://nodejs.org/api/modules.html#modules_require_extensions

[liftoff]: https://github.com/js-cli/js-liftoff

<!-- prettier-ignore-end -->