# 要素を検索

ノードタイプ `browser_getElementRef`

## 機能

要素を特定し、後続の要素の操作で使用するハンドルを返します。

## デスクトップクライアントでの設定

![デスクトップクライアントでの「要素を検索」の設定](/assets/get-element-ref.507c5f89a6f9ade4a4801cba6300184b1c44412623919cbd6614b4a20b53e5b6.0538f3a9.webp)

MoreLogin デスクトップクライアント V2.73.101 の英語インターフェースで撮影しました。

## 入力

これらのフィールドは `data.browserUi.inputs` に置きます。

| フィールド | 型または値 | スキーマで必須 | 実行時の既定値 | 説明と制約 |
|  --- | --- | --- | --- | --- |
| `selectorType` | `"selector"` / `"element"` / `"frame"`（変数参照をサポート） | いいえ | `"selector"` | 対象の取得元。エディターの初期値：`"selector"` |
| `frame` | `string` | いいえ | — | iframe |
| `element` | `string` | いいえ | — | 要素の参照 |
| `selectorRadio` | `"CSS"` / `"XPath"`（変数参照をサポート） | いいえ | `"CSS"` | セレクターの種類。エディターの初期値：`"CSS"` |
| `selector` | `string` | いいえ | — | セレクター |
| `outputRange` | `"single"` / `"all"`（変数参照をサポート） | いいえ | `"single"` | 複数の要素オブジェクトが一致した場合。エディターの初期値：`"single"` |
| `serialType` | `"fixed"` / `"randomInterval"`（変数参照をサポート） | いいえ | `"fixed"` | 複数の要素オブジェクトが一致した場合。エディターの初期値：`"fixed"` |
| `serial` | `WorkflowNumber` | いいえ | `1` | 要素のインデックス。整数、解決後の最小値：1。エディターの初期値：`1` |
| `serialMin` | `WorkflowNumber` | いいえ | — | 最小インデックス。整数、解決後の最小値：1 |
| `serialMax` | `WorkflowNumber` | いいえ | — | 最大インデックス。整数、解決後の最小値：1 |
| `type` | `"object"`（変数参照をサポート） | いいえ | `"object"` | 出力の種類。エディターの初期値：`"object"` |


## モードごとの要件と制限

- このノードは、実在する要素の参照を検索して返します。この参照は、同じ実行内、または同じエポック内のデバッグでのみ再利用できます。
- 検証コード：`RPA_NODE_INPUT_INVALID`


## 入力の参照

| フィールド | 許可される形式 |
|  --- | --- |
| `selectorType` | `literal`, `template` |
| `frame` | `literal`, `template` |
| `element` | `literal`, `template` |
| `selectorRadio` | `literal`, `template` |
| `selector` | `literal`, `template` |
| `outputRange` | `literal`, `template` |
| `serialType` | `literal`, `template` |
| `serial` | `literal`, `numericExpression` |
| `serialMin` | `literal`, `numericExpression` |
| `serialMax` | `literal`, `numericExpression` |
| `type` | `literal`, `template` |


## 出力

**モード** `outputRange` `eq` `"single"`

| 出力フィールド | 型または値 |
|  --- | --- |
| `element` | `ElementRef` |
| `matchedCount` | `number` |


**モード** `outputRange` `eq` `"all"`

| 出力フィールド | 型または値 |
|  --- | --- |
| `element` | array<`ElementRef`> |
| `matchedCount` | `number` |


公開されているフィールドは、`${nodeId.data.field}` として参照します。

## JSON の例

ワークフローの `nodes` 配列、または別のノードの `blocks` に入れる完全なノードオブジェクトです。

```json
{
  "id": "find_button",
  "type": "browser_getElementRef",
  "data": {
    "title": "Find the submit button",
    "browserAction": "getElementRef",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "button[type=submit]",
        "outputRange": "single",
        "serialType": "fixed",
        "serial": 1,
        "type": "object"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[ノードカタログに戻る](/ja/browser-rpa/nodes)