Guide
Config
Plugin
API
Tutorials
Community
Guide
Config
Plugin
API
Tutorials
Community

Logs Events

Log events are distributed by Modern.js as events of type log.

Built-in Events

Based on server-side runtime logic, Modern.js provides the following log events:

Stage Message Level
RENDER_HTML App Render To HTML error
RENDER_STREAM An error occurs during streaming SSR error
RENDER_SHELL An error occurs during streaming render shell error

Modern.js also retains SSR logs from legacy versions using useLoader:

Stage Message Level
PRERENDER App Prerender error
USE_LOADER App run useLoader error
TIP

The useLoader API is now deprecated. We recommend migrating to convention-based routing and using Data Loaders for data fetching. Applications already using Data Loaders can enable ssr.disablePrerender to disable prerendering and improve SSR performance.

Built-in Monitor

In Modern.js, log events are handled by LoggerMonitor, which outputs logs to the console.

INFO

The built-in LoggerMonitor depends on the rslog library.

For example, intentionally throwing an error in the project:

routes/page.tsx
import './index.css';

const Index = () => <div className="container-box">{a}</div>;

export default Index;

If running normally, you can see the following output in the console:

> Local:    http://localhost:8080/
> press h + enter to show shortcuts

error   SSR Error - App Prerender, error = ReferenceError: a is not defined
    at Index (/somepath/page.tsx:3:1)