‘unknown’ vs. ‘any’

by

You can read more about unknown in the PR or the RC announcement, but the gist of it is:

[..] unknown which is the type-safe counterpart of any. Anything is assignable to unknown, but unknown isn’t assignable to anything but itself and any without a type assertion or a control flow based narrowing. Likewise, no operations are permitted on an unknown without first asserting or narrowing to a more specific type.

A few examples:

let vAny: any = 10;          // We can assign anything to any
let vUnknown: unknown =  10; // We can assign anything to unknown just like any 


let s1: string = vAny;     // Any is assignable to anything 
let s2: string = vUnknown; // Invalid; we can't assign vUnknown to any other type (without an explicit assertion)

vAny.method();     // Ok; anything goes with any
vUnknown.method(); // Not ok; we don't know anything about this variable

The suggested usage is:

There are often times where we want to describe the least-capable type in TypeScript. This is useful for APIs that want to signal “this can be any value, so you must perform some type of checking before you use it”. This forces users to safely introspect returned values.

More Related Contents:

  1. How to ‘map’ a Tuple to another Tuple type in Typescript 3.0
  2. Typescript derive union type from tuple/array values
  3. How do I convert a string to enum in TypeScript?
  4. Typescript: deep keyof of a nested object
  5. How does interfaces with construct signatures work?
  6. Typescript ReferenceError: exports is not defined
  7. error TS2339: Property ‘x’ does not exist on type ‘Y’
  8. Get properties of a class
  9. Jest + Typescript + Absolute paths (baseUrl) gives error: Cannot find module
  10. How to remove index signature using mapped types
  11. typescript template literal as interface key
  12. What does “keyof typeof” mean in TypeScript?
  13. TypeScript error TS1005: ‘;’ expected (II)
  14. Difference between extending and intersecting interfaces in TypeScript?
  15. Is there an option to make spreading an object strict?
  16. Circular Type References in TypeScript
  17. ‘compile-time’ way to get all property names defined interface
  18. TypeScript: Why can’t I assign a valid field of an object with type { a: “a”, b: “b” }
  19. typescript restrict count of object’s properties
  20. TypeScript keyof returning specific type
  21. Why is never assignable to every type?
  22. Generating typescript declaration files from javascript
  23. Is there an alternative to Partial to accept only fields from another type and nothing else?
  24. TypeScript sorting an array
  25. Angular 2 ngModel in child component updates parent component property
  26. How to extend the ‘Window’ typescript interface
  27. Getting the return type of a function which uses generics
  28. How to make “handler” lookup for “dispatcher” style function be typed correctly
  29. How to place a dynamic component in a container
  30. Modules vs. Namespaces: What is the correct way to organize a large typescript project?

Leave a Comment