acerca:depurado

La página about:debugging proporciona un lugar desde el que puede adjuntar las herramientas de desarrollador de Firefox a varios objetivos de depuración. Por el momento, admite tres tipos principales de objetivos: complementos que no requieren reinicio (restartless add-ons), pestañas y trabajadores.

Abrir la página about:debugging

Hay dos formas de abrir el about:debugging:

  • Escriba about:debugging en la barra de URL de Firefox.
  • En el menú Herramientas> Desarrollador web, haga clic en Depuración remota.

Cuando about:debugging se abre, en el lado izquierdo verá una barra lateral con dos opciones e información sobre su configuración de depuración remota:

Configuración

Use la pestaña Configuración para configurar la conexión a su dispositivo remoto.

Este Firefox
Proporciona información sobre las extensiones temporales que ha cargado para la depuración, las extensiones que están instaladas en Firefox, las pestañas que tiene abiertas actualmente y los trabajadores de servicios que se ejecutan en Firefox.

Si su página about:debugging es diferente de la que se muestra aquí, vaya a about:config, busque y establezca la opción devtools.aboutdebugging.new-enabled en true.

Pestaña Configuración

Conectarse a un dispositivo remoto

Firefox admite la depuración a través de USB con dispositivos Android, utilizando la página about:debugging.

Antes de conectarte:

  1. Habilite la configuración de desarrollador en su dispositivo Android.
  2. Habilite la depuración de USB en la configuración del desarrollador de Android.
  3. Habilite la depuración remota a través de USB en la Configuración avanzada en Firefox en el dispositivo Android.
  4. Conecte el dispositivo Android a su computadora con un cable USB.

Si su dispositivo no aparece en el lado izquierdo de la página about:debugging, intente hacer clic en el botón Actualizar dispositivos.

Si aún no aparece, puede deberse a que el enlace entre su dispositivo Android y su computadora aún no está autorizado. Primero asegúrese de haber instalado Android Debug Bridge de Android Tools en su computadora para que pueda conectarse a su dispositivo. A continuación, deshabilite todas las configuraciones de depuración ya activadas y repita los pasos descritos anteriormente. Su dispositivo debe mostrar una ventana emergente para autorizar a su computadora a conectarse a él; acepte esto y luego haga clic en el botón Actualizar dispositivos nuevamente. El dispositivo debería aparecer.

Nota: No necesita instalar el SDK completo de Android Studio. Solo se necesita adb.

Para comenzar una sesión de depuración, primero abra la página que desea depurar y luego haga clic en Conectar al lado del nombre del dispositivo para abrir una conexión. Si la conexión fue exitosa, ahora puede hacer clic en el nombre del dispositivo para cambiar a una pestaña con información sobre el dispositivo.

Screenshot of the debugging page for an Android device

La información en esta página es la misma que la información en la pestaña Este Firefox, pero en lugar de mostrar información para su computadora, muestra la información para el dispositivo remoto con la adición de una sección de Pestañas con una entrada para cada una de las pestañas abiertas en el dispositivo remoto.

Nota: Si la versión de Firefox en su dispositivo es una versión anterior (o más) a la versión de su computadora, es posible que vea un mensaje como el siguiente:

The connected browser has an old version (68.2.0). The minimum supported version (69.0a1). This is an unsupported setup and may cause DevTools to fail. Please update the connected browser.

En Firefox 76 y superior, el mensaje puede tener el siguiente aspecto:This version of Firefox cannot debug Firefox for Android (68). We recommend installing Firefox for Android Nightly on your phone for testing. More details

En la imagen de abajo, hay tres pestañas abiertas: Network or cache RecipeNightly Home, y About Nightly. Para depurar el contenido de una de estas pestañas, haga clic en el botón Inspeccionar junto a su título. Cuando lo haga, las Herramientas para desarrolladores se abrirán en una nueva pestaña.

Screenshot showing the remote debugging window, with the editable URL bar

