finalhandler

中文文档
2.1.1发布于 2025/12/02MIT近 30 天下载 6.6亿

Node.js的最终http响应器

中文使用文档
文档目录9 节
  1. 安装
  2. API
  3. Finalhandler (req, res, [options])
  4. 例子
  5. 总404
  6. 执行简单的操作
  7. 与中间件风格的函数一起使用
  8. 记录所有的错误
  9. 许可证

finalhandler

NPM Version NPM Downloads Node.js Version Build Status Test Coverage OpenSSF Scorecard Badge

函数调用,作为响应HTTP请求的最后一步。

安装

这是一个 node . js 模块可通过 npm注册表. 安装是使用 npm install 命令:

$ npm install finalhandler

API

const finalhandler = require('finalhandler')

Finalhandler (req, res, [options])

返回要调用的函数,作为给定方法的最后一步 req 和 res。 这个函数将被调用为 fn(err)。如果 err 是false,处理程序会吗 编写一个404响应 res. 如果为真,则会出现错误响应 被写了出来 res 或 res 如果已经收到响应,将终止 开始了。

当写入错误时,会在响应中添加以下信息:

  • 这个 res.statusCode 设置为 err.status (或 err.statusCode). 如果 这个值超出了4xx或5xx的范围,它将被设置为500。
  • 这个 res.statusMessage 根据状态码设置。
  • 正文将是状态码消息的HTML env 是 'production',否则将会 err.stack。
  • 中指定的任何标头 err.headers 对象。

最后的处理程序还将从 req 调用时。

options.env

缺省情况下,环境由 NODE_ENV 变量,但它可以是 被此选项覆盖。

options.onerror

提供要调用的函数 err 当它存在时。可以用于 将错误写入中心位置,而不需要生成过多的函数。叫 作为 onerror(err, req, res)。

例子

总404

const finalhandler = require('finalhandler')
const http = require('http')

const server = http.createServer((req, res) => {
  const done = finalhandler(req, res)
  done()
})

server.listen(3000)

执行简单的操作

const finalhandler = require('finalhandler')
const fs = require('fs')
const http = require('http')

const server = http.createServer((req, res) => {
  const done = finalhandler(req, res)

  fs.readFile('index.html', (err, buf) => {
    if (err) return done(err)
    res.setHeader('Content-Type', 'text/html')
    res.end(buf)
  })
})

server.listen(3000)

与中间件风格的函数一起使用

const finalhandler = require('finalhandler')
const http = require('http')
const serveStatic = require('serve-static')

const serve = serveStatic('public')

const server = http.createServer((req, res) => {
  const done = finalhandler(req, res)
  serve(req, res, done)
})

server.listen(3000)

记录所有的错误

const finalhandler = require('finalhandler')
const fs = require('fs')
const http = require('http')

const server = http.createServer((req, res) => {
  const done = finalhandler(req, res, { onerror: logerror })

  fs.readFile('index.html', (err, buf) => {
    if (err) return done(err)
    res.setHeader('Content-Type', 'text/html')
    res.end(buf)
  })
})

server.listen(3000)

function logerror (err) {
  console.error(err.stack || err.toString())
}

许可证

麻省理工学院

版本与发布记录

finalhandler 共发布 35 个版本,首次发布于 2014/06/06;过去 12 个月发布了 2 个版本。

版本发布日期距今
2.1.1latest2025/12/0211 个月前
1.3.2latest-1.x2025/12/0111 个月前
2.1.02025/03/051.7 年前
1.3.12024/09/122 年前
1.3.02024/09/032 年前
2.0.02024/09/032 年前

关于 finalhandler 的常见问题

finalhandler 是什么?

Node.js的最终http响应器

如何安装 finalhandler?

在项目目录运行 npm install finalhandler,或使用 pnpm add / yarn add / bun add。

finalhandler 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/finalhandler 是否存在。

finalhandler 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

finalhandler 可以商用吗?

finalhandler 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

finalhandler 的下载量有多少?

根据 npm 官方下载统计,finalhandler 在 2026/10/06 – 2026/11/04 这 30 天内被下载 655,434,460 次,日均约 21,847,815 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

finalhandler 还在维护吗?

最新版本 2.1.1 发布于 2025/12/02(11 个月前);至今共发布 35 个版本,其中过去 12 个月发布了 2 个;首次发布于 2014/06/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。