遠端自動化（Socket 伺服器）

概述

WebRunner 包含一個多執行緒 TCP Socket 伺服器，用於遠端自動化控制。 這使得跨語言支援成為可能 – 任何支援 TCP Socket 的語言 （Java、C#、Go 等）都可以向 WebRunner 發送自動化指令。

啟動伺服器

from je_web_runner import start_web_runner_socket_server

server = start_web_runner_socket_server(host="localhost", port=9941)

伺服器在背景常駐執行緒中啟動，立即準備接受連線。

客戶端連線範例

import socket
import json

sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
sock.connect(("localhost", 9941))

# 發送 JSON 格式的動作（UTF-8 編碼）
actions = [
    ["WR_get_webdriver_manager", {"webdriver_name": "chrome"}],
    ["WR_to_url", {"url": "https://example.com"}],
    ["WR_quit"]
]
sock.send(json.dumps(actions).encode("utf-8"))

# 接收結果（以 "Return_Data_Over_JE\n" 結尾）
response = sock.recv(4096).decode("utf-8")
print(response)

# 關閉伺服器
sock.send("quit_server".encode("utf-8"))

協定

屬性	值
預設主機	localhost
預設埠號	9941
編碼	UTF-8
訊息格式	JSON 動作陣列
最大接收緩衝	8192 bytes
回應終止符	Return_Data_Over_JE
關閉指令	quit_server
執行緒模型	多執行緒（socketserver.ThreadingMixIn）