Typescript primitive types: any difference between the types "number" and "Number" (is TSC case-insensitive)?
To augment Ryan's answer with guidance from the TypeScript Do's and Don'ts:
Don't ever use the types
Number
,String
,Boolean
,Symbol
, orObject
These types refer to non-primitive boxed objects that are almost never used appropriately in JavaScript code./* WRONG */ function reverse(s: String): String;
Do use the types
number
,string
,boolean
, andsymbol
./* OK */ function reverse(s: string): string;
JavaScript has the notion of primitive types (number, string, etc) and object types (Number, String, etc, which are manifest at runtime). TypeScript types number
and Number
refer to them, respectively. JavaScript will usually coerce an object type to its primitive equivalent, or vice versa:
var x = new Number(34);
> undefined
x
> Number {}
x + 1
> 35
The TypeScript type system rules deal with this (spec section 3.7) like this:
For purposes of determining subtype, supertype, and assignment compatibility relationships, the Number, Boolean, and String primitive types are treated as object types with the same properties as the ‘Number’, ‘Boolean’, and ‘String’ interfaces respectively.