Get Attribute

Tipo: page-get-attribute · Paquete: Browser v1.0.9 · Salida: string

Lee el valor de un atributo HTML de un elemento. Sirve para extraer datos que no son texto visible: el enlace de descarga de un botón (href), la URL de una imagen (src), un identificador oculto (data-id), o el estado de un elemento (class, disabled).

Cómo funciona

Localiza el elemento por su selector, espera a que exista en la página (no necesita estar visible) y devuelve el valor del atributo cuyo nombre indiques en attribute.

Lee el atributo tal como está en el HTML: un href relativo (/facturas/12.pdf) se devuelve relativo. Download File ya sabe completarlo.
Lee el atributo, no la propiedad viva del elemento: para el valor actual de un campo usa Get Value.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	El elemento del que leer el atributo.
`attribute`	`string`	—	Nombre del atributo HTML. Ej: `href`, `src`, `data-id`, `class`.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`page`	`ZoanPageSession`	—	La sesión de página. Omítela dentro de un `body`; fuera, pasa la variable de la sesión (p. ej. `page = page`).
`timeout`	`number`	`30000`	Máximo en ms a esperar el elemento. Vacío, `0` o negativo: el de la configuración del proyecto o, si no hay, `30000`.

Salida

Devuelve un string con el valor del atributo. Si el elemento no tiene ese atributo, la salida queda vacía (null); un atributo sin valor, como disabled, devuelve "".

Ejemplo

Obtener el enlace de descarga de un documento y bajarlo:

Page Get Attribute   selector = (#enlaceFactura)   attribute = "href"   → output: urlPdf
Download File        url = urlPdf   outputPath = "C:\Facturas"   → output: rutaPdf

Saber si un botón está deshabilitado:

Page Get Attribute   selector = (#btnEnviar)   attribute = "disabled"   → output: deshabilitado
If   condition = deshabilitado != null
 └─ then:
      Log   message = "El envío todavía no está disponible"

Errores comunes

Mensaje	Causa y solución
`'attribute' es obligatorio.`	No indicaste el nombre del atributo.
`Timeout 30000ms exceeded`	El elemento no apareció a tiempo. Revisa el selector o espera antes con Wait For.
`strict mode violation: … resolved to 2 elements`	El selector coincide con varios elementos. Hazlo más específico o agrega un índice.
`'page' debe ser una ZoanPageSession.`	`page` está vacío fuera de un `body`.

Actividades relacionadas

Get Text — leer el texto visible en vez de un atributo.
Get Value — leer el valor de un campo de formulario.
Download File — descargar el archivo de un href.