Referencia de la clase JSWrapper

JavaScript Wrapper para ChromeV2.Page, proporciona métodos específicos para interactuar con elementos de la página a través de JavaScript. Más...

Diagrama de herencia de JSWrapper

Métodos públicos
	__New (chromeManager, url, matchMode :="exact", events :=0)
	Crea una nueva instancia de JSWrapper vinculada a una página de Chrome específica, identificada por su URL.
	Click (selector)
	Realiza un click en el elemento seleccionado por el selector CSS proporcionado.
	EditInputBox (selector, str)
	Introduce una cadena de texto en el elemento input seleccionado por el selector CSS proporcionado y dispara un evento "change" para actualizar el formulario.
	SelectListBox (selector, index)
	Selecciona una opción en un elemento select (lista desplegable) utilizando el índice de la opción y dispara un evento "change" para actualizar el formulario.
	SetValueWithNativeSetter (selector, value)
	Introduce un valor en un elemento input utilizando el setter nativo de JavaScript para asegurar que se disparen los eventos asociados al cambio de valor, como "input" o "change".
	Login (selectorUserInput, selectorPasswordInput, selectorLoginButton, selectorErrorOutput, userName, password)
	Realiza el proceso de login en una página web introduciendo el nombre de usuario y contraseña en los campos correspondientes, haciendo click en el botón de login y verificando si se ha producido algún error de autenticación.
	RetrieveTableData (selector)
	Extrae los datos de una tabla HTML y los devuelve como un array de objetos ordenados.
Métodos públicos heredados de ChromeV2::Page
	__New (url, events :=0)
	Conecta con la interfaz de depuración de una página web determinada por su WebSocket URL.
	__Delete ()
	Destruye correctamente la instancia de la clase.
	Call (DomainAndMethod, Params?, WaitForResponse :=true)
	Llamada web.
	Evaluate (JS)
	Ejecuta instrucciones JavaScript.
	WaitForEvaluate (JS)
	Ejecuta instrucciones JavaScript y espera a que cargue el documento.
	Close ()
	Cierra la página web.
	Activate ()
	Activa la página web y espera a que el documento finalice de cargar.
	onClose (p *)
	Intenta reconectar la página ante un cierre inesperado.
	onMessage (msg)
	Almacena el mensaje recibido de la página web e intenta ejecutar el callback establecido.
Métodos públicos heredados de WebSocket
	onOpen ()
	Evento desencadenado cuando la conexión WebSocket se ha establecido correctamente.
	onClose (status, reason)
	Evento desencadenado cuando la conexión se cierra.
	onData (data, size)
	Evento desencadenado al recibir un mensaje binario.
	onMessage (msg)
	Evento desencadenado al recibir un mensaje de texto UTF-8.
	reconnect ()
	Vuelve a establecer la conexión con el WebSocket utilizando los mismos parámetros originales.
	__New (Url, Events :=0, Async :=true, Headers :='', TimeOut :=0, InitialSize :=8192)
	Establece la conexión con el cliente WebSocket.
	queryCloseStatus ()
	Consulta el código y motivo de cierre enviados por el servidor.
	sendText (str)
	Envía una cadena de texto codificada en UTF-8 al servidor.
	send (buf)
	Envía datos binarios.
	receive ()
	Recibe un mensaje del servidor de forma bloqueante.
	shutdown ()
	Cierra la conexión WebSocket de forma controlada.

Métodos privados
	_OnChromeClosed (state)

Atributos privados
Chrome	:= unset

Otros miembros heredados
Atributos públicos heredados de ChromeV2::Page
KeepAlive	:= 0
	{Boolean} Estado de la conexión con la página.
	Navigation => this._navigation
	Facilita el acceso a las funciones de navegación de la página.
Atributos públicos heredados de WebSocket
Ptr	:= 0
	{Integer} Identificador interno del WebSocket (HINTERNET).
async	:= 0
	{Boolean} Modo de funcionamiento: true modo asíncrono, false modo síncrono.
readyState	:= 0
	{Integer} Estado de la conexión WebSocket.
url	:= ''
	{String} URL original del servidor WebSocket proporcionada al crear la instancia.
HINTERNETs	:= []
	{Array} Lista interna de todos los handles WinHTTP creados durante el ciclo de vida del objeto (hSession, hConnect, hRequest, hWebSocket).

Descripción detallada

JavaScript Wrapper para ChromeV2.Page, proporciona métodos específicos para interactuar con elementos de la página a través de JavaScript.

Páginas web de ejemplo para testear automatizaciones:

• https://the-internet.herokuapp.com/
• https://www.saucedemo.com/

Autor

bitasuperactive

Fecha

27/02/2026

Versión

1.0.0 @Warning Dependencias:

