Automatiza Google Chrome mediante el Chrome DevTools Protocol. Más...

Clases
class	Page
	Representa una conexión WebSocket a la interfaz de depuración de una página de Chrome. Más...

Métodos públicos
	__New (ChromePath :="", DebugPort :=9222, ProfilePath :="", Flags :="", URLs :="")
	Inicia o conecta una instancia de Google Chrome en modo depuración y abre las URL(s) indicadas si no están ya abiertas.
	Kill ()
	Mata el proceso de Google Chrome asociado a esta instancia.
	NewPage (url :='about:blank', fnCallback?)
	Abre una nueva página en la instancia de Chrome lista para operar.
	FindPages (opts, MatchMode :='exact')
	Busca páginas abiertas que coincidan con los criterios proporcionados.
	ClosePage (opts, MatchMode :='exact')
	Cierra la página abierta que coincida con los criterios proporcionados.
	ActivatePage (opts, MatchMode :='exact')
	Activa la página abierta que coincida con los criterios proporcionados.

Atributos públicos
ExeName	:= unset
	{String} Nombre del ejecutable local de Chrome.
DebugPort	:= unset
	{Integer} Puerto de conexión para la depuración.
PID	:= unset
	{Integer} Identificador del proceso de Chrome.

Métodos privados
	_GetPageList ()
	Consulta Chrome para obtener una lista de páginas que exponen una interfaz de depuración.
	GetPageBy (Key, Value, MatchMode :='exact', Index :=1, fnCallback?)
	Devuelve una conexión a la interfaz de depuración de la página que coincida con los criterios proporcionados lista para operar.
	GetPageByURL (Value, MatchMode :='startswith', Index :=1, fnCallback?)
	Abreviatura de GetPageBy('url', Value, 'startswith').
	GetPageByTitle (Value, MatchMode :='startswith', Index :=1, fnCallback?)
	Abreviatura de GetPageBy('title', Value, 'startswith').
	GetPage (Index :=1, Type :='page', fnCallback?)
	Abreviatura de GetPageBy('type', Type, 'exact').

Métodos privados estáticos
static	_FindBrowserInstance (exeName, debugPort)
	Busca la instancia ejecutada de Google Chrome para el puerto de depuración especificado.

Atributos estáticos privados
static	_http:= ComObject('WinHttp.WinHttpRequest.5.1')
	Instancia de WinHttpRequest para las solicitudes HTTP.

Descripción detallada

Automatiza Google Chrome mediante el Chrome DevTools Protocol.

Gestiona el navegador a nivel HTTP (/json endpoint).

Autor: thqby; bitasuperactive (QoL improvements, documentation)

Fecha: 27/02/2026

Versión

1.1.0 @Warning Dependencias:

WebSocket.ahk
JsonParser.ahk

Ver también: https://github.com/thqby/ahk2_lib/blob/master/Chrome.ahk; https://github.com/bitasuperactive/ahk2-chrome-library/blob/master/ChromeLibrary/ChromeBridge/ChromeV2.ahk

Documentación de funciones miembro

◆ __New()

ChromeV2::__New	(	ChromePath :	= "",
		DebugPort :	= 9222,
		ProfilePath :	= "",
		Flags :	= "",
		URLs :	= "" )

inline

Inicia o conecta una instancia de Google Chrome en modo depuración y abre las URL(s) indicadas si no están ya abiertas.

Parámetros

{String}	ChromePath (Opcional) Ruta completa al ejecutable de Chrome. Si se deja en blanco, se buscará en los accesos directos, registros del sistema y en la ruta estándar.
{Integer}	DebugPort (Opcional) Puerto local para el modo depuración. Por defecto: 9222.
{String}	ProfilePath (Opcional) Ruta al perfil de usuario de Chrome. Si no se establece, se utilizará la ruta estándar.
{String}	Flags (Opcional) Banderas adicionales para el lanzamiento de Chrome.
{String\|Array<String>}	URLs (Opcional) URL o colección de URL(s) a abrir al iniciar o conectar Chrome. Si la url exacta ya se encuentra abierta, no se vuelve a abrir.

Escapa las comillas del texto para la línea de comandos.

◆ _FindBrowserInstance()

ChromeV2::_FindBrowserInstance	(	exeName	,
		debugPort	)

inlinestaticprivate

Busca la instancia ejecutada de Google Chrome para el puerto de depuración especificado.

Parámetros

{String}	exeName Nombre del ejecutable de Chrome.
{Integer}	debugPort Puerto de depuración local.

Devuelve: {Object} Si encuentra una instancia, devuelve un objeto con las propiedades: Base - La clase Chrome, DebugPort - Puerto de depuración, PID - ID del proceso. Si no encuentra ninguna instancia, devuelve 0.

◆ _GetPageList()

ChromeV2::_GetPageList ( )

inlineprivate

Consulta Chrome para obtener una lista de páginas que exponen una interfaz de depuración.

Además de las pestañas estándar, estas incluyen páginas como la configuración de extensiones.

Devuelve: {Array<Map>} Colección de mapas que representan las páginas disponibles para depuración.

◆ ActivatePage()

ChromeV2::ActivatePage	(	opts	,
		MatchMode :	= 'exact' )

inline

Activa la página abierta que coincida con los criterios proporcionados.

Parámetros

{Map\|Object}	opts Objeto con las propiedades a buscar en la lista de páginas.
{String}	MatchMode (Opcional) Tipo de búsqueda a realizar. Puede ser: exact, contains, startswith o regex. Por defecto: exact.

