TypeScript TS2339: Property 'X' does not exist on type 'Y'

What causes this error

TS2339 fires when property-access syntax (obj.prop or obj['prop']) targets a property the compiler can't find on the receiver's type. For unions, the property must exist on every member. For interfaces, the property must be declared. For unknown, no property access is allowed without narrowing. The compiler's apparentType + getPropertyOfType path determines what's available.

How to fix it

1. 01

   step 1

   Read the receiver's type from the error

   TS2339 names the type that lacks the property. Hover the variable in your IDE to confirm. The fix depends on whether the type is genuinely missing the property or is too wide.

   Property 'role' does not exist on type 'User'.
     Type: { id: number; name: string }

   Copy
2. 02

   step 2

   If it's a union type, narrow with a discriminator

   Most common cause: the variable is a discriminated union and you accessed a property only some branches have. Narrow with the discriminator field first.

   type Event =
     | { kind: 'click'; x: number; y: number }
     | { kind: 'key'; key: string }
   
   function handle(e: Event) {
     // TS2339: 'x' does not exist on type 'Event'
     console.log(e.x)
   }
   
   // Fix
   function handle(e: Event) {
     if (e.kind === 'click') {
       console.log(e.x, e.y)  // narrowed to click branch
     }
   }

   Copy
3. 03

   step 3

   If the type is genuinely missing the property, update it

   If you control the type definition and the property is real, add it. If it's an external library type, augment the module declaration or check for a newer @types version.

   // Update your interface
   interface User {
     id: number
     name: string
     role: 'admin' | 'user'  // add it
   }
   
   // Or augment external types in a .d.ts
   declare module 'react' {
     interface CSSProperties {
       '--my-custom-var'?: string
     }
   }

   Copy
4. 04

   step 4

   For unknown, validate before access

   If the variable is typed 'unknown' (e.g., from JSON.parse), TypeScript blocks all property access until you validate. Use a type predicate or schema validation.

   function isUser(x: unknown): x is User {
     return typeof x === 'object' && x !== null && 'id' in x && 'name' in x
   }
   
   const data: unknown = JSON.parse(raw)
   if (isUser(data)) {
     console.log(data.name)  // OK after narrowing
   }

   Copy
5. 05

   step 5

   For Record types, use bracket notation cautiously

   obj['key'] on a Record<string, unknown> returns unknown. Prefer typed access via Pick or Omit, or use 'in' check before access.

   function getValue(obj: Record<string, unknown>, key: string) {
     if (key in obj) {
       return obj[key]  // unknown, but accessible
     }
     return undefined
   }

   Copy
6. 06

   step 6

   Check for 'never' types

   If the receiver is 'never', no property exists. This often means a discriminated-union check has narrowed too far - usually a switch with all cases handled. Add a default branch or check the narrowing logic.

   function exhaust(x: 'a' | 'b'): string {
     if (x === 'a') return 'A'
     if (x === 'b') return 'B'
     // x is 'never' here - if you access x.something, TS2339
     throw new Error('unreachable')
   }

   Copy