不該等到 CI 執行失敗,才發現有東西設定錯了。
在把 TestSprite 接進 CI 之前,先執行 testsprite doctor。它會檢查您的 API 金鑰、網路連線和 CLI 版本是否都設定正確——這樣一個低級的設定問題,就不會偽裝成真正的測試失敗。
內建於您已在使用的同一套 CLI
驗證您的 API 金鑰
在 CI 工作把第一次執行浪費在身分驗證錯誤上之前,testsprite doctor 會先確認您的 TESTSPRITE_API_KEY 已設定且有效。
檢查網路與代理伺服器連線
企業代理伺服器和鎖死的 CI 執行器,可能會悄悄擋掉對外請求。在您在流水線跑到一半才發現之前,doctor 會先確認 CLI 真的能連上 TestSprite。
確認您的 CLI 版本
已安裝版本和流水線預期版本之間的落差,可能會以看起來像產品錯誤的方式失敗。doctor 會在那之前先標記出來。
到哪都能執行
不管您是在本機設定、接一個新的 CI 工作,還是在偵錯為什麼隊友的流水線無法通過身分驗證,檢查方式都一樣。
$ testsprite doctor Checking environment... ✓ API key found and valid ✓ Network access to TestSprite confirmed ✓ CLI version up to date → environment looks good, ready to run tests $ testsprite doctor Checking environment... ✗ TESTSPRITE_API_KEY not set ✗ Network request blocked — check proxy configuration → fix these before running testsprite test run
別讓 CI 替您偵錯設定
一個連測試都還沒碰到就失敗的流水線,什麼都沒測到——它只是很大聲地失敗而已。先執行 testsprite doctor,能把「CI 剛剛為什麼失敗」變成一個兩秒鐘就能回答的問題。
為把 TestSprite 接進 CI 而打造
接上 CI 之前先執行它
把 testsprite doctor 加為流水線的第一個步驟——就在安裝之後、testsprite setup 和任何真正的測試執行之前。
搭配 testsprite setup
用 testsprite setup --from-env --yes --agent <name> 以非互動方式設定憑證,再執行 doctor 確認它們真的能用。
免費且開源
npm install -g @testsprite/testsprite-cli 就能取得 CLI。它採用 Apache-2.0 授權,所以沒有任何東西阻擋您第一次檢查。
機器可讀輸出
加上 --output json,取得您流水線能自動解析並處理的格式化結果。
全球企業信賴
"TestSprite 提供豐富的測試案例生成、清晰的結構和易於閱讀的程式碼。它還支援簡單的線上調試,並能夠透過生成新的測試案例快速擴展。"
"TestSprite 的自動化幫助我們減少了大量的手動工作。開發人員可以更容易地在開發過程早期發現並解決錯誤。"
常見問題
testsprite doctor 實際上檢查什麼?
它會檢查您的 API 金鑰是否已設定且有效、CLI 能不能透過您的網路連上 TestSprite——包括透過代理伺服器——以及您安裝的 CLI 版本是否為最新版。
我該什麼時候執行它?
在安裝完 CLI 之後,以及在任何新的 CI 流水線裡再執行一次,作為第一個步驟——放在 testsprite setup 或真正的測試執行之前,讓設定問題快速失敗,而不是卡在流水線跑到一半的時候。
這跟直接跑一次測試、看看哪裡壞掉有什麼不同?
由缺少 API 金鑰或網路請求被擋住造成的測試失敗,在您深入研究之前,看起來會跟真正的產品失敗一模一樣。doctor 會在您把一次執行浪費在錯的問題上之前,先把「您的設定壞了」和「您的產品壞了」分開。
它只能在 CI 裡用,還是本機也可以?
兩邊都可以——不管在哪裡都是同一個指令。在您設定的時候先在本機執行一次,再作為 CI 步驟執行一次,這樣流水線環境裡的代理伺服器或憑證問題就不會漏網。
如果它標記出問題,我該怎麼辦?
它會指出問題出在哪裡——缺少 TESTSPRITE_API_KEY、網路路徑被擋住,或 CLI 版本過舊——這樣您就能只修那一個問題,而不必去偵錯一次根本沒機會開始的測試執行。