Áú»¢¶Ä²©

Esta es una traducci¨®n de la p¨¢gina de documentaci¨®n original en espa?ol. Ay¨²danos a mejorarla.

2 Objetos JavaScript de m¨¦trica de navegador

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô general

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.

Elemento

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.

Galleta

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.

Alerta

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.

Resultado

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.