https://github.com/goto-bus-stop/require-with-global

inject a global variable into a module require() tree
https://github.com/goto-bus-stop/require-with-global

global inject insert mock require variable

Last synced: 2 days ago
JSON representation

inject a global variable into a module require() tree

• Host: GitHub
• URL: https://github.com/goto-bus-stop/require-with-global
• Owner: goto-bus-stop
• License: other
• Created: 2018-04-18T10:27:11.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2022-04-21T04:17:00.000Z (over 2 years ago)
• Last Synced: 2024-09-14T12:08:17.160Z (19 days ago)
• Topics: global, inject, insert, mock, require, variable
• Language: JavaScript
• Size: 19.5 KB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# require-with-global

inject a global variable into a module require() tree

[![npm][npm-image]][npm-url]

[![travis][travis-image]][travis-url]

[![standard][standard-image]][standard-url]

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

[npm-url]: https://www.npmjs.com/package/require-with-global

[travis-image]: https://img.shields.io/travis/goto-bus-stop/require-with-global.svg?style=flat-square

[travis-url]: https://travis-ci.org/goto-bus-stop/require-with-global

[standard-image]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square

[standard-url]: http://npm.im/standard

## Install

```

npm install require-with-global

```

## Usage

```js

var withGlobal = require('require-with-global')

var uppercaseStream = require('through2')(function (chunk, enc, next) {

  next(null, chunk.toUpperCase())

})

var virtualConsole = require('console').Console(uppercaseStream)

var r = withGlobal()

// `console` in ./app.js and all child modules will be `virtualConsole`.

var app = r('./app', {

  console: virtualConsole

})

app.run()

uppercaseStream.pipe(process.stdout)

r.remove() // Remove the require hook

```

## API

### `req = withGlobal()`

Create a `require` function that can be used to inject module-global variables.

### `req(specifier, vars)`

Require the module at `specifier`, injecting `vars` into all its deeply required

modules. All the variables specified in the `vars` object will be available in

modules required using the `req` function. Calls to `require()` inside the

module will be wrapped so that `vars` are also recursively injected in

dependencies of the module.

### `req.remove()`

Remove the compile hooks and global state that `withGlobal` uses to inject

variables into modules.

Note that globals that were already injected will continue to work; it's

perfectly safe to call `req.remove()` immediately after requiring some modules,

if you are certain that there are no lazy require() calls left.

## License

[Apache-2.0](LICENSE.md)