chrome.debugger

Descripción

La API de chrome.debugger sirve como transporte alternativo para el protocolo de depuración remota de Chrome. Usa chrome.debugger para adjuntar a una o más pestañas a fin de instrumentar la interacción de red, depurar JavaScript, mutar el DOM y el CSS, etc. Usa Debuggee tabId para segmentar pestañas con eventos sendCommand y enrutar mediante tabId de devoluciones de llamada onEvent.

Permisos

debugger

Para usar esta API, debes declarar el permiso "debugger" en el manifiesto de tu extensión.

{
  "name": "My extension",
  ...
  "permissions": [
    "debugger",
  ],
  ...
}

Nota

Por motivos de seguridad, la API de chrome.debugger no proporciona acceso a todos los dominios de protocolo de las Herramientas para desarrolladores de Chrome. Los dominios disponibles son: Accessibility, Audits, CacheStorage, Console, CSS, Database, Debugger, DOMDebugger, DOMDebugger, DOMSnapshot,EmulationWebAudioWebAuthn

Ejemplos

Para probar esta API, instala el ejemplo de la API del depurador del repositorio chrome-extension-samples.

Tipos

Debuggee

Es el identificador del elemento depurado. Se debe especificar tabId, extensionId o targetId

Propiedades

  • extensionId

    cadena opcional

    Es el ID de la extensión que quieres depurar. La conexión a una página en segundo plano de una extensión solo es posible cuando se usa el cambio de línea de comandos --silent-debugger-extension-api.

  • tabId

    número opcional

    El ID de la pestaña que deseas depurar.

  • targetId

    cadena opcional

    Es el ID opaco del destino de la depuración.

DebuggerSession

Pendiente

Es el identificador de sesión del depurador. Se debe especificar uno de los campos tabId, extensionId o targetId. Además, se puede proporcionar un sessionId opcional. Si se especifica sessionId para los argumentos enviados desde onEvent, significa que el evento proviene de una sesión de protocolo secundaria dentro de la sesión de depuración raíz. Si se especifica sessionId cuando se pasa a sendCommand, se orienta a una sesión de protocolo secundaria dentro de la sesión raíz de depuración.

Propiedades

  • extensionId

    cadena opcional

    Es el ID de la extensión que quieres depurar. La conexión a una página en segundo plano de una extensión solo es posible cuando se usa el cambio de línea de comandos --silent-debugger-extension-api.

  • sessionId

    cadena opcional

    El ID opaco de la sesión del protocolo de las Herramientas para desarrolladores de Chrome. Identifica una sesión secundaria dentro de la sesión raíz identificada por tabId, extensionId o targetId.

  • tabId

    número opcional

    El ID de la pestaña que deseas depurar.

  • targetId

    cadena opcional

    Es el ID opaco del destino de la depuración.

DetachReason

Chrome 44 y versiones posteriores

Motivo de cancelación de la conexión.

Enum

"target_closed"

"canceled_by_user"

TargetInfo

Depurar información de destino

Propiedades

  • se conecte el disco

    boolean

    Es verdadero si ya se adjuntó el depurador.

  • extensionId

    cadena opcional

    El ID de la extensión, definido si tipo = 'background_page'.

  • faviconUrl

    cadena opcional

    URL del ícono de página de destino.

  • id

    cadena

    ID de destino.

  • tabId

    número opcional

    El ID de pestaña, definido si tipo == 'page'.

  • title

    cadena

    Es el título de la página de destino.

  • Tipo de objetivo.

  • url

    cadena

    URL de destino.

TargetInfoType

Chrome 44 y versiones posteriores

Tipo de objetivo.

Enum

"background_page"

"worker"

Métodos

attach()

Promesa 
chrome.debugger.attach(
  target: Debuggee,
  requiredVersion: string,
  callback?: function,
)

Adjunta el depurador al destino determinado.

Parámetros

  • destino

    Depurado

    Destino de depuración al que quieres conectar

  • requiredVersion

    cadena

    Versión requerida del protocolo de depuración ("0.1"). Solo se puede adjuntar al elemento depurado con una versión principal coincidente y una versión secundaria superior o igual. Puedes obtener la lista de las versiones del protocolo aquí.

  • callback

    Función opcional

    El parámetro callback se ve de la siguiente manera: 

    ()=>void

Devuelve

  • Promise<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

detach()

Promesa 
chrome.debugger.detach(
  target: Debuggee,
  callback?: function,
)

Desconecta el depurador del destino determinado.

Parámetros

  • destino

    Depurado

    Destino de depuración del que quieres desconectar.

  • callback

    Función opcional

    El parámetro callback se ve de la siguiente manera: 

    ()=>void

Devuelve

  • Promise<void>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

getTargets()

Promesa 
chrome.debugger.getTargets(
  callback?: function,
)

Muestra la lista de destinos de depuración disponibles.

Parámetros

  • callback

    Función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result: TargetInfo[])=>void

    • resultado

      TargetInfo

      Es el array de objetos TargetInfo que corresponden a los destinos de depuración disponibles.

Devuelve

  • Promise<TargetInfo[]>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

sendCommand()

Promesa 
chrome.debugger.sendCommand(
  target: DebuggerSession,
  method: string,
  commandParams?: object,
  callback?: function,
)

Envía el comando al destino de depuración.

Parámetros

  • destino

    DebuggerSession

    El destino de depuración al que quieres enviar el comando.

  • method

    cadena

    Nombre del método. Debe ser uno de los métodos definidos por el protocolo de depuración remota.

  • commandParams

    objeto opcional

    Objeto JSON con parámetros de solicitud. Este objeto debe cumplir con el esquema de parámetros de depuración remota para el método determinado.

  • callback

    Función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result?: object)=>void

    • resultado

      objeto opcional

      un objeto JSON con la respuesta. La estructura de la respuesta varía según el nombre del método y se define mediante el atributo “returns” de la descripción del comando en el protocolo de depuración remota.

Devuelve

  • Promise<object|undefined>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

Eventos

onDetach

chrome.debugger.onDetach.addListener(
  callback: function,
)

Se activa cuando el navegador finaliza la sesión de depuración de la pestaña. Esto sucede cuando se cierra la pestaña o se invocan las Herramientas para desarrolladores de Chrome para la pestaña adjunta.

Parámetros

onEvent

chrome.debugger.onEvent.addListener(
  callback: function,
)

Se activa cuando el objetivo de depuración emite un evento de instrumentación.

Parámetros

  • callback

    la función

    El parámetro callback se ve de la siguiente manera: 

    (source: DebuggerSession,method: string,params?: object)=>void