Minilección · Español

Cómo encontrar y corregir errores en tu sitio publicado

Reproduce la acción defectuosa del visitante, pide una corrección concreta y verifica la misma acción después.

Comenzar la lección interactivaLeer los apuntes

¿Para quién es esta lección?

Para quienes quieren localizar y corregir fallos de visitantes. Usarás una página rota proporcionada; el asistente puede editar mientras describes el problema y repites la acción.

Antes de empezar

El sitio independiente y un asistente. Sentry de práctica es opcional para monitorización; envía solo errores ficticios incluidos, no datos privados.

Tiempo estimado: 19–31 min

Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. La configuración del proveedor de monitorización y las esperas de recepción son adicionales. Una llamada local de captura no demuestra que se haya recibido una alerta.

Qué aprenderás

  • Reproduce una acción rota real, no solo la carga.
  • Comparte contexto seguro suficiente para una corrección concreta.
  • Verifica acción corregida y estado pertinente de monitorización.

Archivos del taller

Paso 1

Prueba la acción del visitante

La página puede abrir aunque su función útil esté rota.

Pide al asistente que sirva la carpeta public proporcionada por HTTP y abre la página. Activa «Find contact section». La versión practice-R1 busca deliberadamente un destino que no existe, por lo que el estado informa que falló la acción Contact.

Indica al asistente el botón exacto, la sección que esperabas alcanzar y el resultado visible. La sección Contact puede existir en la página aunque el botón no consiga llegar a ella; comprobar únicamente que se carga la portada no detectaría este problema.

Un ejemplo concreto

Síntoma útil: «Pulsé Find contact section en practice-R1. Esperaba abrir Contact, pero decía Contact action failed».

Usa el contacto roto en un sitio de práctica aparte. Reproduce el fallo, identifica una causa concreta y cambia solo lo necesario. Ayuda a repetir y comparar. Si hay monitorización, usa solo errores ficticios y mi proyecto; no envíes datos privados de página/formulario. No llames arreglado un problema solo por marcarlo resuelto.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Encuentra y corrige un error del sitio publicado

Empieza por una acción fallida del visitante y utiliza el informe para localizar su causa.

La monitorización es útil cuando conecta un síntoma real con código que puedes investigar. Esta página busca deliberadamente un elemento de contacto inexistente, de modo que falla la acción de contacto.

Enviamos solo un error sintético fijo a tu proyecto Sentry. El informe incluye una etiqueta de versión y una ubicación en la pila; el registro de incidente relaciona esas pruebas con lo que intentó hacer el visitante.

Ejemplo resuelto

La página principal carga correctamente. Pulsar “Find contact section” (encontrar la sección de contacto) falla porque el script busca #contact-missing, mientras el HTML real tiene id=contact.

Extra implementation exercise

¿Por qué una comprobación HTTP 200 de la página principal no detecta este fallo?

Mostrar una solución desarrollada

El HTML puede cargar correctamente mientras una acción JavaScript posterior falla. Repite la tarea de contacto, no solo la solicitud de página.

  • Prueba la interacción afectada después de cargar la página.
  • Distingue disponibilidad de funcionamiento correcto.

Paso 2

Recoge solo contexto seguro útil

Da evidencia al asistente sin datos privados.

Entrega al asistente los archivos de práctica, la versión de página y el síntoma del paso anterior. Basta para comenzar a revisar este ejemplo local sin enviar texto de formularios ni información de cuentas de ningún visitante real.

Si usas Sentry opcional, configura solo su valor público de cargador y activa monitoreo antes de reproducir el error controlado. Revisa evento y datos. Que aparezca en Sentry no equivale a una alerta entregada al buzón.

Un ejemplo concreto

El error permitido es «Practice: missing contact target». Puede incluir versión y origen sin mensaje real, correo ni token.

Sentry: cargador de navegador e inicialización personalizada

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Envía un informe de diagnóstico controlado

Recoge lo necesario para investigar sin enviar contenido de usuario sin procesar.

Configura la URL pública del cargador del proyecto según START-HERE.txt. El script establece su callback de inicialización antes de cargar el SDK, desactiva trazas y reproducción y usa una lista permitida beforeSend para este error fijo de práctica.

El evento de diagnóstico devuelto excluye los datos de la solicitud, los del usuario, los extras arbitrarios y el historial de acciones previas al error (breadcrumbs). Se eliminan la consulta y el fragmento de los nombres de archivo de la pila. En un sitio real, revisa cada fuente de diagnóstico sensible; sendDefaultPii=false por sí solo no garantiza que el texto libre o las URL no contengan información personal.

El filtro beforeSend es deliberadamente estricto: solo envía el mensaje sintético exacto 'Practice: missing contact target'. Descarta los demás. Si cambias el texto del error, actualiza la lista de forma deliberada o la ausencia de evento es lo esperado. No quites el filtro solo para llenar el panel; examina el evento permitido en busca de datos no deseados.

Si no llega un evento, examina primero el mensaje fijo y la lista beforeSend de app.js. Un evento que no coincide muestra ahora un mensaje local de evento filtrado; no se cuenta como enviado. El analizador de URL usa location.origin como base de nombres relativos y sustituye un nombre que no pueda analizar por redacted, en vez de reenviar un original potencialmente sensible.

La opción documentada data-lazy="no" del cargador se establece con script.dataset.lazy="no"; solicita cargar pronto el SDK completo. Los nombres de archivo de pila conservan solo origen y ruta HTTP(S) tras eliminar consulta y fragmento. Los esquemas no web se ocultan en vez de reenviarse intactos.

Ejemplo resuelto

