TypeScript: No overload matches this call w handlerze zdarzeń
Poradnik techniczny · Kacper Bernecki
Komunikat TS2769 pojawia się przy wywołaniu funkcji z kilkoma sygnaturami, mimo pozornie zgodnych argumentów. Żadna z dostępnych przeciążeń nie pasuje do całego zestawu przekazanych argumentów jednocześnie.
Jak ustalić źródło błędu
W komunikacie kompilatora przeczytaj błąd dla każdego overload zamiast analizować tylko pierwszy wiersz.
Sprawdź union typów, opcjonalność parametrów oraz czy handler React otrzymuje event zamiast oczekiwanej wartości.
Co zrobić krok po kroku
1. Zawęź typ wejścia przez warunek lub type guard przed wywołaniem przeciążonej funkcji.
2. Jeżeli to Twoje API, dodaj właściwą implementację obsługującą union lub wspólne przeciążenie zgodne z rzeczywistymi danymi.
Jak sprawdzić wynik
Kompilacja przechodzi bez as any, a testy obejmują każdy dopuszczalny typ argumentu.
Czego nie robić
Nie używaj bezwarunkowego as unknown as, bo ukrywa niezgodność i może prowadzić do wyjątku runtime.