---

tags: Rapi Document Chinese

---
# Rapi Runner
Rapi Runner是一個命令列介面(Command Line Interface)工具，支援在命令列模式下播放由Rapi Recorder錄製出的測試案例。

## 快速入門
預備工具:
- [Java SE](https://www.oracle.com/java/technologies/javase-downloads.html)

### 步驟1：啟動Selenium Server
1. 下載[Selenium Server](https://www.seleniumhq.org/download/) (已測版本：4.9.0)
<!-- 下載[WebDriver](https://hackmd.io/@rapi/webdriver-zh#Here-are-the-browsers-currently-supported-by-Rapi)，並將其放置於與```selenium-server-{version}.jar```相同目錄下 -->
2. 開啟命令列模式並且切換路徑至```selenium-server-{version}.jar```的目錄
3. 執行

    java -jar selenium-server-{version}.jar standalone --selenium-manager true

### 步驟2：執行Rapi Runner
1. 下載 [Rapi Runner](https://github.com/RapiTest/rapi-runner/releases/) 。
2. 執行```rapi-runner --config {CONFIG_FILE_PATH}```。如下範例，當執行以下設定檔時，所有指定的測試套件中之測試案例都將會透過WebDriver於Chrome上播放。設定檔格式請參閱[Rapi Runner Config Format](https://hackmd.io/@Rapi/rapi-runner-config-file)。

{
    "input": {
        "testSuites": ["YOUR_TESTSUITE_FILE_PATH"]
    },

    "webdriver": {
        "configs": [
            {
                "serverUrl": "http://localhost:4444",
                "type": "selenium",
                "browsers":[
                    {
                        "active": true,
                        "capability": {
                            "browserName": "chrome"
                        }
                    }
                ]
            }
        ]
    }
}

### 步驟3：觀看與解析測試報告
* 觀看測試報告：測試報告檔案將會於設定檔中指定的目錄下被產生，格式可為HTML或JSON，HTML檔案可以瀏覽器開啟觀看，JSON檔案可被其他程式解析與再處理。
* 輸出資料：測試報告中將包含測試案例中區域變數與全域變數最後執行的值，有時候這些資料有助於除錯並且可供其他程式解析與再處理，請參閱測試報告格式。