1. module mock-require
   1. function mock-require (path, mockExport)
   2. function mock-require.reRequire (path)
   3. function mock-require.stop (path)
   4. function mock-require.stopAll ()

module mock-require

function mock-require (path, mockExport)

• description and source-code

  function startMocking(path, mockExport) {
    var calledFrom = callerId.getData().filePath;
  
    if (typeof mockExport === 'string') {
      mockExport = getFullPath(mockExport, calledFrom);
    }
  
    pendingMockExports[getFullPath(path, calledFrom)] = mockExport;
  }

• example usage

  n/a

function mock-require.reRequire (path)

• description and source-code

  function reRequire(path) {
    var module = getFullPath(path, callerId.getData().filePath);
    delete require.cache[require.resolve(module)];
    return require(module);
  }

• example usage

  ...
  var fs2 = require('fs');
  var path2 = require('path');
  
  fs1 === fs2; // false
  path1 === path2; // false
  ```
  
  ### `mock.reRequire(path)`
  
  __path__: `String`
  
  The file whose cache you want to refresh. This is useful if you're trying to mock a dependency for a file that has already
  been required elsewhere (possibly in another test file). Normally, Node.js will cache this file, so any mocks that you apply afterwards
   will have no effect. `reRequire` clears the cache and allows your mock to work.
  
  ```javascript
  var fs = require('fs');
  ...

function mock-require.stop (path)

• description and source-code

  function stopMocking(path) {
    var calledFrom = callerId.getData().filePath;
    var fullPath = getFullPath(path, calledFrom);
    delete pendingMockExports[fullPath];
    delete mockExports[fullPath];
  }

• example usage

  ...
  `test/b_spec.js`:
  ```javascript
  var mock = require('mock-require');
  mock('../some/other/dependency', './spy');
  ...
  ```
  
  ### `mock.stop(path)`
  
  __path__: `String`
  
  The module you that you want to stop mocking.  This is the same string you would pass in if you wanted to `require` the module.
  
  This will only modify variables used after `mock.stop` is called.  For example:
  ...

function mock-require.stopAll ()

• description and source-code

  function stopMockingAll() {
    mockExports = {};
    pendingMockExports = {};
  }

• example usage

  ...
  mock.stop('fs');
  
  var fs2 = require('fs');
  
  fs1 === fs2; // false
  ```
  
  ### `mock.stopAll()`
  
  This function can be used to remove all registered mocks without the need to remove them individually using `mock.stop()`.
  
  ```javascript
  mock('fs', {});
  mock('path', {});
  ...