#dev.browserLogs

• 类型： boolean
• 默认值： true
• 版本： 新增于 v1.5.13

控制是否将浏览器运行时错误转发到终端。

当设置为 true 时，Rsbuild 的客户端脚本会监听浏览器中的 window.error 事件，以及未捕获的 Promise 拒绝事件，并将这些错误信息发送到开发服务器。开发服务器会在终端中打印这些日志，前缀为 [browser]，同时带有改进的格式和上下文信息。

对于只能读取终端输出的 AI Coding Agents，这一特性有助于它们更好地理解运行时错误并协助排查问题。

#示例

例如，如果你的应用中有以下代码：

const App = () => {
  const item = undefined;
  return <div>{item.name}</div>;
};

浏览器会抛出错误，Rsbuild 会将此错误转发到终端：

error   [browser] Uncaught TypeError: Cannot read properties of undefined (reading 'name')
 at handleClick (src/App.jsx:3:0)

#禁用

将 dev.browserLogs 设置为 false 可以禁用此行为。

export default {
  dev: {
    browserLogs: false,
  },
};

#版本历史