TS2533: Object is possibly null or undefined - in CI

By Kaveh Alemi·Latchkey

A value whose type includes both null and undefined was used without narrowing.

What this error means

Type-checking fails with TS2533 at access on a value typed as T | null | undefined.

src/find.ts(9,5): error TS2533: Object is possibly 'null' or 'undefined'.

Common causes

How to fix it

Narrow both cases

1. A truthy check rules out both null and undefined for object types

if (node) traverse(node)

Default with nullish coalescing

1. Provide a fallback so the value is never null/undefined downstream

const value = maybe ?? fallback

How to prevent it

• Model nullability explicitly and narrow once at the boundary instead of repeatedly asserting.

Frequently asked questions

Related guides

References

• Node.js documentation
• npm CLI documentation
• GitHub Actions documentation