Un mensaje fijo como “Practice: missing contact target” basta para este ejercicio. Enviar un objeto de formulario completo añadiría riesgo sin ayudar a identificar el destino DOM ausente.

Sentry: cargador de navegador e inicialización personalizada

Extra implementation exercise

¿Desactivar la información personal predeterminada haría automáticamente seguro enviar mensajes de error arbitrarios?

Mostrar una solución desarrollada

No. Revisa los datos reales del evento y restringe lo que envía tu código. Puede aparecer información personal en mensajes, URL, breadcrumbs y extras aunque no se recojan datos personales predeterminados.

  • Reconoce que los textos y URL de la aplicación aún pueden contener datos privados.
  • Aplica ocultación explícita y listas permitidas.

Paso 3

Aplica una corrección concreta

Repite exactamente la acción fallida tras cambiar.

Pide al asistente que compare el destino del botón que falla con la sección Contact existente. worked-solution/app.js contiene la pequeña corrección; que la aplique e identifique la revisión de práctica corregida como practice-R2.

Abre la página practice-R2 actualizada y activa otra vez el mismo botón. Debe llegar a Contact y mostrar «Contact section opened.» Cambiar solo la etiqueta de versión o marcar el problema resuelto en Sentry no modifica el comportamiento del botón.

Un ejemplo concreto

El script busca #contact-missing, pero HTML define #contact. El asistente repara la coincidencia; tú juzgas repitiendo el botón.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Relaciona el informe, repara la causa y vuelve a probar

Una etiqueta de incidencia resuelta no repara el código.

Activa la monitorización, provoca el fallo sintético y localiza el evento real en tu cuenta. Compara su versión y ubicación con el código proporcionado. Si no llega, examina carga, bloqueadores, configuración del proyecto y entrega de red antes de suponer que no hubo error.

Sustituye el script por worked-solution/app.js, actualiza la etiqueta de versión y repite la acción. El destino correcto debe desplazarse a la vista. Marcar la incidencia como resuelta no sustituye esta comprobación de comportamiento.

Sustituir el archivo representa una corrección de código a pequeña escala. En un sitio de práctica alojado, registra el app.js y la etiqueta cambiados en un commit, revisa y despliega esa revisión y prueba su URL pública. Actualizar solo el estado o la etiqueta no aplica la corrección del selector.

Ejemplo resuelto

R1 falla con #contact-missing; R2 utiliza #contact. La prueba significativa de recuperación es que la acción de contacto funciona ahora en la revisión corregida.

Extra implementation exercise

La incidencia está resuelta en el panel, pero el script desplegado sigue buscando #contact-missing. ¿Se reparó el problema?

Mostrar una solución desarrollada

No. El estado del panel no cambia el script. Despliega la corrección mediante el proceso de revisión y verifica la acción en esa revisión.

  • Comprueba el código y revisión realmente desplegados.
  • Repite la acción que fallaba.

Paso 4

Termina una nota útil de incidente

Relaciona síntoma, corrección y verificación.

Completa incident-record.txt con el fallo original del botón, la pequeña corrección de destino y el resultado de repetir la misma acción en la página actualizada. Si publicas el cambio de práctica, comprueba esa versión publicada exacta, no únicamente el archivo local.

Mantén separadas las observaciones de monitoreo opcional: si el evento original llegó a Sentry, si configuraste una alerta y si la notificación llegó realmente. El registro debe explicar esta tarea reparada y los huecos restantes, no afirmar que todo el sitio está libre de errores.

Un ejemplo concreto

Una nota breve relaciona Contact fallido en practice-R1, arreglo del destino y nueva prueba correcta en practice-R2. «Resuelto» solo omite el resultado del visitante.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Tu tarea: redactar una nota de incidente útil

Permite que la próxima persona investigadora entienda la causa y las pruebas.

Completa el registro con referencia de evento sin datos sensibles, acción afectada, ubicación de código, causa raíz y nueva prueba correcta. Si configuras una alerta, verifica la notificación real por separado de la recepción del evento.

Añade un segundo fallo sintético en tu copia de práctica y repite el ciclo. Mantén mensajes fijos y actualiza deliberadamente la lista permitida; no amplíes la monitorización enviando datos arbitrarios de página o formulario.

Ejemplo resuelto

«Selector ausente corregido de #contact-missing a #contact; nueva prueba R2 superada» permite actuar. «Sentry tenía un error; resuelto» deja desconocidas la causa y la verificación.

Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.

Extra implementation exercise

Entrega una nota de incidente y demuestra que funciona la acción corregida.

Mostrar una solución desarrollada

Activa el cargador de práctica configurado y provoca el error sintético exacto. Si cambias el texto, actualiza intencionalmente la lista estricta; es normal descartar mensajes no permitidos. Examina el evento realmente recibido para comprobar versión, ubicación y datos no deseados.

Aplica el script corregido a public/app.js y cambia RELEASE a practice-R2. Publica esa revisión de práctica mediante el proceso revisado y repite Find contact section en la URL realmente desplegada. Cambiar solo la etiqueta de versión o el estado no repara el selector.

Registra la recepción de la incidencia por separado de la notificación de alerta. El evento puede verse antes de que llegue la alerta configurada; mantén pendiente cada observación hasta comprobarla. La nota de referencia relaciona fallo, ubicación, cambio de selector y nueva prueba visible para el usuario.

  • Relaciona síntoma, versión y causa en el código.
  • Verifica el comportamiento y mantiene separadas las afirmaciones de entrega del evento y la notificación.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.

Sigue aprendiendo

Explora las otras lecciones