L'apostrofo affogato: 4h23' per quattro caratteri
Quattro ore e ventitré minuti. Quattro skill scomodate. Venti task creati e per lo più cancellati. La causa, alla fine: un apostrofo non escappato dentro un titolo di pagina, che annegava una stringa JS nel bundle compilato.
Quattro ore e ventitré minuti. Quattro skill scomodate. Venti task creati, lanciati, rimangiati. La causa, alla fine, era un apostrofo. Uno solo. Annegato dentro un titolo di pagina, dove nessuno l'aveva pensato e nessuno l'aveva escappato.
## Il sintomo
Apro la pagina. Si carica. Si vede. Funziona. Ricarico. Si vede. Funziona. Apro la console del browser: warning rosso. Unterminated string literal. Scorro le righe: niente di mio. Tutto generato. Tutto compilato.
Allora dev tools, network tab, payload della risposta. Il titolo della pagina conteneva una parolaccia tipografica con la sua brava virgoletta curva, e poi un sostantivo possessivo con il suo bell'apostrofo dritto. Il primo era stato gestito. Il secondo no. Il bundle, in qualche punto, aveva concatenato quel titolo dentro una stringa JS senza escape. La stringa moriva all'apostrofo. Tutto quello che veniva dopo era spazzatura sintattica che il browser provava a digerire come poteva.
Solo che il browser non si lamentava ad alta voce: il rendering funzionava lo stesso, perché la spazzatura cadeva in un blocco di codice non eseguito subito. L'errore si scatenava solo dieci secondi dopo, quando il pezzo di codice rotto veniva chiamato per la prima volta — di solito da un evento utente. E si scatenava in un punto del codice completamente diverso da dove l'apostrofo aveva fatto disastro.
Il sintomo era nell'evento. La causa era nel build. Tra i due, mille righe di chunk minificato.
## La caccia
Skill numero uno: diagnostics. LSP, tsc, lint. Tutto verde. Niente errori statici. L'apostrofo non era nel sorgente mio, era nei dati che il sorgente caricava.
Skill numero due: e2e testing. Ho fatto correre Playwright sulla pagina. Tre run, tre risultati diversi. Una volta passa, una volta fallisce su un selettore, una volta fallisce su un altro. Flakiness perfetta. Il bug non aveva il decoro di essere riproducibile.
Skill numero tre: code review. Ho consultato l'architect su due ipotesi diverse, una sul componente di rendering e una sul fetch dei dati. Entrambe sensate, entrambe sbagliate. Il code review ha confermato che il codice "si comportava correttamente". Aveva ragione. Nessuno aveva sbagliato. Era il dato a essere ostile.
Skill numero quarta: database. Ho ispezionato il DB convinto che ci fosse una corruption nel record. Niente. Il record era integro. L'apostrofo era proprio l'apostrofo che doveva esserci nel titolo. Era la strada che faceva tra DB e browser ad averlo lasciato passare senza casco.
## Venti task
In mezzo, una pioggia di task. Aggiungi try/catch al fetch. Ricontrolla la sanitizzazione dell'input. Riconsidera la libreria di rendering. Riscrivi il componente. Sostituisci il bundler. Aggiorna React. Rimuovi quel parser custom. Riaggiungilo. Bypass il cache. Forza il reload. Aggiungi un sentry middleware. Venti, contati a fine giornata. Ogni task era una scommessa diversa su dove poteva essere il colpevole. Ogni scommessa era una mezz'oretta di lavoro, un test, un risultato deludente, un task cancellato.
A un certo punto, verso le tre ore, ho preso un caffè e ho aperto il file di build minificato a mano. Ctrl-F. Cerca: apice singolo seguito da spazio seguito da una "s". Tre risultati. Due erano stringhe legittime. Il terzo era una stringa che — visivamente — finiva nel mezzo di una frase. Lì.
## La fix
Una riga. Una funzione che riceveva il titolo da una factory di metadata della pagina e lo iniettava in uno script inline come stringa singolo-quotata, senza passarlo per JSON.stringify. Quattro caratteri di codice cambiati: stringa singola diventata template literal, valore avvolto in JSON.stringify(...). Build. Test. Verde. Verde. Verde.
## Il conto
- 4 ore e 23 minuti di tempo umano. - 4 skill agente invocate. - 20 task creati e per la maggior parte cancellati. - 4 caratteri di codice cambiati alla fine.
Il rapporto tra causa e fatica è uno dei più squilibrati che ricordi. Ma non è il rapporto vero. Il rapporto vero è tra l'apostrofo e tutto quello che separa l'apostrofo dal browser: layer di build, layer di template, layer di idratazione, layer di metadata, layer di caching. Ogni layer dà per scontato che quello sotto abbia fatto il suo dovere. Quando uno solo di loro non fa l'escape giusto, il problema viaggia in incognito fino al confine, e poi esplode in mano a un altro.
## Cosa mi resta
Due cose, e me le scrivo qui in modo che il prossimo me le rilegga.
1. Per i titoli di pagina e qualunque stringa che entri in uno script inline, sempre JSON.stringify. Non solo per i caratteri "speciali", per tutto. È l'unica funzione che conosce davvero la grammatica delle stringhe JS. 2. Quando il sintomo è in un punto e la causa non si trova lì intorno, abbandona l'area del sintomo. Vai a monte. Lontano. Il codice che scrivi tu raramente ha bug; il codice che orchestra il tuo codice molto più spesso.
L'apostrofo sta ancora là, nel titolo della pagina, dritto e felice. Si chiama come si chiamava. Adesso, finalmente, è solo un apostrofo.