nuxt logo

文档翻译(非官方)

Nuxt.js
Version:v3.17

服务器引擎

Nuxt 由一个新的服务器引擎驱动:Nitro。

在构建 Nuxt 的过程中,我们创建了一个新的服务器引擎:Nitro

它具有许多功能:

  • 对 Node.js、浏览器、服务工作者等的跨平台支持。
  • 开箱即用的无服务器支持。
  • API 路由支持。
  • 自动代码拆分和异步加载的代码块。
  • 静态 + 无服务器站点的混合模式。
  • 具有热模块重载的开发服务器。

API 层

服务器 API 端点中间件 由 Nitro 添加,内部使用 h3

主要功能包括:

  • 处理程序可以直接返回对象/数组,以自动处理 JSON 响应
  • 处理程序可以返回 promises,这些 promises 将被等待(也支持 res.end()next()
  • 用于解析请求体、处理 cookie、重定向、设置头信息等的辅助函数

查看 h3 文档 以获取更多信息。

另请参阅 guide > directory-structure > server#server-routes

直接 API 调用

Nitro 允许通过全局可用的 $fetch 辅助函数“直接”调用路由。如果在浏览器上运行,这将向服务器发出 API 调用,但如果在服务器上运行,则会直接调用相关函数,节省额外的 API 调用

$fetch API 使用 ofetch,其主要功能包括:

  • 自动解析 JSON 响应(如果需要,可以访问原始响应)
  • 请求体和参数会被自动处理,并具有正确的 Content-Type 头信息

有关 $fetch 功能的更多信息,请查看 ofetch

类型化的 API 路由

使用 API 路由(或中间件)时,只要返回一个值而不是使用 res.end() 发送响应,Nitro 就会为这些路由生成类型。

在使用 $fetch()useFetch() 时可以访问这些类型。

独立服务器

Nitro 生成一个独立的服务器分发包,与 node_modules 无关。

Nuxt 2 中的服务器不是独立的,需要通过运行 nuxt start(使用 nuxt-startnuxt 分发包)或自定义编程使用来涉及 Nuxt 核心的一部分,这种方式不稳定,容易出错,不适合无服务器和服务工作者环境。

Nuxt 在运行 nuxt build 时生成此分发包到 .output 目录中。

输出包含在任何环境中运行 Nuxt 服务器的运行时代码(包括实验性的浏览器服务工作者!)并提供静态文件服务,使其成为 JAMstack 的真正混合框架。此外,Nuxt 实现了一个本地存储层,支持多源驱动和本地资产。

另请参阅 github.com > nitrojs > nitro