nock 11.3.6 → 11.7.0

package/examples/.eslintrc.yml

@@ -1,3 +0,0 @@
-rules:
-  no-console: 'off'
-  strict: 'off'

package/examples/_log.js

@@ -1,12 +0,0 @@
-module.exports = log
-
-const start = Date.now()
-
-function log(emitter, name) {
-  return function(event) {
-    emitter.on(event, function() {
-      const lag = `${Math.round((Date.now() - start) / 100) / 10} sec`
-      console.log('[%s] %s => %s', lag, name, event)
-    })
-  }
-}

package/examples/delay-connection.js

@@ -1,15 +0,0 @@
-const http = require('http')
-const nock = require('../')
-const log = require('./_log')
-const events = ['socket', 'response', 'end', 'data']
-
-nock('http://delayconnection.com')
-  .get('/')
-  .delayConnection(1000)
-  .reply(200, 'hey')
-
-const req = http.get('http://delayconnection.com', function(res) {
-  events.forEach(log(res, 'res'))
-})
-
-events.forEach(log(req, 'req'))

package/examples/delay-response.js

@@ -1,15 +0,0 @@
-const http = require('http')
-const nock = require('../')
-const log = require('./_log')
-const events = ['socket', 'response', 'end', 'data']
-
-nock('http://delayconnection.com')
-  .get('/')
-  .delay(1000)
-  .reply(200, 'hey')
-
-const req = http.get('http://delayconnection.com', function(res) {
-  events.forEach(log(res, 'res'))
-})
-
-events.forEach(log(req, 'req'))

package/examples/net-connect-default-no-mock.js

@@ -1,18 +0,0 @@
-/*
-Default net connect.
-No mock.
-Result: Nock allows request to proceed.
-*/
-
-const log = require('./_log')
-
-const events = ['socket', 'response', 'end', 'data', 'error']
-
-const http = require('http')
-console.log('making request...')
-const req = http.get('http://www.google.com/', function(res) {
-  console.log('request result: res.statusCode = %j', res.statusCode)
-  events.forEach(log(res, 'res'))
-})
-
-events.forEach(log(req, 'req'))

package/examples/net-connect-default-other-mock.js

@@ -1,23 +0,0 @@
-/*
-Default net connect.
-Mock the different hostname:port.
-Result: Nock allows request to proceed.
-*/
-
-const log = require('./_log')
-
-const events = ['socket', 'response', 'end', 'data', 'error']
-
-const nock = require('../')
-
-nock('http://someotherservice.com')
-  .get('/')
-  .reply(200, 'whaaa')
-
-const http = require('http')
-const req = http.get('http://www.google.com/', function(res) {
-  console.log('request result: res.statusCode = %j', res.statusCode)
-  events.forEach(log(res, 'res'))
-})
-
-events.forEach(log(req, 'req'))

package/examples/net-connect-disabled-different-host.js

@@ -1,26 +0,0 @@
-/*
-Disabled net connect.
-Mock the different hostname:port.
-Result: Nock does not allow request to proceed.
-*/
-
-const log = require('./_log')
-
-const events = ['socket', 'response', 'end', 'data', 'error']
-
-const nock = require('../')
-
-nock.disableNetConnect()
-
-nock('http://someotherservice.com')
-  .get('/')
-  .reply(200, 'whaaa')
-
-const http = require('http')
-const req = http.get('http://www.google.com/')
-
-req.once('error', function(err) {
-  console.log(err.stack)
-})
-
-events.forEach(log(req, 'req'))

package/examples/net-connect-mock-same-host-different-path.js

@@ -1,24 +0,0 @@
-/*
-Default net connect.
-Mock the same hostname:port, different path.
-Result: Nock does not allow request to proceed.
-*/
-
-const log = require('./_log')
-
-const events = ['socket', 'response', 'end', 'data', 'error']
-
-const nock = require('../')
-
-nock('http://example.com')
-  .get('/path')
-  .reply(200, 'whaaa')
-
-const http = require('http')
-const req = http.get('http://example.com/other-path')
-
-req.once('error', function(err) {
-  console.log(err.stack)
-})
-
-events.forEach(log(req, 'req'))

