Saltar al contenido

Resolver un stack trace con su source map

Source Map Resolver

Devuelve una traza de pila minificada a sus archivos y líneas originales usando el source map que le entregues.

Toma un stack trace de un bundle minificado y un archivo `.map`, y te dice de qué línea de qué código fuente original vino cada frame. Todo se decodifica en la pestaña: ni el mapa ni la traza, que a menudo nombra tus rutas internas, van a ningún sitio.

🔒 Se ejecuta por completo en tu navegadorsourcemapdebugstacktracejavascript

Source map (.map)

Suelta un archivo .map

Se lee en esta pestaña. No se sube nada.

Traza minificada

Source Map v3, decodificado en esta pestaña: asignaciones base64-VLQ, la búsqueda por mayor columna anterior al estilo de las devtools, y los nombres originales restaurados desde la tabla names. El código fuente original aparece solo cuando el mapa incrusta sourcesContent — un mapa sin eso sabe posiciones, no código. Las líneas de marco que no se pueden leer pasan sin cambios.

Cómo se usa

  1. Consigue el mapa

    O el archivo `.map` en sí, o el URI `data:` de un comentario `sourceMappingURL` al final del bundle. Los dos se pegan aquí.

  2. Pega el stack trace

    Directamente de un informe de error: todo entero, línea `Error:` incluida. Los frames que no se analizan pasan sin cambios en lugar de desaparecer.

  3. Lee las posiciones originales

    Cada frame recibe su archivo fuente, línea, columna y —donde la tabla `names` del mapa lo tiene— el nombre original de la función. Copia la traza remapeada entera con un botón.

Preguntas frecuentes

¿Por qué no se muestra ninguna línea de código?

Porque el mapa no incrusta `sourcesContent`. Un mapa sin él sabe dónde estaban las cosas, no qué había escrito ahí; la estadística bajo el mapa dice si el tuyo lo tiene. Compila con `sourcemap: true` en lugar de un ajuste de solo rutas si quieres el código.

Un frame dice «sin mapeo en esta posición».

La columna de ese frame cae fuera de cualquier segmento de mapeo. Normalmente significa que el mapa es de un build distinto del archivo que lanzó el error: un despliegue que publicó código nuevo con un mapa viejo, o una CDN sirviendo un bundle cacheado.

¿Es seguro pegar aquí un source map de producción?

Nada sale de la pestaña: la decodificación VLQ y la búsqueda se hacen en tu navegador. Conviene recordar que un mapa con `sourcesContent` contiene todo tu código fuente original, así que dónde lo pegas importa en general, aunque aquí no.

¿Qué versión de source map lee?

v3, la única que emite nadie. Los mapas índice —la forma con `sections` usada para bundles muy grandes— no se admiten; dale el mapa de la sección que cubre tu frame en su lugar.

Puede recibir de

Después

Estas aceptan lo que produce esta herramienta, así que el resultado puede pasar directamente.