typescript-satisfies-operator

The TypeScript satisfies operator validates an expression against a type without altering its inferred type, unlike colon annotations which can widen literal types during assignment. This preserves narrow types for better autocompletion.

To validate a configuration object while preserving literal types in TypeScript, apply the satisfies operator to ensure all required properties are present and correctly typed without widening the initial inferred values.

TypeScript widens literal types with colon annotations because it explicitly assigns the broader declared type to the variable, discarding the narrow specific values initially provided. Use satisfies to prevent this unwanted widening behavior.

Type widening is when TypeScript generalizes a specific literal value to a broader type. The satisfies operator solves this by checking shape compatibility against a target type while retaining the original narrow literal types for strict type checking.

Use the satisfies operator for type validation when you need to ensure an object matches a specific shape or interface, but still want the compiler to retain the exact literal types of your initial values for autocompletion.