package/examples/socket-delay-abort.js

@@ -1,19 +0,0 @@
-const http = require('http')
-const nock = require('../')
-const log = require('./_log')
-const events = ['socket', 'response', 'end', 'data', 'timeout', 'error']
-
-nock('http://delayconnection.com')
-  .get('/')
-  .socketDelay(2000)
-  .reply(200, 'hey')
-
-const req = http.get('http://delayconnection.com', function(res) {
-  events.forEach(log(res, 'res'))
-})
-
-req.setTimeout(1000, function() {
-  req.abort()
-})
-
-events.forEach(log(req, 'req'))

package/examples/socket-delay-no-abort.js

@@ -1,15 +0,0 @@
-const http = require('http')
-const nock = require('../')
-const log = require('./_log')
-const events = ['socket', 'response', 'end', 'data', 'timeout', 'error']
-
-nock('http://delayconnection.com')
-  .get('/')
-  .socketDelay(2000)
-  .reply(200, 'hey')
-
-const req = http.get('http://delayconnection.com', function(res) {
-  events.forEach(log(res, 'res'))
-})
-
-events.forEach(log(req, 'req'))

package/rfcs/rfc-001.md

@@ -1,43 +0,0 @@
-# Analysis of lifecycle methods
-
-![](https://img.shields.io/badge/rfc-001-blue.svg)
-![](https://img.shields.io/badge/status-draft-orange.svg)
-
-Nock's lifecycle methods are confusingly named, and at times are inconvenient.
-It can take a lot of studying to understand how to use them. It's also easy to
-misunderstand what these methods are doing, and leave unwanted state in
-`nock`. This RFC analyzes the most common use cases and the function calls
-needed for each one.
-
-Nock doesn't automatically have a way to assert that mocks have been
-satisfied; it's the caller's responsibility to do this for each one.
-
-See
-https://github.com/paulmelnikow/icedfrisby-nock/blob/master/icedfrisby-nock.js
-for an attempt at getting the lifecycle right.
-
-Subsequent RFCs will propose changes to the lifecycle APIs which better
-accommodate these use cases.
-
-## Typical use cases
-
-1. Assert that all mocks have been satisfied.
-2. Completely reset `nock` after a test.
-3. Allowing unmocked requests only to certain hosts.
-4. Preventing unmocked requests entirely.
-5. Simulating network connection failures.
-6. Temporarily disabling http call interception while preserving registered mocks.
-7. Turn `nock` all the way off and clean up its state (\*\* I've actually never
-   wanted to do this, but wanted to include it in the analysis)
-
-## Analysis
-
-| Use case                                                                | Code                                                                                                         | Assessment                                                                                                                                                           |
-| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Assert that all mocks have been satisfied                               | `scopes.forEach(scope => scope.done())`. When using `nockBack`, `assert.deepEqual(scope.pendingMocks(), [])` | `done()` could have a more explicit name, though otherwise this is fairly clear. However it requires the caller to keep track of all the scopes, which is not ideal. |
-| Reset `nock` after a test to its initial post-`require()` state         | `nock.restore(); nock.cleanAll(); nock.enableNetConnect(); nock.activate()`                                  | This is too much typing.                                                                                                                                             |
-| Forbid unmocked requests                                                | `nock.disableNetConnect()`                                                                                   | This _looks_ okay, but it doesn't have the desired effect. Errors are received by the client code and often swallowed up by the application (#884).                  |
-| Allow unmocked requests, but only to certain hosts                      | `nock.disableNetConnect(); nock.enableNetConnect('example.com')`                                             | This is a common use case, and should be possible to do more succintly, with a single call.                                                                          |
-| Simulate network connection failure                                     | N/A                                                                                                          | This is what `disableNetConnect()` does today. However from the function name, it's not really clear this is the intention.                                          |
-| Temporarily disable http interception while preserving registered mocks | `nock.restore()`                                                                                             | This is a confusing name, as it only cleans _part_ of nock's state.                                                                                                  |
-| Turn `nock` all the way off and clean up its state                      | `nock.restore(); nock.cleanAll()`                                                                            | `restore()` is a confusing name. This isn't the most common use case, so it is probably okay that it requires two function calls.                                    |