Ademas de la lista habitual de herramientas, tambien puede ver información sobre el dispositivo al que está conectado, incluido que está conectado (en este ejemplo) a través de USB, a Firefox Preview, en un Pixel 2, así como el título del página que está depurando y la dirección de la página.

A partir de Firefox 78, la barra de URL es editable, por lo que puede cambiar la URL utilizada por el navegador en el dispositivo remoto. También puede volver a cargar la página haciendo clic en el botón Reload junto a la barra de URL (a partir de 79), navegar hacia atrás o hacia adelante en el historial de navegación con los botones Atrás y Adelante.

Conectando a través de la red

Puede conectarse a un servidor de depuración de Firefox en su red o en su máquina de depuración utilizando la configuración de Ubicación de red de la página about:debugging.

Ingrese la ubicación y el puerto en el que se ejecuta el servidor del depurador. Cuando lo haga, se agregará a la lista de ubicaciones de red junto con los dispositivos, como se muestra a continuación:

Este Firefox

La pestaña Este Firefox combina las características de Extensiones, Pestañas y Trabajadores en una sola pestaña con las siguientes secciones:

Extensiones Temporales
Muestra una lista de las extensiones que ha cargado utilizando el botón Cargar complemento temporal.
Extensiones
Esta sección enumera información sobre las extensiones que ha instalado en su sistema.
Trabajadores de servicios, trabajadores compartidos y otros trabajadores
Hay tres secciones en esta página que tratan sobre los trabajadores de servicios, trabajadores compartidos y otros trabajadores.

Si las extensiones internas aparecen en la lista de esta página depende de la configuración de la preferencia devtools.aboutdebugging.showHiddenAddons. Si necesita ver estas extensiones, navegue hasta about:config y asegúrese de que la preferencia esté establecida en true.

Extensiones

Cargando una extensión temporal

Con el botón Cargar complemento temporalmente puede cargar temporalmente una extensión web desde un directorio en el disco. Haga clic en el botón, navegue hasta el directorio que contiene el complemento y seleccione su archivo de manifiesto. La extensión temporal se muestra debajo del encabezado Extensiones temporales.

No tiene que empaquetar o firmar la extensión antes de cargarlas. La extensión permanecerá instalada hasta que reinicie Firefox.

Las principales ventajas de este método, en comparación con la instalación de un complemento desde un XPI, son:

  • No tiene que reconstruir un XPI y reinstalarlo cuando cambia el código del complemento;
  • Puede cargar un complemento sin firmarlo y sin necesidad de deshabilitar signing.

Una vez que haya cargado una extensión temporal, puede ver información sobre ella y realizar operaciones.

Screenshot of the debugging information panel for a temporary extension

Puede usar los siguientes botones:

Inspeccionar
Carga la extensión en el depurador.
Reload
Vuelve a cargar la extensión temporal. Esto es útil cuando ha realizado cambios en la extensión.
Eliminar
Retira la extensión temporal.

Se muestra otra información sobre la extensión:

Ubicación
La ubicación del código fuente de la extensión en su sistema local.
ID de extensión
La ID temporal asignada a la extensión.
UUID interno
El UUID interno asignado a la extensión.
Manifiesto de la URL
Si hace clic en el enlace, el manifiesto de esta extensión se carga en una nueva pestaña.

Actualización de una extensión temporal

Si instala una extensión de esta manera, ¿qué sucede cuando actualiza la extensión?

  • Si cambia los archivos que se cargan a pedido, como las secuencias de comandos de contenido o ventanas emergentes, los cambios que realice se recogen automáticamente y los verá la próxima vez que se cargue la secuencia de comandos de contenido o se muestre la ventana emergente.
  • Para otros cambios, haga clic en el botón Recargar. Esto hace lo que dice:
    • Recarga las secuencias de comandos persistentes, como los background scripts
    • Analiza el archivo manifest.json nuevamente, por lo que los cambios a los permisos, content_scriptsbrowser_action o cualquier otra llave surtirán efecto

Extensiones instaladas

Las extensiones instaladas permanentemente se enumeran en la sección Extensiones. Para cada extensión Ud. verá algo como lo siguiente:

