# 要素データを読み取る

ノードタイプ `browser_getElement`

## 機能

一致した 1 つ以上の要素から、テキスト、HTML、または指定した属性を読み取ります。

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

![デスクトップクライアントでの「要素データを読み取る」の設定](/assets/get-element.82353332a27b2e6642fd4415f67643de4e56d5a746cdd0b78d45b21816b4abc8.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"`。例：`"${locatorType}"`。参照される値は `"CSS"` または `"XPath"` である必要があります。 |
| `selector` | `string` | いいえ | — | セレクター |
| `outputRange` | `"single"` / `"all"`（変数参照をサポート） | いいえ | `"single"` | 複数の要素オブジェクトが一致した場合。エディターの初期値：`"single"` |
| `serialType` | `"fixed"` / `"randomInterval"`（変数参照をサポート） | いいえ | `"fixed"` | 複数の要素オブジェクトが一致した場合。エディターの初期値：`"fixed"` |
| `serial` | `WorkflowNumber` | いいえ | `1` | 要素のインデックス。整数、解決後の最小値：1。エディターの初期値：`1` |
| `serialMin` | `WorkflowNumber` | いいえ | — | 最小インデックス。整数、解決後の最小値：1 |
| `serialMax` | `WorkflowNumber` | いいえ | — | 最大インデックス。整数、解決後の最小値：1 |
| `type` | `"innerText"` / `"innerHTML"` / `"attribute"`（変数参照をサポート） | いいえ | `"innerText"` | 出力の種類。エディターの初期値：`"innerText"` |
| `key` | `string` | いいえ | — | 属性名 / 子要素のセレクター |


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

- **ロケーターのルール**：selectorType=selector では selector が必要です。frame では frame+selector、element では前のノードの ElementRef 参照が必要です。serial は 1 から始まります。randomInterval では serialMin/serialMax を使用し、最小値を最大値より大きくすることはできません。ノードはまず、セレクターが要素に一致するまで待機し、その後インデックスを 1 回だけ選択します。範囲の上限は、実際に一致した数に切り詰められます。固定のインデックスまたは範囲の下限が一致した数より大きい場合は、ただちに ELEMENT_NOT_FOUND（reason=range、details.field は serial または serialMin）が返され、ページは操作されません。
outputRange は single/all のいずれかに限られます。type は innerText/innerHTML/attribute のいずれかに限られ（エディターと同じ。要素オブジェクトには getElementRef、iframe には getFrame を使用します）、type=attribute では key（属性名）が必要です。返されるキーと値は、分岐に応じて単一の値または配列として読み取ってください。このノードは、要素が表示されるのを待機しません。何も見つからない場合はただちに成功し、単一の値は空文字列 ""（all の場合は []）、存在しない属性は "" になります。待機が必要な場合は、先に「要素を待機」を使用してください。
- 検証コード：`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` |
| `key` | `literal`, `template` |


## 出力

**モード** `{"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}`

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


**モード** `{"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}`

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


**モード** `{"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}`

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


**モード** `{"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}`

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


**モード** `{"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}`

| 出力フィールド | 型または値 |
|  --- | --- |
| `attribute` | `string` / `null` |
| `matchedCount` | `number` |


**モード** `{"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}`

| 出力フィールド | 型または値 |
|  --- | --- |
| `attribute` | array<`string` / `null`> |
| `matchedCount` | `number` |


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

## JSON の例

この例では、`.price` に一致する最初の要素のテキストを `data.text` に読み取ります。要素が非同期に読み込まれる場合は、先に「要素を待機」を追加してください。

```json
{
  "id": "read_price",
  "type": "browser_getElement",
  "data": {
    "title": "Read the product price",
    "browserAction": "getElement",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": ".price",
        "outputRange": "single",
        "serialType": "fixed",
        "serial": 1,
        "type": "innerText"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

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