# Cuộn trang

Loại nút `browser_scrollPage`

## Chức năng

Cuộn trang hoặc phần tử đích để hiển thị thêm nội dung.

## Cấu hình trong ứng dụng máy tính

![Cấu hình nút "Cuộn trang" trong ứng dụng máy tính](/assets/scroll-page.1ac84f4e233508f136de9c01caabf9b64cb730bf47ee6f8911e401a5b1461cfe.0538f3a9.webp)

Ảnh chụp từ giao diện tiếng Anh của MoreLogin Desktop V2.73.101.

## Đầu vào

Các trường này nằm trong `data.browserUi.inputs`.

| Trường | Kiểu hoặc giá trị | Bắt buộc theo schema | Giá trị mặc định khi thực thi | Mô tả và giới hạn |
|  --- | --- | --- | --- | --- |
| `rangeType` | `"window"` / `"selector"` (hỗ trợ tham chiếu biến) | Không | `"window"` | Phạm vi cuộn. Giá trị ban đầu trong trình chỉnh sửa: `"window"` |
| `selectorRadio` | `"CSS"` / `"XPath"` (hỗ trợ tham chiếu biến) | Không | `"CSS"` | Loại bộ chọn. Giá trị ban đầu trong trình chỉnh sửa: `"CSS"` |
| `selector` | `string` | Không | — | Bộ chọn |
| `serial` | `WorkflowNumber` | Không | `1` | Chỉ mục phần tử; số nguyên; tối thiểu sau khi phân giải: 1. Giá trị ban đầu trong trình chỉnh sửa: `1` |
| `scrollType` | `"distance"` / `"position"` (hỗ trợ tham chiếu biến) | Không | `"distance"` | Cuộn theo. Giá trị ban đầu trong trình chỉnh sửa: `"distance"` |
| `distance` | `WorkflowNumber` | Không | — | Khoảng cách cuộn (px); tối thiểu sau khi phân giải: 0 |
| `position` | `"top"` / `"middle"` / `"bottom"` (hỗ trợ tham chiếu biến) | Không | `"bottom"` | Vị trí đích. Giá trị ban đầu trong trình chỉnh sửa: `"bottom"` |
| `type` | `"moment"` / `"smooth"` (hỗ trợ tham chiếu biến) | Không | `"moment"` | Chế độ cuộn. Giá trị ban đầu trong trình chỉnh sửa: `"moment"` |
| `randomWheelDistance` | `array` / `object` (hỗ trợ tham chiếu biến) | Không | — | Phạm vi khoảng cách cuộn mỗi bước (px); mỗi đầu ≥ 1 sau khi phân giải (cho phép số thập phân); max ≥ min |
| `randomWheelSleepTime` | `array` / `object` (hỗ trợ tham chiếu biến) | Không | — | Phạm vi thời gian tạm dừng mỗi bước (ms); mỗi đầu ≥ 0 sau khi phân giải (cho phép số thập phân); max ≥ min |
| `postWaitMs` | `WorkflowNumber` | Không | `300` | Thời gian chờ sau khi hoàn tất (ms); tối thiểu sau khi phân giải: 0. Giá trị ban đầu trong trình chỉnh sửa: `300` |


## Yêu cầu theo chế độ và giới hạn

- rangeType=selector yêu cầu selector. scrollType=position dùng position; distance dùng distance. type=smooth dùng các phạm vi ngẫu nhiên cho khoảng cách cuộn và khoảng thời gian giữa các bước.
- Mã lỗi xác thực: `RPA_NODE_INPUT_INVALID`


**`scrollType` `eq` `"distance"`**

- Bắt buộc: `distance`
- Trường này là bắt buộc trong trình chỉnh sửa và không có giá trị mặc định. Nếu bỏ qua trường này, thao tác ghi và xác thực trả về RPA_NODE_INPUT_INVALID (reason=required), và lượt chạy cũng bị từ chối theo cách tương tự trước khi bắt đầu.
- Mã lỗi xác thực: `RPA_NODE_INPUT_INVALID`


**`type` `eq` `"smooth"`**

- Bắt buộc: `randomWheelDistance`, `randomWheelSleepTime`
- Trường này là bắt buộc trong trình chỉnh sửa và không có giá trị mặc định. Nếu bỏ qua trường này, thao tác ghi và xác thực trả về RPA_NODE_INPUT_INVALID (reason=required), và lượt chạy cũng bị từ chối theo cách tương tự trước khi bắt đầu.
- Mã lỗi xác thực: `RPA_NODE_INPUT_INVALID`


## Tham chiếu đầu vào

| Trường | Dạng được phép |
|  --- | --- |
| `rangeType` | `literal`, `template` |
| `selectorRadio` | `literal`, `template` |
| `selector` | `literal`, `template` |
| `serial` | `literal`, `numericExpression` |
| `scrollType` | `literal`, `template` |
| `distance` | `literal`, `numericExpression` |
| `position` | `literal`, `template` |
| `type` | `literal`, `template` |
| `randomWheelDistance` | `literal`, `numericExpression` |
| `randomWheelSleepTime` | `literal`, `numericExpression` |
| `postWaitMs` | `literal`, `numericExpression` |


## Đầu ra

| Trường đầu ra | Kiểu hoặc giá trị |
|  --- | --- |
| `actualDistance` | `number` |
| `scrollX` | `number` |
| `scrollY` | `number` |
| `scrollHeight` | `number` |
| `viewportHeight` | `number` |
| `isAtBottom` | `boolean` |


Tham chiếu các trường đã công bố dưới dạng `${nodeId.data.field}`.

## Ví dụ JSON

Một đối tượng nút hoàn chỉnh để đặt vào mảng `nodes` của quy trình hoặc vào `blocks` của một nút khác.

```json
{
  "id": "scroll_to_bottom",
  "type": "browser_scrollPage",
  "data": {
    "title": "Scroll to the bottom of the page",
    "browserAction": "scrollPage",
    "browserUi": {
      "inputs": {
        "rangeType": "window",
        "scrollType": "position",
        "position": "bottom",
        "type": "moment",
        "postWaitMs": 300
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[Quay lại danh mục nút](/vi/browser-rpa/nodes)