◆ ClosePage()

ChromeV2::ClosePage	(	opts	,
		MatchMode :	= 'exact' )

inline

Cierra la página abierta que coincida con los criterios proporcionados.

Parámetros

{String\|Map\|Object}	opts Cadena, mapa u objeto que contega el id de la página a cerrar.
{String}	MatchMode (Opcional) Tipo de búsqueda a realizar. Puede ser: exact, contains, startswith o regex. Por defecto: exact.

◆ FindPages()

ChromeV2::FindPages	(	opts	,
		MatchMode :	= 'exact' )

inline

Busca páginas abiertas que coincidan con los criterios proporcionados.

Parámetros

{Map\|Object}	opts Un objeto con las propiedades a buscar en la lista de páginas.
{String}	MatchMode (Opcional) Tipo de búsqueda a realizar. Puede ser: exact, contains, startswith o regex. Por defecto: exact.

Devuelve: {Array<Map>} Colección de mapas que representan las páginas que coinciden con los criterios de búsqueda.

◆ GetPage()

ChromeV2::GetPage	(	Index :	= 1,
		Type :	= 'page',
		fnCallback?	)

inlineprivate

Abreviatura de GetPageBy('type', Type, 'exact').

Parámetros

{Integer}	Index (Opcional) Si varias páginas coinciden con los criterios proporcionados, cuál de ellas devolver. Por defecto: 1.
{String}	Type (Opcional) Tipo de página a buscar. Por defecto es "page" que representa el área visible de una pestaña normal de Chrome.
{Func}	fnCallback (Opcional) Función a ejecutar cuando se reciba un mensaje de la página: msg => void.

Devuelve: {ChromeV2.Page|0} Página que coincide con los criterios o 0 si no se encuentra ninguna.

◆ GetPageBy()

ChromeV2::GetPageBy	(	Key	,
		Value	,
		MatchMode :	= 'exact',
		Index :	= 1,
		fnCallback?	)

inlineprivate

Devuelve una conexión a la interfaz de depuración de la página que coincida con los criterios proporcionados lista para operar.

Cuando varias páginas coinciden con los criterios, aparecen por orden de apertura más reciente.

Parámetros

{String}	Key La clave de la lista de páginas a buscar, como "url" o "title".
{String}	Value El valor a buscar en la clave proporcionada.
{String}	MatchMode (Opcional) Tipo de búsqueda a realizar. Puede ser: exact, contains, startswith o regex. Por defecto: exact.
{Integer}	Index (Opcional) Si varias páginas coinciden con los criterios proporcionados, cuál de ellas devolver. Por defecto: 1.
{Func}	fnCallback (Opcional) Función a ejecutar cuando se reciba un mensaje de la página: msg => void.

Devuelve: {ChromeV2.Page|0} Página que coincide con los criterios o 0 si no se encuentra ninguna.

◆ GetPageByTitle()

ChromeV2::GetPageByTitle	(	Value	,
		MatchMode :	= 'startswith',
		Index :	= 1,
		fnCallback?	)

inlineprivate

Abreviatura de GetPageBy('title', Value, 'startswith').

Parámetros

{String}	Value Título a buscar.
{String}	MatchMode (Opcional) Tipo de búsqueda a realizar. Puede ser: exact, contains, startswith o regex. Por defecto: startswith.
{Integer}	Index (Opcional) Si varias páginas coinciden con los criterios proporcionados, cuál de ellas devolver. Por defecto: 1.
{Func}	fnCallback (Opcional) Función a ejecutar cuando se reciba un mensaje de la página: msg => void.

Devuelve: {ChromeV2.Page|0} Página que coincide con los criterios o 0 si no se encuentra ninguna.

◆ GetPageByURL()

ChromeV2::GetPageByURL	(	Value	,
		MatchMode :	= 'startswith',
		Index :	= 1,
		fnCallback?	)

inlineprivate

Abreviatura de GetPageBy('url', Value, 'startswith').

Parámetros

{String}	Value Url a buscar.
{String}	MatchMode (Opcional) Tipo de búsqueda a realizar. Puede ser: exact, contains, startswith o regex. Por defecto: startswith.
{Integer}	Index (Opcional) Si varias páginas coinciden con los criterios proporcionados, cuál de ellas devolver. Por defecto: 1.
{Func}	fnCallback (Opcional) Función a ejecutar cuando se reciba un mensaje de la página: msg => void.

Devuelve: {ChromeV2.Page|0} Página que coincide con los criterios o 0 si no se encuentra ninguna.

◆ NewPage()

ChromeV2::NewPage	(	url :	= 'about:blank',
		fnCallback?	)

inline

Abre una nueva página en la instancia de Chrome lista para operar.

Parámetros

{String}	url Enlace a abrir en la nueva página. Por defecto: "about:blank".
{Func}	fnCallback (Opcional) Función a ejecutar cuando se reciba un mensaje de la página: msg => void.

Devuelve: {ChromeV2.Page|0} Página creada lista para operar, o 0 si no se ha podido crear.

Clases

Métodos públicos

Atributos públicos

Métodos privados

Métodos privados estáticos

Atributos estáticos privados

Descripción detallada

Documentación de funciones miembro

◆ __New()

◆ _FindBrowserInstance()

◆ _GetPageList()

◆ ActivatePage()

◆ ClosePage()

◆ FindPages()

◆ GetPage()

◆ GetPageBy()

◆ GetPageByTitle()

◆ GetPageByURL()

◆ NewPage()