简体中文

server.historyApiFallback

类型： boolean | ConnectHistoryApiFallbackOptions
默认值： false

当 Rsbuild 默认的页面路由行为无法满足你的需求时，例如，希望在访问 / 时可以访问 main.html，可通过 server.historyApiFallback 进行设置。

示例

将 historyApiFallback.index 设置为 main.html，此时在访问 / 或其他原本会 404 的路由时可以访问到 main.html。

export default {
  source: {
    entry: {
      main: './src/index.ts',
    },
  },
  server: {
    htmlFallback: false,
    historyApiFallback: {
      index: '/main.html',
    },
  },
};

当你的应用包含多个 entry 时，你可能希望不同的访问可以 fallback 到不同的页面上。此时，你可以通过 rewrites 选项来设置更复杂的规则：

export default {
  server: {
    historyApiFallback: {
      rewrites: [
        { from: /^\/$/, to: '/views/landing.html' },
        { from: /^\/subpage/, to: '/views/subpage.html' },
        { from: /./, to: '/views/404.html' },
      ],
    },
  },
};

更多选项和详细信息可参考 connect-history-api-fallback 文档。

server.historyApiFallback#

示例#

server.historyApiFallback

示例