Esta secci¨®n describe las adiciones de Áú»¢¶Ä²© al lenguaje JavaScript implementado con Duktape para su uso en el script de la m¨¦trica de navegador. Estas adiciones complementan los objetos JavaScript descritos en la p¨¢gina Objetos JavaScript adicionales.
El objeto Browser
administra las sesiones de WebDriver, inicializando una sesi¨®n al crearla y finaliz¨¢ndola al destruirla. Un solo script puede admitir hasta cuatro objetos Browser
.
Para construir un objeto Browser
, utilice la sintaxis new Browser(options)
. El par¨¢metro options
(objeto JSON) especifica las opciones del navegador, normalmente el resultado del m¨¦todo de opciones de WebDriver (por ejemplo, Browser.chromeOptions()
).
Los siguientes m¨¦todos son compatibles con el objeto Browser
.
²Ñ¨¦³Ù´Ç»å´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
---|---|
navigate(url) |
Navegar a la URL especificada. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: url - (cadena) URL a la que navegar. |
getUrl() |
Devuelve una cadena de la URL de la p¨¢gina abierta. |
getPageSource() |
Devuelve una cadena del c¨®digo fuente de la p¨¢gina abierta. |
findElement(strategy, selector) |
Devuelve un objeto Element con un elemento en la p¨¢gina abierta (o devuelve null si ning¨²n elemento coincide con strategy y selector ).±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: strategy - (cadena, selector CSS/texto del enlace/texto parcial del enlace/nombre de la etiqueta/Xpath) Estrategia de ubicaci¨®n;selector - (cadena) Selector de elementos que utiliza la estrategia de ubicaci¨®n especificada. |
findElements(strategy, target) |
Devuelve una matriz de objetos Element con m¨²ltiples elementos en la p¨¢gina abierta (o devuelve una matriz vac¨ªa si ning¨²n elemento coincide con la estrategia de ubicaci¨®n y el objetivo).±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: strategy - (string, selector CSS/texto del enlace/texto parcial del enlace/nombre de etiqueta/Xpath) Estrategia de ubicaci¨®n;target - (string) Selector de elementos que utiliza la estrategia de ubicaci¨®n especificada. |
getCookies() |
Devuelve una matriz de objetos Cookie . |
addCookie(cookie) |
Establecer cookies. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: cookie - (objeto Cookie ) Cookie para establecer. |
getScreenshot() |
Devuelve una cadena codificada en base64 que representa una imagen de la ventana gr¨¢fica del navegador. |
setScreenSize(x,y) |
Establece el tama?o de la ventana gr¨¢fica del navegador. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: x - (cadena) Altura en p¨ªxeles;y - (cadena) Ancho en p¨ªxeles. |
setScriptTimeout(timeout) |
Establece el tiempo de espera para la carga del script. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: timeout - (entero) Valor de tiempo de espera en milisegundos. |
setSessionTimeout(timeout) |
Establece el tiempo de espera de la sesi¨®n (carga de la p¨¢gina). ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: timeout - (entero) Valor de tiempo de espera en milisegundos. |
setElementWaitTimeout(timeout) |
Establece el tiempo de espera (impl¨ªcito) de la estrategia de ubicaci¨®n de elementos. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: timeout - (entero) Valor de tiempo de espera en milisegundos. |
collectPerfEntries(mark) |
Recopila entradas de rendimiento para recuperarlas con el m¨¦todo getResult() .±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: mark - (string, opcional) Marca de instant¨¢nea de rendimiento. |
getRawPerfEntries() |
Devuelve una matriz de objetos de entrada de rendimiento. |
getResult() |
Devuelve un objeto Result con estad¨ªsticas de la sesi¨®n del navegador (informaci¨®n de error, instant¨¢neas de rendimiento, etc.). |
getError() |
Devuelve un objeto BrowserError con errores del navegador (o devuelve null si no hay errores del navegador). |
setError(message) |
Establece un mensaje de error personalizado para incluir en el objeto Result .±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: message - (string) Mensaje de error. |
discardError() |
Descarta el error que se devolver¨¢ en el objeto Result . |
getAlert() |
Devuelve un objeto Alert con alertas del navegador (o devuelve null si no hay alertas del navegador). |
chromeOptions() |
Devuelve un objeto chromeOptions con opciones predefinidas del navegador Chrome. |
firefoxOptions() |
Devuelve un objeto firefoxOptions con opciones predefinidas del navegador Firefox. |
safariOptions() |
Devuelve un objeto safariOptions con opciones predefinidas del navegador Safari. |
edgeOptions() |
Devuelve un objeto edgeOptions con opciones predefinidas del navegador Edge. |
switchFrame(target) |
Cambia al marco especificado. Compatible desde la versi¨®n 7.0.4. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: target - (elemento del navegador o entero, opcional) Marco de destino. Para seleccionar un marco por elemento, pase el elemento. Para seleccionar un marco por ¨ªndice, pase el n¨²mero. Si se deja vac¨ªo, cambiar¨¢ al contexto de ²Ô²¹±¹±ð²µ²¹³¦¾±¨®²Ô de nivel superior. |
Todos los m¨¦todos de Browser pueden generar los siguientes errores:
BrowserError
- derivado del objeto Error
que se genera si falla el constructor Browser
; contiene una propiedad browser
adicional con un objeto Browser
que gener¨® este BrowserError
.WebdriverError
- derivado de BrowserError
; contiene las mismas propiedades que el objeto BrowserError
, que indican si el error se gener¨® en respuesta a un error en la respuesta de WebDriver.El objeto Element
es devuelto por los m¨¦todos del objeto Browser
findElement()
/findElements()
y no se puede construir directamente.
El objeto Element
representa un elemento en la p¨¢gina web y proporciona m¨¦todos para interactuar con ¨¦l.
Los siguientes m¨¦todos son compatibles con el objeto "Element".
²Ñ¨¦³Ù´Ç»å´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
---|---|
getAttribute(name) |
Devuelve una cadena de valor de atributo del atributo del elemento (o devuelve null si no se encontr¨® el atributo especificado).±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: name - (cadena) Nombre del atributo. |
getProperty(nombre) |
Devuelve una cadena de valor de propiedad de la propiedad del elemento (o devuelve null si no se encontr¨® la propiedad especificada).±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: nombre - (cadena) Nombre de la propiedad. |
getText() |
Devuelve una cadena de valor de texto del elemento texto. |
click() |
Haga clic en un elemento. |
clear() |
Borrar el contenido de un elemento editable. |
sendKeys(keys) |
Enviar claves. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: keys - (cadena) Claves para enviar. |
El objeto Cookie
es devuelto por el m¨¦todo del objeto Browser
getCookies()
y se pasa al m¨¦todo addCookie()
.
Si bien el objeto Cookie
no tiene ning¨²n m¨¦todo, puede contener las siguientes propiedades:
Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
---|---|---|
nombre | cadena | Nombre de la cookie. |
valor | cadena | Valor de la cookie. |
ruta | cadena | Ruta para la cual la cookie es v¨¢lida. El valor predeterminado es "/" si se omite al agregar una cookie. |
dominio | cadena | Dominio en el que la cookie es visible. El valor predeterminado es?el dominio URL del documento activo del contexto de ²Ô²¹±¹±ð²µ²¹³¦¾±¨®²Ô actual de la sesi¨®n si se omite al agregar una cookie. |
secure | boolean | Indica si la cookie es segura. El valor predeterminado es "falso" si se omite al agregar una cookie. |
httpOnly | booleano | Indica si la cookie es solo HTTP. El valor predeterminado es "falso" si se omite al agregar una cookie. |
expiry | integer | Tiempo de caducidad de la cookie (en segundos desde la ¨¦poca Unix). No se debe configurar si se omite al agregar una cookie. |
sameSite | string | El atributo sameSite de la cookie, que controla si la cookie debe restringirse a un contexto propio o del mismo sitio.Se puede establecer en? "Lax" ?o?"Estricto " .El valor predeterminado es "Ninguno" si se omite al agregar una cookie. |
El objeto Alert
representa una alerta de p¨¢gina web, lo devuelve el m¨¦todo Browser
del objeto getAlert()
y no se puede construir directamente.
El objeto Alert
contiene la propiedad text
con el texto de la alerta (o null
si no hay alertas).
Los siguientes m¨¦todos son compatibles con el objeto "Alert".
²Ñ¨¦³Ù´Ç»å´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
---|---|
accept() |
Aceptar la alerta. |
dismiss() |
Descartar la alerta. |
El objeto Resultado
contiene estad¨ªsticas de sesi¨®n y es devuelto por el m¨¦todo getResult()
del objeto Browser
.
Normalmente, el objeto Resultado
se codifica y se devuelve desde el script, y luego se analiza en valores de elementos dependientes mediante el preprocesamiento.
Si bien el objeto "Resultado" no tiene ning¨²n m¨¦todo, puede contener las siguientes propiedades.
Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | ||
---|---|---|---|---|
»å³Ü°ù²¹³¦¾±¨®²Ô | string | Duraci¨®n de la sesi¨®n desde la creaci¨®n de la sesi¨®n hasta la recuperaci¨®n del resultado. | ||
error | objeto | Informaci¨®n de error. | ||
http_status | integer | Estado HTTP devuelto por WebDriver (o 0 si no hay errores de WebDriver). | ||
error_code | cadena | Error devuelto por WebDriver (o cadena vac¨ªa si no hay errores de WebDriver). | ||
mensaje | cadena | Mensaje de error de WebDriver (o cadena vac¨ªa si no hay errores de WebDriver). | ||
datos_rendimiento | objeto | Estad¨ªsticas de rendimiento. | ||
summary | objeto | Resumen de rendimiento. | ||
²Ô²¹±¹±ð²µ²¹³¦¾±¨®²Ô | objeto | Resumen de ²Ô²¹±¹±ð²µ²¹³¦¾±¨®²Ô. | ||
recurso | objeto | Resumen de recursos. | ||
detalles | matriz de objetos | Estad¨ªsticas de rendimiento despu¨¦s de cada operaci¨®n que podr¨ªa haber resultado en la ²Ô²¹±¹±ð²µ²¹³¦¾±¨®²Ô. | ||
mark | string | (opcional) Marca de instant¨¢nea de rendimiento especificada con el m¨¦todo collectPerfEntries() . |
||
²Ô²¹±¹±ð²µ²¹³¦¾±¨®²Ô | objeto | Estad¨ªsticas de ²Ô²¹±¹±ð²µ²¹³¦¾±¨®²Ô. | ||
recurso | objeto | Resumen de recursos para este paso. | ||
usuario | matriz de objetos | Matriz de estad¨ªsticas de tipo de marca/medida. | ||
marcas | matriz de objetos | ?ndices de instant¨¢neas de rendimiento marcados. | ||
nombre | cadena | Nombre de la marca de instant¨¢nea de rendimiento. | ||
index | integer | ?ndice de instant¨¢nea de rendimiento en la matriz de detalles. |