Depura tu código original en lugar de implementarlo con mapas de origen

Meggin Kearney
Meggin Kearney
Sofia Emelianova
Sofia Emelianova

Mantén tu código del cliente legible y depurable incluso después de combinarlo, reducirlo o compilarlo. Usa mapas de origen para asignar tu código fuente al código compilado en el panel Sources.

Comienza a usar los preprocesadores

Los mapas de orígenes de los preprocesadores hacen que DevTools cargue tus archivos originales, además de los reducidos.

Chrome ejecutará tu código reducido, pero el panel Sources te mostrará el código que creaste. Puedes establecer puntos de interrupción y recorrer el código en los archivos fuente, y todos los errores, registros y puntos de interrupción se asignarán automáticamente.

Esto te da la apariencia de depurar el código tal como lo escribiste, a diferencia del código que entrega tu servidor de desarrollo y ejecuta el navegador.

Para usar mapas de origen en el panel Fuentes, sigue estos pasos:

  • Usa solo los preprocesadores que puedan producir mapas de origen.
  • Verifica que tu servidor web pueda entregar mapas de origen.

Usa un preprocesador compatible

Entre los preprocesadores comunes que se usan en combinación con los mapas de origen, se incluyen los siguientes:

Para obtener una lista extendida, consulta Mapas de origen: Idiomas, herramientas y otra información.

Habilita los mapas de fuentes en Configuración

En Configuración. Configuración > Preferencias > Fuentes, asegúrate de marcar Casilla de verificación. Mapas de origen de JavaScript.

Verifica si los mapas de origen se cargaron correctamente

Consulta Recursos para desarrolladores: Cómo ver y cargar mapas de origen de forma manual.

Depuración con mapas de origen

Con los mapas de origen listos y habilitados, puedes hacer lo siguiente:

  1. Abre las fuentes de tu sitio web en el panel Fuentes.
  2. Para enfocarte solo en el código que creaste, agrupa los archivos creados y, luego, implementados en el árbol de archivos. Luego, expande la sección Autor de Autorizado. y abre tu archivo fuente original en el Editor.

    El archivo original se abrió en la sección Autor.

  3. Establece un punto de interrupción como lo harías normalmente. Por ejemplo, un punto de registro. Luego, ejecuta el código.

    Un punto de registro establecido en un archivo creado por el usuario.

  4. Observa que el editor coloca un vínculo al archivo implementado en la barra de estado que se encuentra en la parte inferior. Del mismo modo, lo hace para los archivos CSS implementados.

    Un vínculo a los archivos CSS implementados en la barra de estado.

  5. Abre el panel lateral de Console. En este ejemplo, junto al mensaje del punto de registro, la consola muestra un vínculo al archivo original, no al implementado.

    El mensaje de la consola con un vínculo al archivo original

  6. Cambia el tipo de punto de interrupción a uno normal y vuelve a ejecutar el código. Esta vez, la ejecución se pausa.

    La ejecución se detuvo en un punto de interrupción normal.

    Observa que el panel Pila de llamadas muestra el nombre del archivo original y no el que se implementó.

  7. En la barra de estado en la parte inferior del Editor, haz clic en el vínculo al archivo implementado. El panel Fuentes te dirige al archivo correspondiente.

El archivo implementado con el comentario sourceMappingURL

Cuando abres cualquier archivo implementado, DevTools te notifica si encontró el comentario //# sourceMappingURL y el archivo original asociado.

Observa que el editor imprime de forma correcta el archivo implementado. En realidad, contiene todo el código en una sola línea, excepto el comentario //# sourceMappingURL.

Asigna nombres a las llamadas de eval() con #sourceURL

#sourceURL te permite simplificar la depuración cuando se trata de llamadas a eval(). Este ayudante es muy similar a la propiedad //# sourceMappingURL. Para obtener más información, consulta la especificación de Source Map V3.

El comentario //# sourceURL=/path/to/source.file le indica al navegador que busque el archivo de origen cuando usas eval(). Esto te ayuda a nombrar tus evaluaciones, así como las secuencias de comandos y los estilos intercalados.

Pruébala en esta página de demostración:

  1. Abre las herramientas para desarrolladores y ve al panel Sources.
  2. En la página, ingresa un nombre de archivo arbitrario en el campo de entrada Asigna un nombre a tu código:.
  3. Haz clic en el botón Compilar. Aparecerá una alerta con la suma evaluada de la fuente de CoffeeScript.
  4. En el árbol de archivos del panel Página, abre un archivo nuevo con el nombre de archivo personalizado que ingresaste. Contiene el código JavaScript compilado que tiene el comentario // #sourceURL con el nombre original del archivo fuente.
  5. Para abrir el archivo fuente, haz clic en el vínculo de la barra de estado del Editor.

El comentario sourceURL y el vínculo al archivo fuente en la barra de estado.