如何在Node.js Express中绕过HTTP协议栈程序化调用内部端点？

假设我们有如下Express示例应用：

const express = require('express')
const app = express()

app.get('/', (req, res) => {
  res.send('Hello World!')
})

// 已移除 app.listen(3000)

现在需要在同一应用代码的其他位置，程序化调用'/'端点，请问惯用方式是什么？

需求背景 #

我基于express-pouchdb定义了大量路由，希望为其他有线协议编写适配器，无需通过网络，直接从JS代码调用这些路由。由于路由数量多达数十个，逐个改为直接函数调用并不现实。

已尝试方案 #

我试过调用app.route.dispatch()，但返回的响应对象没有任何内容。

解决方案 #

方法1：使用supertest库（推荐） #

supertest是处理这类场景的惯用工具，它可以直接对接Express应用实例，无需启动HTTP服务器就能发起模拟请求，完美适配多路由批量调用的需求。

先安装依赖：

npm install supertest --save-dev

调用示例：

const request = require('supertest');
const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello World!');
});

// 回调式调用
request(app)
  .get('/')
  .end((err, res) => {
    if (err) throw err;
    console.log(res.text); // 输出: Hello World!
  });

// 更简洁的 async/await 写法
async function callRootRoute() {
  const res = await request(app).get('/');
  console.log(res.text);
}
callRootRoute();

如果是挂载了express-pouchdb的应用，只需把上述代码里的app换成你的实际应用实例，所有已定义的路由都能通过这种方式触发。

方法2：手动模拟请求与响应对象（无额外依赖） #

如果不想引入第三方库，可以手动模拟Express的req和res对象，直接调用应用的核心处理逻辑：

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello World!');
});

// 模拟请求对象，按需补充属性（比如query、params、body等）
const mockReq = {
  method: 'GET',
  url: '/',
  headers: {},
};

// 模拟响应对象，实现路由用到的响应方法
const mockRes = {
  send: function(body) {
    console.log('响应内容:', body); // 输出: 响应内容: Hello World!
    // 可以在这里把响应内容存入变量，供后续业务逻辑使用
  },
  // 如果路由用到了json、status等方法，需要补充对应的模拟实现
};

// 调用Express应用的核心处理函数
app.handle(mockReq, mockRes);

关于app.route.dispatch()失败的原因 #

单独调用app.route('/').dispatch()无法正常工作，因为Express的路由处理依赖完整的请求响应生命周期，需要传入合法的req和res对象上下文才能触发后续逻辑。

内容的提问来源于stack exchange，提问作者Alex R