
Abres la consola, y antes de que nada de lo tuyo se ejecute hay cuatro líneas rojas sobre source maps que no se pudieron cargar. El instinto es ir a revisar tu configuración de compilación, porque las palabras nombran algo que tu compilación produce.
Ese es generalmente el lugar equivocado, y la razón vale la pena saber, porque tarda unos diez segundos en determinar de quién es el problema y la mayoría de la gente nunca aprende el truco.
Qué se está pidiendo realmente
Un archivo minificado puede llevar un puntero a un mapa que lo traduce de vuelta al código fuente a partir del cual se compiló. Hay dos formas de adjuntar uno.
La forma común es un comentario al final del archivo, //# sourceMappingURL=bundle.js.map. La
otra es un encabezado HTTP, y MDN es específica sobre cuál prevalece: el encabezado SourceMap
“tiene precedencia sobre una anotación de fuente (sourceMappingURL=path-to-map-js.map), y si
ambas están presentes, se usa la URL del encabezado para resolver el archivo de source map.”
También existe un encabezado X-SourceMap más antiguo, que está deprecado.
Para qué sirve el mapa es igualmente específico. En palabras de MDN, “Las herramientas de desarrollador utilizan el source map para reconstruir el código fuente original a partir del JavaScript optimizado devuelto en la respuesta, permitiendo que los desarrolladores depuren el código original en lugar del formato que ha sido optimizado para envío.”
Quién hace la solicitud, que es el primer hecho útil
La propia documentación de Chrome responde esto en una oración: “Cuando abres DevTools, intenta cargar source maps, si los hay.”
Entonces la solicitud la hace tu herramienta de desarrollador, en tu máquina, porque la abriste. Un visitante con la consola cerrada no descarga estos archivos y no ve estas líneas. Sea lo que sea que esto te esté costando, no les está costando a ellos.
Eso solo descarta la mayoría del pánico. Una página no está rota por esto, nada es más lento para nadie, y ningún comportamiento visible para el usuario depende de ello.
Por qué generalmente no es el tuyo
Aquí está la parte que salva la tarde.
El puntero vive dentro del archivo que se envió. Si ese archivo salió de tu propia compilación,
el puntero es tuyo y también es el mapa que falta. Pero una gran parte de estas líneas provienen
de código que no escribiste: un paquete que fue publicado en npm con el comentario
sourceMappingURL dejado dentro y el archivo .map dejado fuera, porque el publicador lo excluyó
del paquete para mantener la descarga pequeña.
Tu empaquetador copió ese comentario fielmente, porque es un comentario en un archivo que le pediste que incluyera. No hay nada en tu configuración que lo produjo y nada allí que pueda arreglarlo.
Así que lee la URL en el error antes de cambiar nada. Si la ruta apunta a tu propio resultado
de compilación, es tuyo. Si apunta dentro de un fragmento de proveedor, una ruta node_modules, o
una CDN que no controlas, es una decisión de empaquetamiento de alguien más y tus opciones son
ignorarla o dejar de cargarla.
Las tres cosas que realmente la causan
El mapa nunca fue publicado. El caso más común, y el de arriba. Nada que arreglar.
El mapa existe pero la solicitud no pasa. Chrome señala que las solicitudes de source map “pueden tratarse como cross-origin y es posible que no lleguen a pasar”, que es el caso que vale la pena conocer porque se ve idéntica en la consola y no es un archivo faltante en absoluto. Un mapa en un origen diferente sin encabezados permisivos falla de la misma manera que uno que nunca se cargó.
El mapa fue deliberadamente no desplegado. Muchos equipos generan mapas y los mantienen fuera del directorio público a propósito, para que el código fuente original no sea descargable por nadie que abra las herramientas de desarrollador. Esa es una elección defensible, y la línea en la consola es su costo.
Deja de adivinar y lee la lista
Chrome tiene un panel que responde esto por archivo en lugar de dejar que hagas coincidir las líneas de la consola con los paquetes. Developer Resources muestra una columna de Status, para ver si la carga fue exitosa o falló, y una columna de Error con el mensaje para cada uno. También te permite cargar un mapa manualmente, que es cómo verificas que un mapa que mantuviste privado es por lo demás correcto.
Esa lista es la diferencia entre “la consola está llena de errores de source map” y “tres de estos son de una dependencia y uno de ellos es nuestro”.
Qué hacer, en orden
Si pertenece a una dependencia: nada. Es ruido generado por tu propia herramienta sobre el empaquetamiento de alguien más. Ningún usuario se ve afectado y ningún cambio de compilación lo eliminará.
Si es tuyo y quieres mapas que funcionen, envía el archivo .map junto con el paquete, o
mantenlo privado y cárgalo en tu rastreador de errores, que es donde genera más valor y expone
menos. Un stack trace contra código minificado
es prácticamente inútil, y este es el archivo que lo arregla.
Si solo quieres que la consola esté callada, la configuración está en DevTools en lugar de en tu proyecto: Settings, luego Preferences, luego Sources, donde la documentación de Chrome te apunta a la casilla de verificación JavaScript source maps. Desactivarla detiene las solicitudes y las líneas con ellas.
El costo que nadie cuenta
Una consola con una docena de advertencias permanentes no es gratis, y el precio no es el desempeño.
Es que todos aprenden a escanear rápidamente. Cuando la consola siempre tiene rojo en ella, el rojo deja de ser una señal, y la línea que importa llega en medio de once que no. El error sobre una propiedad indefinida que explica el checkout roto está sentado cuatro líneas debajo de una advertencia de source map que ha estado allí desde marzo.
Esto importa más cuando alguien más es quien está mirando. Una captura de pantalla de una consola de un usuario, o un registro capturado adjunto a un informe de bug, llega con todo esto en él, y la persona que lo lee tiene que saber qué líneas son mobiliario permanente antes de poder ver cuál es la nueva.
Session Replay
Extensión gratuita para Chrome. Un clic en la página que está fallando captura la captura de pantalla, la consola y el registro de red, y te entrega un enlace para pegar en el ticket.
Saber qué líneas de las que había siempre iban a estar allí es la mayoría de lo que hace que una consola capturada sea legible.
La versión corta
- La solicitud la hace tu herramienta de desarrollador cuando la abres, no la página. Ningún visitante ve esto y nada es más lento para ellos.
- Lee primero la URL en el mensaje. Una ruta
node_moduleso de proveedor significa que es el empaquetamiento de una dependencia, y no hay nada en tu compilación que cambiar. - Un mapa cross-origin falla de una manera que se ve exactamente como uno que falta.
- Developer Resources enumera el estado y el error por archivo, que supera leer líneas de consola.
- La casilla de verificación que lo silencia es una preferencia de DevTools, no una configuración de proyecto.
- El costo real es una consola que nadie lee cuidadosamente, incluyendo la persona a la que se la enviaste.