# Passar o mouse sobre o elemento

Tipo de nó: `browser_passingElement`

## O que faz

Move o ponteiro sobre um elemento para acionar o comportamento de hover dele.

## Configuração no cliente desktop

![Configuração do nó "Passar o mouse sobre o elemento" no cliente desktop](/assets/passing-element.04c831390f8be8d678dcfc3b8e003b6ef9d9fc15337d263f589560d64fa4f16b.0538f3a9.webp)

Captura de tela feita na interface em inglês do MoreLogin Desktop V2.73.101.

## Entradas

Estes campos ficam em `data.browserUi.inputs`.

| Campo | Tipo ou valores | Obrigatório no esquema | Padrão de execução | Descrição e limites |
|  --- | --- | --- | --- | --- |
| `selectorType` | `"selector"` / `"element"` / `"frame"` (aceita referências de variáveis) | Não | `"selector"` | Origem do elemento. Valor inicial no editor: `"selector"` |
| `frame` | `string` | Não | — | Variável de iframe |
| `element` | `string` | Não | — | Variável de elemento |
| `selectorRadio` | `"CSS"` / `"XPath"` (aceita referências de variáveis) | Não | `"CSS"` | Tipo de seletor. Valor inicial no editor: `"CSS"` |
| `selector` | `string` | Não | — | Seletor |
| `serialType` | `"fixed"` / `"randomInterval"` (aceita referências de variáveis) | Não | `"fixed"` | Quando vários objetos de elemento corresponderem. Valor inicial no editor: `"fixed"` |
| `serial` | `WorkflowNumber` | Não | `1` | Índice do elemento; inteiro; mínimo após a resolução: 1. Valor inicial no editor: `1` |
| `serialMin` | `WorkflowNumber` | Não | — | Índice mínimo; inteiro; mínimo após a resolução: 1 |
| `serialMax` | `WorkflowNumber` | Não | — | Índice máximo; inteiro; mínimo após a resolução: 1 |
| `postWaitMs` | `WorkflowNumber` | Não | `500` | Espera após a conclusão (ms); mínimo após a resolução: 0. Valor inicial no editor: `500` |


## Requisitos de modo e limites

- **Regras de localização:** selectorType=selector exige selector; frame exige frame+selector; element exige uma referência ElementRef de um nó anterior. serial começa em 1. randomInterval usa serialMin/serialMax, e o mínimo não pode ser maior que o máximo. Primeiro, o nó aguarda até que o seletor corresponda a elementos e, depois, escolhe o índice uma única vez: o limite superior do intervalo fica restrito ao número real de correspondências. Se um índice fixo ou o limite inferior do intervalo for maior que o número de correspondências, ELEMENT_NOT_FOUND (reason=range, details.field é serial ou serialMin) será retornado imediatamente, sem nenhuma interação com a página.
- Código de validação: `RPA_NODE_INPUT_INVALID`


## Referências de entrada

| Campo | Formas permitidas |
|  --- | --- |
| `selectorType` | `literal`, `template` |
| `frame` | `literal`, `template` |
| `element` | `literal`, `template` |
| `selectorRadio` | `literal`, `template` |
| `selector` | `literal`, `template` |
| `serialType` | `literal`, `template` |
| `serial` | `literal`, `numericExpression` |
| `serialMin` | `literal`, `numericExpression` |
| `serialMax` | `literal`, `numericExpression` |
| `postWaitMs` | `literal`, `numericExpression` |


## Saídas

| Campo de saída | Tipo ou valores |
|  --- | --- |
| `tabId` | `string` |
| `element` | `ElementRef` |
| `isHovered` | `true` |


Referencie os campos publicados como `${nodeId.data.field}`.

## Exemplo em JSON

Um objeto de nó completo para o array `nodes` de um fluxo ou para os `blocks` de outro nó.

```json
{
  "id": "hover_menu",
  "type": "browser_passingElement",
  "data": {
    "title": "Hover over the account menu",
    "browserAction": "passingElement",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "#account-menu",
        "postWaitMs": 500
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[Voltar ao catálogo de nós](/pt/browser-rpa/nodes)