URL

key: browser.url nhóm: BrowserControl hàm Client A13: URL

Chức năng

Điều hướng tab hiện tại tới một URL và chờ tới trạng thái tải chỉ định (load / domcontentloaded / networkidle / commit). Chọn networkidle khi trang render bằng JS và cần chờ dữ liệu về.

Tham số (3)

Tên trên UI	payloadName	Kiểu	Mặc định	Mô tả
URL	`url`	string	`—`	Chức năng: Địa chỉ trang web cần mở. Nên ghi đủ cả http:// hoặc https://. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: https://example.com. Giải nghĩa: Mở một trang cụ thể. Ví dụ 2: about:blank. Giải nghĩa: Mở trang trắng, dùng khi chỉ cần cửa sổ trống để thao tác sau. Ví dụ 3: ={{$json.url}}. Giải nghĩa: Mở đúng link do bước trước lấy được.
Wait Until	`wait_until`	options (load / domcontentloaded / networkidle / commit)	`load`	Chức năng: Mốc coi như trang đã tải xong trước khi node đi tiếp. Chọn sai mốc là nguyên nhân phổ biến khiến bước sau "không thấy phần tử". Bạn có thể để trống nếu không cần dùng. Ví dụ 1: load. Giải nghĩa: Chờ toàn bộ ảnh và tài nguyên tải xong — chắc chắn nhất, chậm nhất. Ví dụ 2: domcontentloaded. Giải nghĩa: Chờ HTML sẵn sàng, chưa cần ảnh — nhanh, hợp cho trang tĩnh. Ví dụ 3: networkidle. Giải nghĩa: Chờ mạng lặng hẳn — bắt buộc với trang render bằng JavaScript.
Timeout (sec)	`timeout_sec`	string	`60`	Chức năng: Thời gian chờ tối đa tính bằng giây trước khi báo lỗi. Đặt quá ngắn thì workflow gãy oan khi mạng chậm; quá dài thì lỗi thật cũng phải đợi lâu mới biết. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: 5. Giải nghĩa: Thao tác nhanh trên trang nội bộ. Ví dụ 2: 30. Giải nghĩa: Mức cân bằng cho phần lớn trang web công cộng. Ví dụ 3: 120. Giải nghĩa: Trang nặng hoặc thao tác phải chờ xử lý phía máy chủ.

🚩 = bắt buộc. Ô rỗng của tham số tùy chọn sẽ bị loại khỏi payload.inputs — Client tự áp default.

Payload MQTT gửi đi

{
  "version": "great-lotus-pyauto-v1",
  "action": {
    "key": "browser.url",
    "group": "BrowserControl",
    "function": "URL"
  },
  "inputs": {
    "url": {
      "type": "string",
      "value": ""
    },
    "wait_until": {
      "type": "options",
      "value": "load"
    },
    "timeout_sec": {
      "type": "string",
      "value": 60
    }
  },
  "meta": {
    "requestId": "<16 hex>",
    "requestTopic": "WP2_PC176",
    "responseTopic": "RES_WP2_PC176",
    "waitForResponse": true,
    "responseTimeoutSec": 60
  }
}

Publish lên topic bạn nhập ở ô Topic; nếu bật Wait For Response, node chờ Client trả lời trên RES_<topic> với đúng meta.requestId. return: "NG" ⇒ node ném lỗi.

Sinh tự động bởi tools/gen_doc_html.js từ ACTION_SPECS (package n8n-nodes-c12_pyautogui_web@0.1.34) · 2026-07-22 · Đừng sửa tay file này — sửa _notes/ hoặc source rồi chạy lại npm run doc:build.