• ChromeV2.ahk
• ProcessWMI.ahk
• OrObject.ahk

Ver también

https://github.com/bitasuperactive/ahk2-chrome-library/blob/master/ChromeLibrary/JSWrapper.ahk

Documentación de funciones miembro

__New()

JSWrapper::__New ( chromeManager , url , matchMode : = "exact", events : = 0 )

inline

Crea una nueva instancia de JSWrapper vinculada a una página de Chrome específica, identificada por su URL.

Nota

Controla el cierre manual o inesperado del proceso de Chrome lanzando un error.

Parámetros

{ChromeV2}	chromeManager Instancia del administrador de Chrome.
{String}	url Enlace de la página a enlazar o abrir.
{String}	matchMode (Opcional) Tipo de búsqueda para el enlace. Puede ser: exact, contains, startswith o regex. Por defecto: exact.
{Func}	events (Opcional) Función a ejecutar cuando se reciba un mensaje de la página: msg => void.

_OnChromeClosed()

JSWrapper::_OnChromeClosed ( state )

inlineprivate

Excepciones

{Error}

Si el proceso de Chrome se ha cerrado de manera inesperada.

Click()

JSWrapper::Click ( selector )

inline

Realiza un click en el elemento seleccionado por el selector CSS proporcionado.

Parámetros

{String}

selector Selector del elemento a hacer click, por ejemplo: "#submit-button", ".nav-link", etc.

EditInputBox()

JSWrapper::EditInputBox ( selector , str  )

inline

Introduce una cadena de texto en el elemento input seleccionado por el selector CSS proporcionado y dispara un evento "change" para actualizar el formulario.

Nota

Si no funciona, utilizar SetValueWithNativeSetter para asegurar que se disparen los eventos asociados al cambio de valor.

Parámetros

{String}	selector Selector del elemento input a editar, por ejemplo: "#username", ".search-field", etc.
{String}	str Cadena de texto a introducir en el elemento seleccionado.

Login()

JSWrapper::Login ( selectorUserInput , selectorPasswordInput , selectorLoginButton , selectorErrorOutput , userName , password  )

inline

Realiza el proceso de login en una página web introduciendo el nombre de usuario y contraseña en los campos correspondientes, haciendo click en el botón de login y verificando si se ha producido algún error de autenticación.

Atención

La contraseña se introducirá en texto plano, por lo que se recomienda utilizar esta función solo en entornos controlados o de prueba.

Parámetros

{String}	selectorUserInput Selector del campo de entrada del nombre de usuario, por ejemplo: "#username", ".user-field", etc.
{String}	selectorPasswordInput Selector del campo de entrada de la contraseña, por ejemplo: "#password", ".pass-field", etc.
{String}	selectorLoginButton Selector del botón de login a hacer click, por ejemplo: "#login-button", ".submit-btn", etc.
{String}	selectorErrorOutput Selector del elemento que indica un error de autenticación, por ejemplo: "#error-message", ".login-error", etc.
{String}	userName Nombre de usuario a introducir en el campo correspondiente.
{String}	password Contraseña a introducir en el campo correspondiente.

Devuelve

{Boolean} true si el login se ha realizado correctamente, o false si se ha producido un error de autenticación.

RetrieveTableData()

JSWrapper::RetrieveTableData ( selector )

inline

Extrae los datos de una tabla HTML y los devuelve como un array de objetos ordenados.

Parámetros

{String}

selector Selector de la tabla a extraer, por ejemplo: "#data-table", ".info-table", etc.

Devuelve

{Array<OrObject>} Colección de objetos ordenados con los datos de la tabla, donde cada objeto representa una fila y las propiedades corresponden a las cabeceras de la tabla. Si no hay cabeceras o estas contienen otros objetos como enlaces, se les asigna nombres genéricos como "blank_1", "blank_2", etc.

SelectListBox()

JSWrapper::SelectListBox ( selector , index  )

inline

Selecciona una opción en un elemento select (lista desplegable) utilizando el índice de la opción y dispara un evento "change" para actualizar el formulario.

Parámetros

{String}	selector Selector del elemento select a editar, por ejemplo: "#country-select", ".options-dropdown", etc.
{Integer}	index Índice de la opción a seleccionar (comenzando desde 0).

SetValueWithNativeSetter()

JSWrapper::SetValueWithNativeSetter ( selector , value  )

inline

Introduce un valor en un elemento input utilizando el setter nativo de JavaScript para asegurar que se disparen los eventos asociados al cambio de valor, como "input" o "change".

Parámetros

{String}	selector Selector del elemento input a editar, por ejemplo: "#username", ".search-field", etc.
{String}	value Valor a introducir en el elemento seleccionado.