Vai al contenuto

Risolutore di source map

Source Map Resolver

Riporta una traccia di stack minificata ai file e alle righe originali usando una source map che fornisci tu.

Prende uno stack trace di un bundle minificato e un file `.map`, e dice da quale riga di quale sorgente originale viene ogni frame. Tutto viene decodificato nella scheda: né la mappa né lo stack trace, che spesso nomina i propri percorsi interni, vanno da nessuna parte.

🔒 Funziona interamente nel tuo browsersourcemapdebugstacktracejavascript

Source map (.map)

Trascina qui un file .map

Letto in questa scheda. Non viene caricato nulla.

Stack trace minificato

Source Map v3, decodificato in questa scheda: mapping base64-VLQ, ricerca della colonna più grande che precede come nei devtools, e nomi originali ripristinati dalla tabella names. Il testo sorgente originale compare solo se la map incorpora sourcesContent — una map senza quello conosce le posizioni, non il codice. Le righe di frame che non si riescono a leggere passano invariate.

Come si usa

  1. Procurarsi la mappa

    O il file `.map` stesso, oppure l’URI `data:` preso da un commento `sourceMappingURL` in fondo al bundle. Si incollano qui tutti e due.

  2. Incollare lo stack trace

    Preso di peso da una segnalazione d’errore — tutto quanto, riga `Error:` compresa. I frame che non si riescono ad analizzare passano invariati invece di sparire.

  3. Leggere le posizioni originali

    Ogni frame riceve il suo file sorgente, la riga, la colonna e — dove la tabella `names` della mappa ce l’ha — il nome originale della funzione. Un pulsante copia l’intero stack trace rimappato.

Domande frequenti

Perché non viene mostrata nessuna riga di sorgente?

Perché la mappa non incorpora `sourcesContent`. Una mappa che ne è priva sa dove stavano le cose, non che cosa vi era scritto — l’indicatore sotto la mappa dice se la propria ce l’ha. Se serve il codice, va compilato con `sourcemap: true` invece che con un’impostazione a soli percorsi.

Un frame dice «nessuna mappatura in questa posizione».

La colonna di quel frame cade fuori da ogni segmento di mappatura. Di solito vuol dire che la mappa è di una build del file diversa da quella che ha sollevato l’errore: un rilascio che ha spedito codice nuovo con una mappa vecchia, oppure una CDN che serve un bundle in cache.

È sicuro incollare qui una source map di produzione?

Non esce niente dalla scheda: la decodifica VLQ e la ricerca avvengono nel browser. Vale la pena ricordare che una mappa con `sourcesContent` contiene tutto il proprio sorgente originale, quindi dove la si incolla conta in generale, anche se qui non conta.

Quale versione di source map legge?

La v3, l’unica che qualcuno produca. Le index map — la forma con `sections` usata per i bundle molto grandi — non sono supportate; va data invece la mappa di sezione che copre il proprio frame.

Può ricevere da

Dopo

Questi accettano ciò che produce questo strumento, così il risultato può passare direttamente.