Screenshot of the debugging information panel for an installed extension

El botón Inspeccionar y los campos ID de extensión y UUID interno son los mismos que para las extensiones temporales.

Al igual que sucede con las extensiones cargadas temporalmente, el enlace junto a la URL del manifiesto abre el manifiesto cargado en una nueva pestaña.

Nota: Se recomienda que use la caja de herramientas del navegador, no el depurador de complementos, para depurar extensiones web. Vea Depuración de WebExtensions para todos los detalles.

La sección Complementos en about:debugging enumera todas las extensiones web que están instaladas actualmente. Al lado de cada entrada hay un botón etiquetado Inspeccionar.

Nota: esta lista puede incluir complementos que vienen preinstalados con Firefox.

Si hace clic en Inspeccionar, el depurador de complementos comenzará en una nueva pestaña.

Consulte la página del depurador de complementos para ver todas las cosas que puede hacer con esta herramienta.

Workers

Esta sección muestra todos los Workers que tienes registrados en tu Firefox, clasificados de la siguiente manera:

Puede conectar las herramientas de desarrollador a cada trabajador y enviar notificaciones push a los trabajadores del servicio.

Estado trabajador de servicio

La lista de trabajadores de servicio muestra el estado del trabajador de servicio en su ciclo de vida. Son posibles tres estados:

  • Registro: cubre todos los estados entre el registro inicial del trabajador del servicio y su control de las páginas. Es decir, subsume los estados de instalación, activación y espera.
  • En ejecución: el trabajador de servicio se está ejecutando actualmente. Está instalado y activado, y actualmente maneja eventos.
  • Detenido: el trabajador de servicio está instalado y activado, pero ha finalizado después de estar inactivo.

Screenshot of the debugging panel for a service worker that is in the Running state

Esta sección utiliza una demostración simple de ServiceWorker, alojada en https://serviceworke.rs/push-simple/.

Nota: Desde Firefox 79 en adelante, puede acceder a información similar sobre los Service Workers registrados en un dominio en particular yendo al panel de Aplicación de Firefox DevTools.

Dar de baja a los trabajadores del servicio

Haga clic en el botón Cancelar registro para cancelar el registro del trabajador de servicio.

Envío de eventos push a service workers

Para depurar notificaciones push, puede establecer un punto de interrupción en el detector de eventos push. Sin embargo, también puede depurar notificaciones push localmente, sin necesidad del servidor. Haga clic en el botón Push para enviar un evento push al trabajador del servicio.

Trabajadores de servicio no compatibles

Se muestra un mensaje de advertencia en la parte superior de la pestaña Este Firefox si los trabajadores del servicio son incompatibles con la configuración actual del navegador y, por lo tanto, no se pueden usar ni depurar.

Los trabajadores de servicio pueden no estar disponibles si la preferencia dom.serviceWorkers.enable está configurada como false en about:config.

Conexión a Firefox para Android 68

Las versiones de Firefox para Android que se basan en la versión 68 no se pueden depurar desde las versiones de escritorio de Firefox 69 o posteriores, debido a la diferencia en las versiones de lanzamiento. Hasta el momento en que Firefox para Android se actualice a una versión principal más reciente, en sincronización con Firefox de escritorio, debe usar una de las siguientes versiones de Firefox para Android:

Si prefiere realizar la prueba con la versión principal de Firefox para Android (es decir, según la versión 68), puede hacerlo con la versión de soporte extendido (ESR) de Firefox para escritorio, que también se basa en la versión 68.

Tenga en cuenta queen about:debugging la depuración no está habilitada de forma predeterminada en Firefox ESR. Para habilitarlo, abra el Editor de configuración (about:config) y establezca devtools.aboutdebugging.new-enabled en true.

Si utilizó una versión superior de Firefox antes de instalar Firefox ESR, se le pedirá que cree un nuevo perfil de usuario para proteger sus datos de usuario. Para obtener más información, consulte ¿Qué sucede con mi perfil si cambio a una versión anterior de Firefox?