Function overload trong TypeScript hoạt động thế nào? Khi nào nên dùng?

Ví dụ

main.ts · sửa được▶ Chạy

function parse(x: string): number; function parse(x: number): string; function parse(x: string | number): number | string { return typeof x === "string" ? Number(x) : String(x); } console.log(parse("42") + 1); // number 43 console.log(parse(42) + 1); // string "421"

• Chỉ các overload signature là public API; implementation signature (string | number) không gọi trực tiếp được.
• Thứ tự quan trọng: đặt signature cụ thể trước, tổng quát sau.
• Cũng áp dụng cho method trong class và declare function trong file .d.ts.

Khi nào không nên

• Nếu chỉ khác nhau về kiểu tham số mà trả về giống nhau, dùng union: (x: string | number): void.
• Nếu trả về phụ thuộc kiểu tham số theo quy luật, dùng generic hoặc conditional type, tránh viết nhiều overload lặp lại.
• Overload không kiểm tra thân hàm: implementation có thể trả sai kiểu mà vẫn compile nếu khớp signature rộng.