Skip to main content

Debug

Metodi e proprietà per debugging e telemetria.

Method / PropertyTierSince
setDebug(enabled)11.0
version (property)11.0

💡 Per logging strutturato e persistente come scelta architetturale, usa il config field loggers: ['console'] o loggers: [] (vuoto = silent).


setDebug

Attiva o disattiva il console-logger del core. Il flag è persistito in localStorage (chiave avacy:debug) così sopravvive ai reload di pagina — utile per QA su un sito live senza modificare la config inline.

window.Avacy.setDebug(enabled: boolean): void

Parameters

NameTypeDescription
enabledbooleantrue forza loggers: ['console'] al prossimo boot; false forza loggers: []. Idempotente.

Example

// in console del browser, durante un'investigazione bug:
window.Avacy.setDebug(true);
// → ricarica la pagina (o chiama Avacy.reload()):
location.reload();
// ora vedi log strutturati di TCF, framework init, store read/write, etc.

// quando hai finito:
window.Avacy.setDebug(false);
location.reload();

When to use it

  • Riproduzione bug client in produzione, su un browser specifico, senza deploy
  • Investigazione integrator-side senza modificare la config inline
  • Smoke test E2E con log verbose temporaneo

Timing

Il flag prende effetto al prossimo init() o reload(), non a runtime. MainLoggerProvider viene istanziato durante Core.init e i subloggers attivi sono fissi nel ciclo di vita di quel context. Per applicare immediatamente:

window.Avacy.setDebug(true);
await window.Avacy.reload(); // re-bootstrap con loggers aggiornati

Storage

Il flag è salvato in window.localStorage.setItem('avacy:debug', 'true'). Se localStorage non è disponibile (modalità privata, WebView restrittive) la chiamata è silenziosa: il fallback è passare loggers: ['console'] esplicitamente nel config inline.

See also

  • Config field loggers: LoggerType[] in UserConfigType — controllo dichiarativo permanente
  • reload() — per applicare il flag immediatamente