{"id":582,"date":"2016-02-22T21:31:29","date_gmt":"2016-02-22T21:31:29","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/typescript\/?p=582"},"modified":"2019-02-20T10:46:06","modified_gmt":"2019-02-20T17:46:06","slug":"announcing-typescript-1-8-2","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/typescript\/announcing-typescript-1-8-2\/","title":{"rendered":"Announcing TypeScript 1.8"},"content":{"rendered":"

Today we are thrilled to announce the release of TypeScript 1.8. In the TypeScript 1.8 Beta release blog post<\/a>, we highlighted some of the key features that are now available to TypeScript users – how JavaScript in TypeScript compilation<\/a> provides a great way forward to start converting your JavaScript projects to TypeScript, improvements<\/a> to JSX\/TSX support<\/a>, and our move to ChakraCore<\/a>. This post supplements the above and details how TypeScript 1.8 provides full support for module augmentation, delivers a stronger type system with string literal types, and catches even more common bugs with smarter control flow analysis.<\/p>\n

TypeScript 1.8 is available for Visual Studio 2015<\/a>, Visual Studio 2013<\/a>, NuGet (Compiler<\/a> and MSBuild task<\/a>), npm<\/a>, and straight from the source<\/a>.<\/p>\n

Module Augmentation<\/h2>\n

TypeScript 1.8 allows users to design more modular libraries via module augmentation. This allows library authors to distribute their libraries in a piecemeal fashion. Previously, TypeScript made the assumption that modules wouldn’t change. With module augmentation, users have the ability to extend existing modules such that consumers can specify if they want to import the whole module or just a subset. This can be accomplished by simply adding an ambient module declaration and extending any existing types.<\/p>\n

\/\/ scale.ts<\/span>\nexport class<\/span> Scale {\n    weightOnEarth(mass) {}\n}\n\/\/ advancedScale.ts<\/span>\nimport<\/span> { Scale } from<\/span> \".\/scale\"<\/span> ;<\/pre>\n
\/\/ create augmentation for Scale<\/span>\ndeclare module<\/span> \".\/scale\"<\/span> {\n    \/\/ Augment Core class via interface merging<\/span>\n    interface<\/span> Scale {\n        weightOnMoon(mass); \/\/ not everyone needs moon weight<\/span>\n    }\n}\nScale.prototype.weightOnMoon = \/* insert implementation *\/<\/span>;\n\n\/\/ consumer.ts<\/span>\nimport<\/span> { Scale } from<\/span> \".\/scale\"<\/span>;\nimport<\/span> \".\/advancedScale\"<\/span>;\n\nlet<\/span> scale: Scale;\nscale.weightOnMoon(10);  \/\/ ok<\/span><\/pre>\n
String Literal Types<\/h2>\n
It is very common for JavaScript libraries to consume a string as a configuration parameter, and usually in such cases you want to restrict the possible strings to a certain set. Take the following example of a UI element that can specify an easing method:<\/p>\n
declare class<\/span> UIElement {\n    animate(options: AnimationOptions): void<\/span>;\n}\n\ninterface<\/span> AnimationOptions {\n    deltaX: number<\/span>;\n    deltaY: number<\/span>;\n    easing: string<\/span>;  \/\/ Can be \"ease-in\", \"ease-out\", \"ease-in-out\"<\/span>\n}\nnew<\/span> UIElement().animate({ deltaX: 100, deltaY: 100, easing: \"out\"<\/span> }); \/\/ No error<\/span><\/pre>\n
With regular strings, there is no protection from this class of error. However, starting with TypeScript 1.8, strings in a type position will become string literal types<\/em>. Only exact string matches are assignable to string literal types, and like any other type, they can be used in union types as well. So if we rewrite the AnimationOptions<\/code> interface with string literal types, the API users now get type protection:<\/p>\n
interface<\/span> AnimationOptions {\n    deltaX: number<\/span>;\n    deltaY: number<\/span>;\n    easing: \"ease-in\"<\/span> | \"ease-out\"<\/span> | \"ease-in-out\"<\/span>;\n}\n\n\/\/ Error: Type '\"out\"' is not assignable to type '\"ease-in\" | \"ease-out\" | \"ease-in-out\"'<\/span>\nnew<\/span> UIElement().animate({ deltaX: 100, deltaY: 100, easing: \"out\"<\/span> });<\/pre>\n
Smarter Control Flow Analysis<\/h2>\n
It is common for complex logic that results in many branching code paths to produce hard to find bugs. TypeScript 1.8 delivers better control flow analysis to help you catch these at compile time.<\/p>\n
Unreachable Code<\/h3>\n
JavaScript’s automatic semicolon insertion is fairly useful, but it can also lead to unwanted results at times. The example below, which actually returns undefined<\/code>, highlights a common bug that is now detected by the TypeScript compiler.<\/p>\n
function<\/span> importantData() {\n    return<\/span>          \/\/ Automatic semicolon insertion triggered with newline<\/span>\n    {\n        x: \"thing\"<\/span>  \/\/ Error: Unreachable code detected.<\/span>\n    }\n}<\/pre>\n
Implicit Returns<\/h3>\n
In JavaScript, reaching the end of a function with no return statement results in implicitly returning undefined<\/code>. Sometimes this is the intended behavior, but often times it can be a red flag for gaps in complex logic. Unlike unreachable code, this check is off<\/strong> by default. To get the added safety, just add the --noImplicitReturns<\/code> flag.<\/p>\n
function<\/span> isPizza(food) {   \/\/ Error: Not all code paths return a value.<\/span>\n    if<\/span> (food === \"pizza\"<\/span>) {\n        return<\/span> true<\/span>;\n    }\n    else<\/span> if<\/span> (food === \"pie\"<\/span>) {\n        return<\/span> true<\/span>;\n    }\n    \/\/ implicitly returns `undefined`<\/span>\n}<\/pre>\n
So Much More!<\/h2>\n
If you want the deep dive on all the new features released with 1.8, check out our what’s new page<\/a>. As always, we encourage you to weigh in on the future of TypeScript by browsing our existing issues<\/a>, throwing us a pull request<\/a>, or just hanging out with the team on gitter<\/a>.<\/p>\n
<\/div>\n","protected":false},"excerpt":{"rendered":"
Today we are thrilled to announce the release of TypeScript 1.8. In the TypeScript 1.8 Beta release blog post, we highlighted some of the key features that are now available to TypeScript users – how JavaScript in TypeScript compilation provides a great way forward to start converting your JavaScript projects to TypeScript, improvements to JSX\/TSX […]<\/p>\n","protected":false},"author":380,"featured_media":1797,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-582","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-typescript"],"acf":[],"blog_post_summary":"
Today we are thrilled to announce the release of TypeScript 1.8. In the TypeScript 1.8 Beta release blog post, we highlighted some of the key features that are now available to TypeScript users – how JavaScript in TypeScript compilation provides a great way forward to start converting your JavaScript projects to TypeScript, improvements to JSX\/TSX […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/posts\/582","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/users\/380"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/comments?post=582"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/posts\/582\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/media\/1797"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/media?parent=582"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/categories?post=582"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/typescript\/wp-json\/wp\/v2\/tags?post=582"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
TypeScript 1.8 also includes control logic for unused labels and case clause fall-through. You can read more about those here<\/a>.<\/p>\n
If for whatever reason you are experiencing too many false positives, please let us know<\/a>, but you can toggle this feature off with the --allowUnreachableCode<\/code> flag.<\/p>\n