Instalar la extensión
La publicación en la Chrome Web Store está en preparación. Cuando esté aprobada, este
será el único paso necesario: instalarla desde la tienda y dejar que el navegador la
mantenga actualizada.
Instalación desde el paquete
Mientras tanto, o si trabajas con una versión interna, la extensión se carga sin empaquetar:
- Descomprime el paquete que recibiste en una carpeta estable — si la mueves, el navegador la pierde.
- Abre
chrome://extensions o edge://extensions.
- Activa el modo de desarrollador.
- Pulsa Cargar descomprimida y elige esa carpeta.
- Recarga las pestañas que ya tenías abiertas: los interceptores viejos siguen activos hasta que la página se recarga.
Requisitos
- Google Chrome o Microsoft Edge en versión 114 o superior, que es cuando aparece el panel lateral.
- Cualquier sistema operativo de escritorio donde corran esos navegadores.
- Nada más: no hay servidor que configurar ni cuenta que crear.
Primeros pasos
-
Pulsa el icono de la extensión. Se abre el panel lateral, que es la interfaz completa;
también existe como panel de las herramientas de desarrollo, si prefieres tenerlo ahí.
-
Agrega el sitio donde vas a trabajar al alcance. De fábrica el alcance
está restringido y la extensión no actúa en ninguna página: es el paso que la gente
olvida y el motivo número uno de que la lista de capturas quede vacía.
- Enciende el interruptor principal.
- Recarga la página. Las llamadas empiezan a aparecer en la lista de capturas.
-
Sobre cualquier captura puedes crear una regla, y desde ahí simular la respuesta,
parchear un campo o editar la petición.
Atajos de teclado
Tres atajos son del navegador, y por eso funcionan con el panel cerrado. Puedes cambiarlos
o quitarlos en chrome://extensions/shortcuts.
El resto de atajos vive dentro del panel y su lista completa está en la ayuda de la propia interfaz.
Problemas frecuentes
La lista de capturas está vacía
Por orden de probabilidad: el sitio no está en el alcance, el interruptor principal está apagado, o la página no se ha recargado desde que activaste una de las dos cosas.
Hay llamadas que no aparecen
La capa de página intercepta fetch y XMLHttpRequest del
documento. Quedan fuera la navegación misma, las imágenes y hojas de estilo, y el tráfico
de los trabajadores de servicio. Para eso está el modo profundo, que alcanza todo eso a
cambio del aviso de depuración del navegador
(por qué necesita ese permiso). Ten presente la
regla general: la ausencia de una llamada en la lista no prueba que no haya ocurrido.
El modo profundo no se activa
Un navegador admite un solo depurador por pestaña. Si tienes abiertas las herramientas de
desarrollo en esa misma pestaña, ciérralas y vuelve a intentarlo. El mensaje de error que
aparece en la configuración es el que devuelve el navegador, sin traducir, precisamente
para que se pueda buscar.
Mis capturas desaparecieron
Las capturas se borran cuando cierras la pestaña que las generó. Es deliberado — está
explicado en la política de privacidad —. Si
necesitas conservarlas, exporta el HAR antes de cerrar.
Una regla no dispara
El editor de reglas incluye un diagnóstico que dice por qué: el patrón no coincide, el
método no corresponde, hay una condición que no se cumple o otra regla la cubre primero.
Empieza por ahí antes de reescribir el patrón a ciegas.
Cambié la configuración y la página sigue igual
Los cambios se aplican en caliente, pero el interceptor que ya está dentro de una página
no se sustituye: si recargaste la extensión desde la página de extensiones, recarga
también las pestañas.
Las reglas de red no se aplican
La barra de estado del panel informa cuando el navegador rechaza la sincronización de las
reglas de red o cuando alguna quedó fuera por límite de cupo. Si algo de la capa de red no
surte efecto, ese aviso es el primer sitio donde mirar.
Reportar un problema
Escribe a
jesusandrescorreal@gmail.com.
Con estos cinco datos el problema suele quedar identificado sin más ida y vuelta:
- Versión de la extensión y del navegador.
- Qué esperabas que pasara y qué pasó.
- Los pasos mínimos para reproducirlo.
- Si la regla involucrada se puede compartir, su exportación.
- Los errores de la consola, si hay: los de la página y los del proceso de la extensión.
Antes de adjuntar un archivo, revísalo. Un HAR o una captura de
pantalla de una sesión real contienen encabezados de autorización y, con frecuencia,
datos personales. La exportación de la configuración sí sustituye los valores marcados
como secretos; la de capturas no, porque un HAR es un registro fiel de lo que ocurrió.
Contacto
Jesús Andrés Correal Ortiz —
jesusandrescorreal@gmail.com.
El soporte lo atiende una sola persona, así que no hay un tiempo de respuesta
comprometido; los reportes con pasos claros para reproducir el problema son los que
avanzan primero.