#dev.browserLogs

• Type: boolean
• Default: true

Controls whether to forward browser runtime errors to the terminal.

When set to true, Rsbuild's client script listens for window.error events and unhandled Promise rejections in the browser, then sends these errors to the dev server. The server prints them in the terminal with a [browser] prefix, along with improved formatting and contextual information.

This feature is particularly useful when working with AI coding agents that can only read terminal output, helping them better understand runtime errors and assist in debugging.

#Example

For example, if you have the following code in your application:

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

The browser will throw an error, and Rsbuild will forward this error to the terminal:

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

#Disabling

Set dev.browserLogs to false to disable this behavior.

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

#Version history