測試工具功能與運作原理
「WebSocket 測試客戶端」是一個專為開發即時 API 的開發人員、整合工程師、品質保證（QA）人員、運維（Ops）人員，以及任何需要手動連接到公開 WebSocket 端點並傳送文字訊息的用戶而設的工具。
本工具讓您能夠連接到 WebSocket 伺服器、傳送文字訊息，並查看所有已傳送和已接收訊息的詳細記錄。此外，它亦會顯示連線狀態（包括連線開啟與關閉的時間），並提供有關 WebSocket 關閉碼及伺服器所提供原因的詳細資訊。
輸入參數與限制
在使用此工具時，您需要提供以下兩項輸入：
- WebSocket 位址：必須是完整的
ws://或wss://位址。只有當您選擇「連接」時，連線才會開始。此欄位輸入的位址長度上限為 2,048 個字元。 - 留言：準備傳送到 WebSocket 伺服器的文字。您每次只能傳送一條文字訊息，輸入後可按 Ctrl+Enter 或 Command+Enter 傳送。訊息的長度上限為 100,000 個字元。
輸出結果與日誌說明
工具會即時更新並顯示以下輸出資訊：
- 訊息日誌：按時間順序排列的事件與訊息列表。
- 已發送：表示由客戶端傳送的訊息。
- 已收到：表示客戶端接收到的訊息。
- 活動：表示與連線相關的事件。
- 文字：標記文字訊息。
- 二進位訊息：標記二進位訊息，並會顯示以「位元組」為單位的訊息大小。
- 連接到
‹address›：當連線成功開啟時顯示。 - 已關閉，代碼為
‹code›(‹clean›)。原因：‹reason›：當連線關閉時顯示，當中包含關閉碼、屬於「乾淨」或「不乾淨」的關閉狀態，以及伺服器提供的關閉原因。 ‹count›較舊的日誌條目已被刪除，以保持此頁面的回應能力：當日誌累積超過 500 條記錄時，系統會自動移除較舊的條目以維持頁面流暢度。‹count›此預覽中隱藏了更多角色：當單一條目長度超過 20,000 個字元時，系統會截斷顯示並提示此訊息。
- 關閉程式碼：顯示導致 WebSocket 連線關閉的數值代碼。
- 已發送：累計已傳送的訊息總數。
- 已收到：累計已接收的訊息總數。
運作規則與異常處理
為了確保測試過程順利，工具內置了以下規則與錯誤提示機制：
- 連線啟動：連線至 WebSocket 伺服器的程序僅會在您選擇「連接」後開始。在嘗試建立連線期間，工具會顯示「正在連接到
‹address›...」。 - 連線超時：若伺服器未在 10 秒內開啟連線，工具將顯示「伺服器未在 10 秒內開啟連線」。
- 連線失敗：若連線無法建立，工具會提示「連線失敗。檢查位址、憑證、伺服器可用性和瀏覽器存取規則」。
- 位址格式錯誤：若輸入的位址不完整，會顯示「輸入完整的 WebSocket 位址，例如 wss://example.com/socket」。若使用了非
ws://或wss://的協定，則會提示「使用 ws:// 或 wss:// 位址」。 - 長度超限：位址若超過 2,048 個字元，會顯示「該地址異常長。將其保留在 2,048 字元下」。訊息若超過 100,000 個字元，則會提示「該訊息異常大。將其保留在 100,000 字元下」。
- 未連線傳送：在未連接狀態下嘗試傳送訊息，會顯示「發送訊息之前先連接」。
- 日誌上限與清除：訊息日誌最多保留 500 條記錄。單一條目最多顯示 20,000 個字元，超出部分會被截斷。點擊清除日誌只會清除當前顯示的記錄，並不會關閉連線或重設訊息計數。
- 瀏覽器與網絡限制：本工具無法新增自訂握手標頭、繞過憑證錯誤，或覆蓋伺服器的存取規則。同時，它無法顯示網絡層級的片段，亦無法顯示 Ping 和 Pong 控制訊框。
- 關閉原因預設值：若伺服器在關閉連線時未提供具體原因，工具會顯示「沒有提供理由」。
私隱與數據處理說明
此頁面不會向 BroBroGo 上載或儲存任何內容。您所輸入的網址和傳送的訊息，均會由您的瀏覽器直接傳送到您指定的 WebSocket 伺服器。
常見問題
我可以在這裡檢查哪些 WebSocket 資料？
您可以查看瀏覽器公開的每個文字或二進位訊息、其方向、時間和大小，以及最終關閉程式碼、原因和乾淨關閉狀態。瀏覽器頁面無法公開網絡層級片段或 Ping 和 Pong 控制幀。
為什麼即使位址在其他地方有效，連線也會失敗？
在安全頁面上，瀏覽器可能需要 wss://。伺服器也必須接受瀏覽器連線和頁面來源。該用戶端無法新增自訂握手標頭、繞過憑證錯誤或覆蓋伺服器的存取規則。
我可以使用生產資料或敏感資料進行測試嗎？
盡可能使用合成數據。發送前刪除姓名、帳戶詳細資料、法律記錄、財務資訊和健康資訊。訊息將傳送到您選擇的伺服器，其日誌記錄和保留規則不在本頁面的控制範圍內。