TS2322: Type 'X' is not assignable to type 'Y'

Workarounds

1. 92% success Fix the type at the source (function return type, API response type, etc.)

   function return type, API response type, etc.

   Sources: https://www.typescriptlang.org/docs/handbook/2/everyday-types.html

2. 88% success Use type guards or narrowing to handle union types properly

   if ('field' in obj) { /* obj is narrowed */ }

   Sources: https://www.typescriptlang.org/docs/handbook/2/narrowing.html

3. 80% success Use type assertion (as Type) as a last resort after verifying correctness

   // Only use when you know more than the compiler:
   const event = e as MouseEvent;
   
   // Prefer double assertion for incompatible types (rare):
   const value = input as unknown as TargetType;
   
   // Better: use a type guard instead:
   function isMouseEvent(e: Event): e is MouseEvent {
     return 'clientX' in e;
   }

   Sources: https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#type-assertions