
Minilección 30 de 30 · Operar y mantener tu sitio web
Prueba la acción del visitante
¿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.
La página puede abrir aunque su función útil esté rota.
Propósito de esta lección
- 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.
Explicación, ejemplo resuelto y práctica
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.
Comprueba tus habilidades iniciales
Son habilidades útiles, no cursos obligatorios bloqueados. Si ya las tienes, empieza aquí; si no, abre la preparación. Los archivos incluidos evitan necesitar un sitio personal previo.
- Cómo publicar tu sitio web desde GitHub
Conecta un repositorio de práctica al alojamiento.
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.
Comprende la idea
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
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Qué falló al probar la acción?
Mostrar una solución desarrollada
En el ejemplo practice-R1, pulsar «Find contact section» falla y muestra el mensaje del error de práctica deliberado. Yo esperaba llegar a Contact. La portada sí se cargó, por lo que comprobar solo su disponibilidad no habría detectado este fallo del botón.
Qué incluye una respuesta adecuada
- Nombra botón real, Contact esperado y fallo visible.
- Distingue acción fallida y página cargada correctamente.
Cómo funciona (opcional)
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.
Ejercicio técnico adicional
¿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 1 · Cómo encontrar y corregir errores en tu sitio publicado
Recoge solo contexto seguro útil
Da evidencia al asistente sin datos privados.
Explicación, ejemplo resuelto y práctica
Comprende la idea
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.
Archivos de este paso
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Qué contexto compartirás y qué datos privados excluirás?
Mostrar una solución desarrollada
Compartiría los archivos practice-R1, la acción «Find contact section» y su mensaje de error. Con monitoreo activado, buscaría «Practice: missing contact target» y la versión correspondiente en mi proyecto de prueba. Excluiría correos de visitantes, texto de formularios y tokens de cuenta; una alerta en el buzón sigue siendo una comprobación separada.
Qué incluye una respuesta adecuada
- Comparte acción ficticia reproducible, revisión y contexto pertinente de archivo.
- Excluye contenido real y distingue eventos recibidos de alertas entregadas.
Cómo funciona (opcional)
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
Ejercicio técnico adicional
¿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 2 · Cómo encontrar y corregir errores en tu sitio publicado
Aplica una corrección concreta
Repite exactamente la acción fallida tras cambiar.
Explicación, ejemplo resuelto y práctica
Comprende la idea
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
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
¿Qué cambió y qué pasó al repetir la acción original?
Mostrar una solución desarrollada
En la solución proporcionada, el asistente cambia la búsqueda del destino ausente a #contact existente e identifica la revisión como practice-R2. La repetición esperada es que el mismo botón llegue a Contact y muestre «Contact section opened.» Una marca resuelta en monitoreo sin esa repetición no demuestra la reparación.
Qué incluye una respuesta adecuada
- Relaciona el arreglo pequeño de destino con Contact existente.
- Repite la acción en versión actual y verifica el resultado visible.
Cómo funciona (opcional)
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.
Ejercicio técnico adicional
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 3 · Cómo encontrar y corregir errores en tu sitio publicado
Termina una nota útil de incidente
Relaciona síntoma, corrección y verificación.
Explicación, ejemplo resuelto y práctica
Comprende la idea
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
Empieza aquíArchivos del taller
Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.
Pruébalo
Entrega registro y comprobación real de la acción corregida.
Qué debes entregar: Un registro breve con síntoma reproducido, cambio limitado y repetición realmente satisfactoria.
Mostrar una solución desarrollada
Ejemplo de incidente: Contact falló en practice-R1; el asistente arregló el destino; en practice-R2 el mismo botón llegó a Contact y mostró éxito. El evento ficticio se comprobó aparte en el proyecto de prueba. No se configuró alerta, así que notificaciones no están probadas. Cubre ese defecto, no todos los futuros errores.
Qué incluye una respuesta adecuada
- Relaciona síntoma, cambio acotado y repetición real en la versión identificada.
- Separa eventos/alertas e identifica alcance aún sin probar.
Cómo funciona (opcional)
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.
Ejercicio técnico adicional
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.