as type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace as in tests, or needs partial test data.shoehorn lets you pass partial data in tests while keeping TypeScript happy. It replaces as assertions with type-safe alternatives.
Test code only. Never use shoehorn in production code.
\nProblems with as in tests:
as unknown as Type) for intentionally wrong datanpm i @total-typescript/shoehorn\nBefore:
\ntype Request = {\n body: { id: string };\n headers: Record<string, string>;\n cookies: Record<string, string>;\n // ...20 more properties\n};\n\nit(\"gets user by id\", () => {\n // Only care about body.id but must fake entire Request\n getUser({\n body: { id: \"123\" },\n headers: {},\n cookies: {},\n // ...fake all 20 properties\n });\n});\nAfter:
\nimport { fromPartial } from \"@total-typescript/shoehorn\";\n\nit(\"gets user by id\", () => {\n getUser(\n fromPartial({\n body: { id: \"123\" },\n }),\n );\n});\nas Type → fromPartial()Before:
\ngetUser({ body: { id: \"123\" } } as Request);\nAfter:
\nimport { fromPartial } from \"@total-typescript/shoehorn\";\n\ngetUser(fromPartial({ body: { id: \"123\" } }));\nas unknown as Type → fromAny()Before:
\ngetUser({ body: { id: 123 } } as unknown as Request); // wrong type on purpose\nAfter:
\nimport { fromAny } from \"@total-typescript/shoehorn\";\n\ngetUser(fromAny({ body: { id: 123 } }));\n| Function | \nUse case | \n
|---|---|
fromPartial() | \nPass partial data that still type-checks | \n
fromAny() | \nPass intentionally wrong data (keeps autocomplete) | \n
fromExact() | \nForce full object (swap with fromPartial later) | \n
Gather requirements - ask user:
\nas assertions causing problems?Install and migrate:
\nnpm i @total-typescript/shoehornas assertions: grep -r \" as [A-Z]\" --include=\"*.test.ts\" --include=\"*.spec.ts\"as Type with fromPartial()as unknown as Type with fromAny()@total-typescript/shoehorn