Debug
Metodi e proprietà per debugging e telemetria.
| Method / Property | Tier | Since |
|---|---|---|
setDebug(enabled) | 1 | 1.0 |
version (property) | 1 | 1.0 |
💡 Per logging strutturato e persistente come scelta architetturale, usa il config field
loggers: ['console']ologgers: [](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
| Name | Type | Description |
|---|---|---|
enabled | boolean | true 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[]inUserConfigType— controllo dichiarativo permanente reload()— per applicare il flag immediatamente