nock · dependabot · May 16, 2025 · May 16, 2025 · May 18, 2025 · May 27, 2025
diff --git a/.eslintignore b/.eslintignore
diff --git a/.eslintrc.yml b/.eslintrc.yml
diff --git a/.github/workflows/continuous-integration.yaml b/.github/workflows/continuous-integration.yaml
@@ -73,7 +73,6 @@ jobs:
       fail-fast: false
       matrix:
         node-version:
-          - 18
           - 20
           - 22
         os:

diff --git a/.gitignore b/.gitignore
@@ -4,5 +4,4 @@
 .vscode
 coverage
 node_modules
-npm-debug.log
-tests/browserify-public/browserify-bundle.js
+npm-debug.log
diff --git a/.prettierignore b/.prettierignore
@@ -3,4 +3,4 @@ package-lock.json
 tsconfig.json
 /.nyc_output
 /coverage
-/tests/browserify-public/browserify-bundle.js
+migration_guides
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,3 +4,9 @@ Nock’s changelog can be found directly in the [GitHub release notes](https://g
 These are automatically created by [semantic-release](https://github.com/semantic-release/semantic-release) based on their [commit message conventions](https://semantic-release.gitbook.io/semantic-release#commit-message-format).
 
 Migration guides are available for major versions in the [migration guides directory](https://github.com/nock/nock/tree/main/migration_guides).
+
+This release aim to modernize and refresh `nock`, remove long-supported hacks and create more expected library.
+
+TODO:
+
+1. remove @definitelytyped/dtslint and generate the types instead. maybe use tools like tsd to test the types (not sure if needed in case we generate the types)
diff --git a/README.md b/README.md
@@ -1311,7 +1311,7 @@ nock.removeInterceptor({
   hostname: 'localhost',
   path: '/mockedResource',
   // method defaults to `GET`
-  // proto defaullts to `http`
+  // proto defaults to `http`
 })
 ```
 
@@ -1353,9 +1353,39 @@ A scope emits the following events:
 You can also listen for no match events like this:
 
 ```js
-nock.emitter.on('no match', req => {})
+nock.emitter.on('no match', (req, interceptorResults) => {
+  console.log('Request did not match any interceptors:', req.url)
+
+  if (interceptorResults && interceptorResults.length > 0) {
+    interceptorResults.forEach(({ interceptor, reasons }) => {
+      console.log(
+        'Interceptor:',
+        interceptor.method,
+        interceptor.basePath + interceptor.path,
+      )
+      console.log('Reasons:', reasons)
+    })
+  }
+})
 ```
 
+The callback receives two parameters:
+
+- `req` - The request object that didn't match
+- `interceptorResults` - An array of objects containing detailed information about each interceptor that was tested.
+  Each object contains:
+  - `interceptor` - The interceptor that was tested against the request
+  - `reasons` - An array of strings describing why the request didn't match this interceptor
+    > ⚠️ **Experimental**: The structure and format of the detailed mismatch information may change in future versions as we gather user feedback and refine the API. The feature itself is stable and ready for use and we're seeking community input on the API design before marking it stable.
+
+Common mismatch reasons include:
+
+- **Method mismatch**: `"Method mismatch: expected GET, got POST"`
+- **Path mismatch**: `"Path mismatch: expected /api/users, got /api/posts"`
+- **Header mismatch**: `"Header mismatch: expected authorization to match Bearer token, got null"`
+- **Body mismatch**: `"Body mismatch: expected "expected body", got actual body"`
+- **Query mismatch**: `"query matching failed"`
+
 ## Nock Back
 
 Fixture recording support and playback.

diff --git a/eslint.config.mjs b/eslint.config.mjs
@@ -0,0 +1,36 @@
+import js from "@eslint/js";
+import globals from "globals";
+import { defineConfig } from "eslint/config";
+import prettier from "eslint-config-prettier/flat";
+import mocha from "eslint-plugin-mocha";
+import node from "eslint-plugin-n";
+
+export default defineConfig([
+  {
+    files: ["**/*.js"],
+    plugins: { js },
+    extends: ["js/recommended"],
+    languageOptions: { globals: globals.node, sourceType: 'commonjs' },
+    ignores: ['node_modules', 'coverage'],
+  },
+  {
+    plugins: { n: node },
+    extends: [node.configs["flat/recommended"]],
+    rules: {
+      'n/no-unsupported-features/node-builtins': ['error', { allowExperimental: true }],
+      'n/prefer-node-protocol': 'error',
+    }
+  },
+  {
+    plugins: { mocha },
+    extends: [mocha.configs.recommended],
+    files: ["tests/**/*.js"],
+    rules: {
+      "mocha/no-pending-tests": "off", // until we will fix all tests
+      "mocha/no-mocha-arrows": "off",
+      "mocha/no-identical-title": "off",
+      "mocha/no-top-level-hooks": "off",
+    },
+  },
+  prettier
+]);
diff --git a/examples/binary-reply.js b/examples/binary-reply.js
@@ -1,6 +1,6 @@
-const http = require('http')
-const fs = require('fs')
-const path = require('path')
+const http = require('node:http')
+const fs = require('node:fs')
+const path = require('node:path')
 
 const nock = require('../')
 

diff --git a/examples/delay-connection.js b/examples/delay-connection.js
diff --git a/examples/delay-response.js b/examples/delay-response.js
@@ -1,4 +1,4 @@
-const http = require('http')
+const http = require('node:http')
 const nock = require('../')
 const log = require('./_log')
 const events = ['socket', 'response', 'end', 'data']

diff --git a/examples/net-connect-default-no-mock.js b/examples/net-connect-default-no-mock.js
@@ -8,7 +8,7 @@ const log = require('./_log')
 
 const events = ['socket', 'response', 'end', 'data', 'error']
 
-const http = require('http')
+const http = require('node:http')
 console.log('making request...')
 const req = http.get('http://www.google.com/', function (res) {
   console.log('request result: res.statusCode = %j', res.statusCode)

diff --git a/examples/net-connect-default-other-mock.js b/examples/net-connect-default-other-mock.js
@@ -12,7 +12,7 @@ const nock = require('../')
 
 nock('http://someotherservice.com').get('/').reply(200, 'whaaa')
 
-const http = require('http')
+const http = require('node: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'))

diff --git a/examples/net-connect-disabled-different-host.js b/examples/net-connect-disabled-different-host.js
@@ -14,7 +14,7 @@ nock.disableNetConnect()
 
 nock('http://someotherservice.com').get('/').reply(200, 'whaaa')
 
-const http = require('http')
+const http = require('node:http')
 const req = http.get('http://www.google.com/')
 
 req.once('error', function (err) {

diff --git a/examples/net-connect-mock-same-host-different-path.js b/examples/net-connect-mock-same-host-different-path.js
@@ -12,7 +12,7 @@ const nock = require('../')
 
 nock('http://example.com').get('/path').reply(200, 'whaaa')
 
-const http = require('http')
+const http = require('node:http')
 const req = http.get('http://example.com/other-path')
 
 req.once('error', function (err) {

diff --git a/examples/socket-delay-abort.js b/examples/socket-delay-abort.js
@@ -1,4 +1,4 @@
-const http = require('http')
+const http = require('node:http')
 const nock = require('../')
 const log = require('./_log')
 const events = ['socket', 'response', 'end', 'data', 'timeout', 'error']

diff --git a/examples/socket-delay-no-abort.js b/examples/socket-delay-no-abort.js
@@ -1,4 +1,4 @@
-const http = require('http')
+const http = require('node:http')
 const nock = require('../')
 const log = require('./_log')
 const events = ['socket', 'response', 'end', 'data', 'timeout', 'error']

diff --git a/index.js b/index.js
@@ -17,6 +17,7 @@ const {
 } = require('./lib/intercept')
 const recorder = require('./lib/recorder')
 const { Scope, load, loadDefs, define } = require('./lib/scope')
+const { getDecompressedGetBody } = require('./lib/utils/node')
 
 module.exports = (basePath, options) => new Scope(basePath, options)
 
@@ -42,6 +43,7 @@ Object.assign(module.exports, {
   },
   restore: recorder.restore,
   back,
+  getDecompressedGetBody,
 })
 
 // We always activate Nock on import, overriding the globals.

diff --git a/lib/back.js b/lib/back.js
@@ -1,6 +1,7 @@
 'use strict'
 
-const assert = require('assert')
+const fs = require('node:fs')
+const assert = require('node:assert')
 const recorder = require('./recorder')
 const {
   activate,
@@ -10,19 +11,11 @@ const {
 } = require('./intercept')
 const { loadDefs, define } = require('./scope')
 const { back: debug } = require('./debug')
-const { format } = require('util')
-const path = require('path')
+const { format } = require('node:util')
+const path = require('node:path')
 
 let _mode = null
 
-let fs
-
-try {
-  fs = require('fs')
-} catch (err) {
-  // do nothing, probably in browser
-}
-
 /**
  * nock the current function with the fixture given
  *
@@ -198,7 +191,7 @@ const update = {
     return context
   },
 
-  finish: function (fixture, options, context) {
+  finish: function (fixture, options) {
     let outputs = recorder.outputs()
 
     if (typeof options.afterRecord === 'function') {
@@ -271,7 +264,7 @@ function load(fixture, options) {
   return context
 }
 
-function removeFixture(fixture, options) {
+function removeFixture(fixture) {
   const context = {
     scopes: [],
     assertScopesFinished: function () {},
-Original file line number
+Diff line change
@@ Expand Up / @@ -73,7 +73,6 @@ jobs: @@
           fail-fast: false
           matrix:
             node-version:
-              - 18
               - 20
               - 22
             os:
@@ Expand Down @@