Merge 8683af3 into 534ddbb

docs/_howto/stub-dependency.md

@@ -0,0 +1,21 @@
+---
+layout: page
+title: How to stub a dependency of a module?
+---
+
+To stub dependency(imported module) of a module under test you have to import it explicitly in your test and stub the desired method.
+
+## Example
+
+```javascript
+import * as importedModule from "./importedModule";
+import {getTheSecret} from "./moduleUnderTest";
+
+"test should get secret": function () {
+    sinon.stub(importedModule, "getSecretNumber").returns(3);
+
+    const result = getTheSecret();
+
+    assert(result).toBe('The secret was: 3');
+}
+```

docs/_releases/latest/stubs.md

@@ -76,6 +76,8 @@ Replaces `object.method` with a stub function. An exception is thrown if the pro
 
 The original function can be restored by calling `object.method.restore();` (or `stub.restore();`).
 
+A dependency of a module can be stubbed [see example](../../_howto/stub-dependency.md).
+
 #### ~~`var stub = sinon.stub(object, "method", func);`~~
 
 This has been removed from `v3.0.0`. Instead you should use