Logging - Node.js SDK

Set or Change the Realm Log Level

You can set the level of detail reported by the Realm Node.js SDK. To configure the log level, pass Realm.setLogLevel() to a valid level string value:

• "all"

• "trace"

• "debug"

• "detail"

• "info"

• "warn"

• "error"

• "fatal"

• "off"

Realm.setLogLevel("all");

You can set different log levels to increase or decrease verbosity at different points in your code. This behavior differs from the deprecated sync client log level, which had to be set before opening a synced realm and could not be changed.

// Set a default log level that's not too verbose
Realm.setLogLevel("detail");
const realm = await Realm.open({
  schema: [Turtle],
});
// Later, change the log level to debug an issue when running specific code
Realm.setLogLevel("trace");
realm.write(() => realm.create(Turtle, newTestObject()));

Customize the Logger

To set a custom logger, call setLogger(). This method recieves level and message arguments from the Realm logger. You can use these arguments to define your own logging behavior.

let logs = [];
Realm.setLogger((level, message) => {
  logs.push({ level, message });
});

type Log = {
  message: string;
  level: string;
};
let logs: Log[] = [];
Realm.setLogger((level, message) => {
  logs.push({ level, message });
});

This sets the logging behavior for all Realm logging in your application. If you do not provide a log level, the default value is "info".

Turn Off Logging

You can turn off logging by setting the log level to RealmLogLevel.off:

Realm.setLogLevel("off");

Performance and console.log()

You should avoid using console.log() in production because it will negatively affect your app's performance. It can also be hard to account for all of the method's quirks in Node.js.

For details about console.log() behavior, check out the Node.js docs.