NNext.js 中文网 GitHub

路由信息

onBuildComplete 中暴露的路由阶段和路由字段参考。

onBuildComplete 中的 routing 对象提供完整的路由信息,其中的模式已经过处理,可直接用于部署:

routing.beforeMiddleware#

在 middleware 执行之前应用的路由。包括生成的 header 和重定向行为。

routing.middlewareMatchers#

此次构建生成的 middleware matcher 定义。可用它们决定是否为给定请求调用 middleware。

routing.beforeFiles#

在文件系统路由匹配之前检查的重写路由。

routing.afterFiles#

在文件系统路由匹配之后检查的重写路由。

routing.dynamicRoutes#

从路由段(如 [slug])和捕获所有路由生成的动态 matcher。

routing.onMatch#

在成功匹配后应用的路由,例如针对带哈希静态资源的不可变缓存 header。

routing.fallback#

当较早阶段未产生匹配时检查的最后一批重写路由。

通用路由字段#

每个路由条目可包含:

  • source:原始路由模式(对于生成的内部规则为可选)
  • sourceRegex:用于匹配请求的编译后正则
  • destination:内部目标或重定向目标
  • headers:要应用的 header
  • has:正向匹配条件
  • missing:反向匹配条件
  • status:重定向状态码
  • priority:内部路由优先级标志
Next.js 中文网