環境準備與 ApiServer

在開始編寫您的第一個 Playwright 腳本之前，請確保按照以下步驟配置好開發環境。

---

步驟 1: 開啟候鳥 ApiServer

Playwright 並不直接與候鳥客戶端通訊，而是通過一個輕量級的中間件 ApiServer.exe 進行交互。

1. 打開候鳥瀏覽器的安裝根目錄。
2. 找到 ApiServer.exe 雙擊運行。
3. 您會看到一個黑色的命令提示符窗口，顯示 [INFO] Http Server started on 127.0.0.1:8186。
4. 注意：在自動化過程中，請保持此窗口開啟，不要關閉。

---

步驟 2: 選擇您的開發語言

根據您的偏好選擇一種語言進行環境配置：

1. Node.js (JavaScript / TypeScript)

推薦給 Web 前端開發者，原生支持效果最好。

1. 安裝 Node.js (LTS 版本)。
2. 在您的項目目錄執行：

   npm init -y
   npm install playwright axios

2. Python

推薦給數據分析師、爬蟲工程師及自動化測試人員。

1. 安裝 Python 3.8+。
2. 創建虛擬環境並安裝依賴：

   pip install playwright requests
   playwright install-deps chromium  # 僅安裝必要的系統依賴

3. Java

推薦給企業級應用開發者。

1. 安裝 JDK 11+ 和 Maven。
2. 在 pom.xml 中添加依賴：

   <dependency>
     <groupId>com.microsoft.playwright</groupId>
     <artifactId>playwright</artifactId>
     <version>1.xx.x</version>
   </dependency>

---

步驟 3: 驗證連接

在終端（命令提示符）中手動測試 ApiServer 是否響應：

curl http://127.0.0.1:8186/api/v1/browser/list

若返回 {"code":0,"data":[],"message":"success"}，說明環境已完全就緒。

---

IMPORTANT

不要下載額外的瀏覽器內核 普通 Playwright 會要求運行 playwright install 來下載 Chrome/Firefox。在候鳥自動化中，我們使用候鳥內建的高性能內核，因此您不需要下載這些內核，從而節省數百 MB 的空間。

---

TIP

環境配置妥當後，立即前往 快速開始 跑通您的首個接管腳本！