migrate-to-shoehorn
將 TypeScript 測試遷移至 Shoehorn
TypeScript 測試常使用不安全的 `as` 斷言來偽造大型物件。此技能可將其遷移至型別安全的 shoehorn 輔助函式,同時保持自動完成和型別檢查的正常運作。
下載技能 ZIP
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
開啟並開始使用
測試它
正在使用「migrate-to-shoehorn」。 getUser({ body: { id: '123' } } as Request);
預期結果:
遷移後:getUser(fromPartial({ body: { id: '123' } }));並從 @total-typescript/shoehorn 加入對應的 import。
正在使用「migrate-to-shoehorn」。 getUser({ body: { id: 123 } } as unknown as Request);
預期結果:
遷移後:getUser(fromAny({ body: { id: 123 } }));並從 @total-typescript/shoehorn 加入對應的 import。
安全審計
低風險All 37 static findings are false positives. The 'backtick execution' detections are Markdown code fences around TypeScript examples. The 'weak cryptographic algorithm' and 'system reconnaissance' flags are pattern false-positives from prose matching. The skill is benign documentation that guides migration of test code to use @total-typescript/shoehorn. No malicious intent detected.
低風險問題 (1)
風險因素
⚙️ 外部命令 (24)
品質評分
你能建構什麼
遷移測試中的大型 mock 物件
使用 fromPartial() 取代冗長的大型 TypeScript 型別偽造物件,僅傳遞必要的屬性。
取代不安全的雙重 as 斷言
將 `as unknown as Type` 模式轉換為 fromAny(),用於錯誤測試情境。
標準化測試資料輔助函式
在整個程式碼庫的測試套件中一致地採用 shoehorn,以提升型別安全性。
試試這些提示
Find all test files using `as Type` assertions and migrate them to use fromPartial() from @total-typescript/shoehorn.
Replace all `as unknown as Type` patterns in my test files with fromAny() from @total-typescript/shoehorn.
I have test files that fake large Request objects with 20+ properties. Migrate them to use fromPartial() so I only specify the properties I need.
Audit my test suite for all `as` assertions, install @total-typescript/shoehorn, and migrate every occurrence to the appropriate shoehorn helper.
最佳實務
- 對於僅有部分屬性與測試相關的大型物件,使用 fromPartial()
- 僅在刻意傳遞錯誤型別的資料以進行錯誤測試時,才使用 fromAny()
- 將 shoehorn 的使用限制在測試檔案中,絕不用於正式環境程式碼
- 遷移後執行型別檢查,以確認型別安全性仍獲得保留
避免
- 在正式環境的原始碼中使用 shoehorn 輔助函式
- 未確認型別檢查仍通過便進行遷移
- 在 fromPartial() 即可滿足需求時卻使用 fromAny(),從而失去型別安全性的優勢
- 遺留部分 `as` 斷言未遷移,造成測試模式不一致