We have updated the content of our program. To access the current Software Engineering curriculum visit curriculum.turing.edu.
Introduction to TypeScript
Learning Goals
- Understand what TypeScript is and how it compares to JavaScript
- Learn the benefits of using TypeScript in development
- Get familiar with TypeScript’s type system, including basic types, functions, and interfaces
- Understand how TypeScript can help prevent common JavaScript errors
Vocab
TypeScript
: A typed superset of JavaScript that compiles to plain JavaScript.Static Type Checking
: The process of verifying the type correctness of a program at compile-time.Transpiling
: The process of converting TypeScript code into JavaScript code.Type Annotation
: A way to explicitly declare the type of a variable or function parameter.Interface
: A TypeScript structure that defines the shape of an object, specifying its properties and their types.
Introduction to TypeScript
TypeScript is a superset of JavaScript that introduces static type definitions. This means that TypeScript code must be transpiled into JavaScript before it can be executed by a browser or Node.js. TypeScript provides all the features of JavaScript but adds optional static typing, which can help catch errors early in the development process.
Why Use TypeScript?
- Type Safety: TypeScript’s type system helps catch type-related errors at compile time, rather than at runtime.
- Enhanced IDE Support: With TypeScript, you get better code completion, navigation, and refactoring support.
- Better Documentation: Types serve as documentation, making it easier to understand and use code written by others.
- Scalability: TypeScript is particularly useful for large codebases, where it can help manage complexity.
Comparing JavaScript and TypeScript
JavaScript is dynamically typed, meaning variable types are determined at runtime. TypeScript, on the other hand, allows for static type checking, where types are checked at compile-time.
Example of JavaScript vs TypeScript
Note: For all of today’s exercises, we’ll use TypeScript Playground. This has TypeScript already incorporated into it and runs significantly better than using Repl.
JavaScript:
let greeting = "Hello, world!";
greeting = 42; // No error in JavaScript, but might cause issues later
console.log(greeting); // Outputs: 42
TypeScript:
let greeting: string = "Hello, world!";
greeting = 42; // Error in TypeScript
console.log(greeting); // Outputs: 42
- What potential issues might arise from the JavaScript example where
greeting
is reassigned to a number? How does TypeScript help prevent these issues? - Consider a large codebase with multiple developers. How might TypeScript’s type system improve collaboration and code maintenance compared to JavaScript?
Type Annotations
TypeScript allows you to annotate variables with types including all of the standard data types you have used in JavaScript like strings, numbers, booleans, arrays, and objects. This helps catch type errors at compile time.
Here are some examples of type annotations in TypeScript:
let age: number = 25;
let name: string = "Alice";
let isStudent: boolean = true;
let hobbies: string[] = ["reading", "hiking"];
let person: { name: string; age: number } = { name: "Bob", age: 30 };
Your Turn
Example 1
let title = "TypeScript Basics";
let duration = 60;
let isComplete = false;
- Convert the above JavaScript code to TypeScript by adding appropriate type annotations.
Example 2
let score: number = "high";
- What error will the above TypeScript code produce?
Solution
- The solution to converting the variables would look like:
let title: string = "TypeScript Basics"; let duration: number = 60; let isComplete: boolean = false;
- The error will be a compile-time error because the type of the variable
score
is not a number.
A Note about any
TypeScript also supports a type called any
, which means that a variable can be any type. This is useful when you want to store a value of any type in a variable. However, using any
should be avoided because it disables type-safety.
An example of using any
would look like:
let id: any = 101;
id = "E101"; // No error
Union Types
In addition to type annotation, TypeScript also supports union types. Union types allow a variable to hold more than one type. Let’s take a look at an example:
let id: number | string;
id = 101; // Valid
id = "E101"; // Also valid
In this example, the id
variable can be either a number or a string. This can be great for when you want to store different types in a single variable.
TypeScript with Functions
TypeScript also allows you to specify the types of function parameters and return values. Let’s take a look at an example:
function add(a: number, b: number): number {
return a + b;
}
let sum = add(5, 10); // Correct usage
let result = add("5", 10); // Error: Argument of type 'string' is not assignable to parameter of type 'number'
Note that in the above TypeScript function add, we are defining a function that takes two parameters, a
and b
, both of which are of type number. The function is also specified to return a value of type number. If we try to pass in a string for the second parameter, TypeScript will throw an error.
Note: Default Values
TypeScript also supports default values for parameters. Let’s take a look at an example:
function greet(name: string, greeting: string = "Hello"): string {
return `${greeting}, ${name}!`;
}
console.log(greet("Alice"));
console.log(greet("Bob", "Hi"));
- What do you expect the output to be for
console.log(greet("Alice"));
? - Similarly, what do you expect the output to be for
console.log(greet("Bob", "Hi"));
?
Checks for Understanding
- Define a function in TypeScript that takes two numbers as arguments and returns the product. (the returned value should be a number).
- Now modify to the function to return a message instead:
The product of 2 and 3 is 6
. Note the difference in output compared to the previous iteration. Did you get an error after having changed the return type? If so, make sure to update the type annotation for the function to match the new return type. - Modify the following function to include default parameter values for
taxRate
anddiscount
:function calculateTotalPrice(price: number, taxRate: number, discount: number): number { const taxAmount = price * taxRate; const discountAmount = price * discount; const totalPrice = price + taxAmount - discountAmount; return totalPrice; }
Interfaces
Interfaces in TypeScript define the shape of an object. They specify what properties an object should have and their types.
interface Person {
name: string;
age: number;
}
let student: Person = {
name: "John",
age: 21
};
Complex Interface Example
In TypeScript, interfaces can be used to define more complex objects that include nested properties and arrays. Let’s consider an example of an interface for a Course
object that includes details about the course, the instructor, and the list of students enrolled.
interface Course {
title: string;
details: {
description: string;
duration: number;
};
instructor: string;
students: string[];
}
let course: Course = {
title: "TypeScript Basics",
details: {
description: "A course that introduces TypeScript",
duration: 60
},
instructor: "John Doe",
students: ["Alice", "Bob"]
};
Here is what is happening in the above example:
- The
Course
interface defines the shape of aCourse
object. It includes properties for thetitle
,details
,instructor
, andstudents
. - The
details
property is an object that contains thedescription
andduration
of the course. - The
students
property is an array of strings that represent the names of the students enrolled in the course.
The above example is a simple example of an interface. In a real-world application, you might have additional interfaces for an Instructor
and a Student
.
Your Turn
- Define an interface for a
Student
object that includes the student’s name and the courses they are enrolled in. - Define an interface for a
Instructor
object that includes the instructor’s name and the courses they teach. - Then define objects that implement both interfaces.
Potential Solution
interface Student {
name: string;
courses: string[];
}
let student: Student = {
name: "Alice",
courses: ["TypeScript Basics", "Advanced TypeScript"]
};
interface Instructor {
name: string;
courses: string[];
}
let instructor: Instructor = {
name: "Jane Eyre",
courses: ["TypeScript Basics", "Advanced TypeScript"]
};
Extending Interfaces
TypeScript allows you to extend interfaces using the extends
keyword. This is useful when you want to add new properties to an existing interface.
interface Course {
title: string;
details: {
description: string;
duration: number;
};
instructor: string;
students: string[];
}
interface AdvancedCourse extends Course {
isAdvanced: boolean,
prerequisites: string[],
}
let advancedCourse: AdvancedCourse = {
title: "Advanced TypeScript",
details: {
description: "A course that introduces advanced TypeScript concepts",
duration: 90
},
instructor: "Jane Doe",
students: ["Charlie", "Dave"],
isAdvanced: true,
prerequisites: ["TypeScript Basics"]
};
In this example, we’ve extended the Course
interface to include a new property isAdvanced
that indicates if the course is for advanced learners. We’ve also added a new property prerequisites
that indicates the list of prerequisites for the course.
- Can you think of any other properties that might be useful to add to the
Course
interface? - Can you think of another use case for extending an interface?
Additional Practice
- Create an interface for a
Car
that includes properties formake
,model
, andyear
. - Extend the
Car
interface to create aElectricCar
interface that also includes a property forbatteryCapacity
. - Define an object that implements the
ElectricCar
interface.
Conclusion
TypeScript offers powerful tools to write safer and more robust code compared to JavaScript. By understanding and using its type system, interfaces, and advanced features like generics, developers can catch errors early, improve code readability, and manage large codebases more effectively.
Incorporating TypeScript in Future Projects
Implementing TypeScript in an application that interacts with the DOM will require some extra research on your part. We suggest starting your research by looking into how TypeScript can handle the event
object. Setup instructions to add TypeScript into your group project are already included in the README.md
file. We’ll also have an opportunity to practice TypeScript in a coding challenge this Friday!
Final Checks for Understanding
Using your journal, take a few minutes to answer the following questions:
- What are the benefits of using TypeScript over JavaScript?
- How do type annotations help prevent errors in your code?
- What are interfaces in TypeScript and how do they improve code quality?
Looking for Additional Practice?
You can continue to get extra practice converting JavaScript into Typescript with the following exercise. Clone down this repo and follow the instructions in the README.md
to complete the exercise.
Once you have finished the exercise, you can compare your solution to the solution in the ts-solution
branch.