logger

The _satellite.logger object contains methods that allow you to output diagnostic or informational messages to the browser console when Debugging is enabled. If debugging is not enabled, all logger method calls do nothing.

These methods allow developers, technical marketers, and testers to easily see what triggers within a tag property and when. Since these console messages only appear when debugging is enabled, you can leave logger messages in deployments to production without impacting the browser console of visitors to your site.

readonly _satellite.logger: {
  debug(...args: unknown[]): void;
  log(...args: unknown[]): void;
  info(...args: unknown[]): void;
  warn(...args: unknown[]): void;
  error(...args: unknown[]): void;
}

Methods

All _satellite.logger methods pass through to their corresponding JavaScript console.* method when debugging is enabled. Most console arguments or objects are supported using _satellite.logger:

// First enable debugging mode
_satellite.setDebug(true);

// Logs a debug message
_satellite.logger.debug('Verbose diagnostic event');

// Logs a generic message
_satellite.logger.log('Example');

// Logs an informational message with mixed arguments
_satellite.logger.info('Rule triggered', 42, { ruleId: 'R123' }, ['a', 'b']);

// Logs a warning message
_satellite.logger.warn('Data element does not contain a value');

// Logs an error message with stack
_satellite.logger.error(new Error('Required extension not found'));

Console output

The library prepends the following in all console output messages: