TypeScript: довідник
JavaScript із типами: менше помилок, зрозуміліший код. Продовження курсу JavaScript.
Основи
Що додає TypeScript
TypeScript це JavaScript із типами. Помилки типів видно під час написання коду, а не в браузері.
let age: number = 16; let name: string = "Олена"; let ok: boolean = true; age = "шістнадцять"; // помилка: рядок не number
Компіляція
Браузер не виконує .ts напряму, код перетворюється на JavaScript.
npm install -D typescript npx tsc --init # створити tsconfig.json npx tsc # перевірити й зібрати в JS
Типи
Базові типи й вивід
Не пишіть тип там, де компілятор виводить його сам. unknown безпечніший за any.
let n = 5; // тип виводиться сам: number let list: number[] = [1, 2, 3]; let pair: [string, number] = ["вік", 16]; // кортеж let anything: unknown = "текст"; let id: string | number = 7; // об'єднання
Літеральні типи й enum
Літеральний тип дозволяє лише перелічені значення.
type Level = "easy" | "medium" | "hard";
let lvl: Level = "easy";
enum Color { Red, Green, Blue }
console.log(Color.Green); // 1Функції
Типи параметрів і результату
Знак ? робить параметр необов'язковим. void означає, що значення не повертається.
function add(a: number, b: number): number {
return a + b;
}
const greet = (name: string, title?: string): string =>
title ? title + " " + name : name;
function log(msg: string): void { console.log(msg); }Інтерфейси й типи
interface і type
Інтерфейс описує форму об'єкта. Для об'єднань і простих псевдонімів використовують type.
interface User {
id: number;
name: string;
email?: string; // необов'язкове поле
readonly role: string; // лише читання
}
type Point = { x: number; y: number };
const u: User = { id: 1, name: "Олена", role: "admin" };Розширення й об'єднання
extends додає поля до існуючого інтерфейсу.
interface Admin extends User {
permissions: string[];
}
type Result = Success | Failure; // одне з двохЗвуження типів
typeof, in, перевірки
Після перевірки компілятор знає точніший тип змінної.
function show(v: string | number) {
if (typeof v === "string") {
return v.toUpperCase(); // тут v це string
}
return v.toFixed(2); // а тут number
}Узагальнення
Generics
<T> це параметр типу: функція працює з будь-яким типом, зберігаючи його.
function first<T>(items: T[]): T | undefined {
return items[0];
}
const n = first([1, 2, 3]); // number | undefined
const s = first(["a", "b"]); // string | undefined
interface Box<T> { value: T }Утилітарні типи
Partial, Pick, Record
Готові типи-перетворювачі економлять опис нових типів.
type UserPatch = Partial<User>; // усі поля необов'язкові
type Preview = Pick<User, "id" | "name">; // лише вибрані поля
type Without = Omit<User, "email">; // усі, крім вказаних
const prices: Record<string, number> = { хліб: 24 };Класи
Модифікатори доступу
public, private та protected керують доступом. public у конструкторі одразу створює поле.
class Account {
private balance = 0;
constructor(public owner: string) {}
deposit(sum: number): void {
this.balance += sum;
}
get total(): number { return this.balance; }
}Робота з API
Типізований fetch
Відповідь сервера компілятор перевірити не може, тому тип вказують явно (as) або перевіряють дані.
interface Item { id: number; title: string }
async function load(): Promise<Item[]> {
const res = await fetch("/api/items");
if (!res.ok) throw new Error("Помилка " + res.status);
return (await res.json()) as Item[];
}