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[];
}
Хочете вчитися крок за кроком? У кабінеті є 12 уроків по главах і завдання з перевіркою коду.