Веб-программирование
Веб-программирование · лекция 8 из 16
TodoApp, TodoList, TodoItemРаботало. Но так, как настоящие проекты не делает никто.
<script>'react'Первые три лечат инструменты. Последнюю — типы.
package.json, Vite и сборкаВсё, что будет дальше в курсе, — уже на TypeScript и в проекте на Vite.
type Tasktrue / false.tsxdist/Плашка в правом нижнем углу покажет, на каком шаге мы сейчас.
Типы, которые проверяются до запуска и исчезают после
task.txt.toUpperCase(); // TypeError — уже у пользователя
'1' + 1; // '11' — и никакой ошибки
tasks.lenght; // undefined — тоже без ошибки
Все три — из лекций 6 и 7. Первую найдёт пользователь, когда нажмёт кнопку. Две другие не найдёт никто: код просто тихо работает неправильно.
task.Txt.ToUpper();
// error CS1061: 'Task' does not
// contain a definition for 'Txt'
task.txt.toUpperCase();
// всё хорошо… пока пользователь
// не нажмёт кнопку
В Java и C# ошибку находит компилятор, в JavaScript — пользователь.
Создан в Microsoft. Ведущий архитектор — Андерс Хейлсберг: до этого он написал Turbo Pascal, Delphi и C#.
Поэтому многое в TypeScript покажется знакомым по C#: generics,
interface, readonly, даже стиль сообщений об
ошибках.
Любой JavaScript — уже правильный TypeScript. Можно переименовать
.js в .ts и добавлять типы постепенно.
tsc — TypeScript Compiler.
В опросе State of JS большинство фронтенд-разработчиков пишут в основном на TypeScript, а не на JavaScript.
stateofjs.comКомпилятор переписали с TypeScript на Go: проверка больших проектов стала примерно в 10 раз быстрее. Язык тот же.
В демо этой лекции — TypeScript 6.0, последний компилятор на JavaScript: его можно запустить прямо в браузере. Правила языка у версий 6 и 7 одинаковые.
devblogs.microsoft.com/typescriptlet title: string = 'Начать ЛР 4';
let count: number = 3; // int и double — один number
let done: boolean = false;
title = 42; // ❌ Type 'number' is not assignable to type 'string'
Тип пишется после имени, через двоеточие. Как в Kotlin и Pascal.
let title = 'Начать ЛР 4'; // string — компилятор понял сам
const max = 10; // 10 — не просто number, а именно 10
title = 42; // ❌ та же ошибка
Как var в C# и auto в C++. Обычно аннотируют
только параметры функций и общие типы данных — остальное компилятор
выводит сам.
const tags: string[] = ['react', 'ts'];
const ids: Array<number> = [1, 2, 3]; // то же самое
const task: { id: number; text: string; note?: string } = {
id: 1,
text: 'Начать ЛР 4',
}; // note можно не указывать
? — необязательное поле: его тип string | undefined.
function add(a: number, b: number): number {
return a + b;
}
const greet = (name: string, greeting = 'Привет') =>
`${greeting}, ${name}`; // результат string — выведен
add(1, '2'); // ❌ Argument of type 'string' is not assignable…
Ошибка '1' + 1 со слайда про рантайм больше не пройдёт.
typetype Task = {
id: number;
text: string;
done: boolean;
};
const tasks: Task[] = [
{ id: 1, text: 'Прочитать лекцию 7', done: true },
{ id: 2, text: 'Начать ЛР 4', done: false },
];
Первый шаг: у списка дел есть тип. task.txt теперь — ошибка
в редакторе.
type и interfacetype Task = {
id: number;
text: string;
};
type Urgent = Task & {
deadline: Date;
};
interface Task {
id: number;
text: string;
}
interface Urgent extends Task {
deadline: Date;
}
Для объектов — почти одно и то же. В курсе type по
умолчанию: он умеет ещё и объединения. Главное — одинаково во всём
проекте.
type Task = { id: number; text: string };
type Note = { id: number; text: string };
const note: Note = { id: 1, text: 'Купить кофе' };
const task: Task = note;
Note есть всё,
что требует Task. Имя типа не важно, implements
не нужен.
В Java и C# типизация номинальная: Note и
Task — разные классы, даже с одинаковыми полями.
function print(t: { text: string }) {
console.log(t.text);
}
print(task); // ✅ есть text
print({ text: 'и так можно' }); // ✅
print({ title: 'ЛР 4' }); // ❌ нет text
Та же «утиная типизация», что и в JavaScript, — только проверенная до запуска.
| Java, C# | TypeScript | |
|---|---|---|
| совместимость | по имени | по форме |
implements | обязателен | не нужен |
| типы при запуске | есть: instanceof, рефлексия | стёрты |
null | NullPointerException при запуске | ловит компилятор |
Про стирание и null — через несколько слайдов.
type Task = { id: number; text: string };
const a: Task = { id: 1, text: 'ЛР 4', dnoe: true };
const draft = { id: 2, text: 'ЛР 5', dnoe: true };
const b: Task = draft;
a — ошибка, b — нетdnoe вместо done.
Через переменную — уже не литерал, и работает обычное правило: всё нужное есть, лишнее не мешает.
let id: string | number;
id = 42; // ✅
id = 'a-42'; // ✅
id = true; // ❌ Type 'boolean' is not assignable…
«Или то, или другое» — без общего базового класса и без перегрузок.
type Status = 'todo' | 'doing' | 'done';
let s: Status = 'todo';
s = 'done'; // ✅
s = 'Done'; // ❌ Type '"Done"' is not assignable to type 'Status'
Тип — конечный набор конкретных строк. Редактор подсказывает варианты, опечатка в регистре — ошибка.
donetype Status = 'todo' | 'doing' | 'done';
type Task = {
id: number;
text: string;
status: Status; // было done: boolean
};
У boolean два значения, а у дела три состояния. Тип
описывает предметную область, а не то, как удобнее хранить.
enum?enum Status { Todo, Doing, Done } // в TypeScript есть и такое
Но enum — редкий случай, когда TypeScript добавляет в JS
свой код: после компиляции это объект. Node.js, который запускает
.ts, просто вырезая типы, на enum падает.
В шаблоне Vite стоит erasableSyntaxOnly — enum
там запрещён. В курсе — union из строк.
if и switch
typeof сужает типfunction show(id: string | number) {
id.toUpperCase(); // ❌ у number нет toUpperCase
if (typeof id === 'string') {
return id.toUpperCase(); // ✅ здесь id: string
}
return id.toFixed(0); // ✅ здесь id: number
}
Обычная проверка из JavaScript — и компилятор её понимает. Приводить тип вручную, как в Java, не нужно.
s в каждой ветке?type Status = 'todo' | 'doing' | 'done';
function label(s: Status) {
if (s === 'done') {
return 'готово'; // s: ?
}
return 'в работе: ' + s; // s: ?
}
'done' и 'todo' | 'doing'if осталось только то, что прошло проверку. После
return компилятор вычитает проверенный вариант.
Наведите курсор на s в редакторе — он покажет тип в этой
строке.
switch и забытый вариантfunction label(s: Status): string {
switch (s) {
case 'todo': return 'надо сделать';
case 'doing': return 'в работе';
case 'done': return 'готово';
default: {
const rest: never = s; // сюда не доходит ничего
return rest;
}
}
}
Добавили в Status четвёртый вариант — компилятор покажет
каждый switch, который надо дополнить.
Я называю это своей ошибкой на миллиард долларов. Это было изобретение нулевой ссылки в 1965 году. Тони Хоар, автор быстрой сортировки, 2009
NullPointerException в Java, NullReferenceException в C#,
Cannot read properties of null в JavaScript.
null под контролемconst list = document.querySelector('ul'); // HTMLUListElement | null
list.append('x'); // ❌ 'list' is possibly 'null'
if (list) list.append('x'); // ✅ сужение
list?.append('x'); // ✅ из лекции 7
list!.append('x'); // «точно не null» — под вашу ответственность
С strict null — отдельный тип. Забыть проверку
нельзя: компилятор не даст.
any и unknownany — «проверки выключены»unknown — «сначала проверь»const a: any = JSON.parse(text);
a.txt.toUpperCase(); // компилятор молчит — упадёт в браузере
const u: unknown = JSON.parse(text);
u.txt; // ❌ 'u' is of type 'unknown'
if (typeof u === 'object' && u !== null && 'text' in u) {
u.text; // ✅ проверили — можно
}
any заразен: всё, что из него получено, тоже
any. Он не чинит ошибку, а прячет её.
as — «я знаю лучше»const input = document.querySelector('#title') as HTMLInputElement;
input.value; // компилятор поверил на слово
as ничего не проверяет и при запуске ничего не делает. Нет
элемента — ошибка в браузере.
Это не приведение типа из Java: там при ошибке будет ClassCastException, здесь — ничего. Используйте редко.
function first<T>(items: T[]): T | undefined {
return items[0];
}
first([1, 2, 3]); // number | undefined
first(['чай', 'кофе']); // string | undefined
first<Task>(tasks); // можно указать явно
Как List<T> в Java и C#. T обычно
выводится из аргументов.
extendsfunction byId<T extends { id: number }>(items: T[], id: number) {
return items.find(item => item.id === id);
}
byId(tasks, 2); // Task | undefined
byId(['без id'], 1); // ❌ string не подходит под { id: number }
Возвращается T, а не { id: number }: поля
text и status не потерялись.
const [tasks, setTasks] = useState<Task[]>([]);
Пустой массив сам не скажет, что в нём будут дела. useState
— тема лекции 10.
| тип | что получается |
|---|---|
Partial<Task> | все поля необязательны — черновик, частичное обновление |
Omit<Task, 'id'> | всё, кроме id — новое дело до сохранения |
Pick<Task, 'text'> | только text |
Readonly<Task> | ничего нельзя менять |
function addTask(data: Omit<Task, 'id'>): Task { … }
type Task = {
id: number;
text: string;
};
function title(t: Task): string {
return t.text.toUpperCase();
}
function title(t) {
return t.text.toUpperCase();
}
Ни проверок, ни instanceof Task: при запуске
Task не существует. Node.js запускает .ts,
просто вырезая типы.
const res = await fetch('/api/tasks');
const tasks: Task[] = await res.json(); // поверили на слово
Сервер может прислать что угодно, и компилятор об этом не узнает. Данные снаружи проверяют при запуске — например, библиотекой Zod.
fetch и await — лекция 9.
.tsx и props с типами
type TodoItemProps = {
task: Task;
onToggle: (id: number) => void;
};
export function TodoItem({ task, onToggle }: TodoItemProps) {
return (
<li className={'todo__item todo__item--' + task.status}
onClick={() => onToggle(task.id)}>
{task.text}
</li>
);
}
Файл TodoItem.tsx: буква x — значит, внутри JSX.
type Props = { text: string; done: boolean };
<TodoItem text="ЛР 4" done={false} /> // ✅
<TodoItem text="ЛР 4" done="false" /> // ❌ string — не boolean
<TodoItem text="ЛР 4" /> // ❌ нет done
В лекции 7 строка "false" вместо false тихо
ломала список: непустая строка — истина. Теперь это красная волна в
редакторе.
children и событияtype CardProps = {
title: string;
children: React.ReactNode; // всё, что между тегами
};
function onSubmit(e: React.FormEvent<HTMLFormElement>) {
e.preventDefault();
}
Запоминать типы событий не нужно: наведите курсор на
onSubmit, и редактор подскажет. Формы — лекция 10.
tsconfig.json{
"compilerOptions": {
"target": "es2023",
"jsx": "react-jsx",
"noEmit": true,
"erasableSyntaxOnly": true
}
}
Главная настройка — strict: проверки null,
запрет неявного any и другие. С TypeScript 6 она включена
по умолчанию, поэтому в шаблоне Vite её даже не пишут.
interface, genericsany — нет, unknown — даОсталось научиться запускать это не в песочнице, а в настоящем проекте.
npm, package.json, Vite и сборка
<script src="./vendor/react.min.js"></script>
<script src="./vendor/react-dom.min.js"></script>
<script src="./vendor/babel.min.js"></script>
Файлы скачаны руками. Babel компилирует JSX у каждого пользователя при каждой загрузке. А TypeScript браузер не понимает вовсе.
В Java это Maven или Gradle, в C# — NuGet и MSBuild. Во фронтенде — npm и Vite.
Райан Даль берёт движок V8 из Chrome и запускает JavaScript вне браузера: на сервере и в терминале.
Фронтенду Node.js нужен прежде всего как среда для инструментов: npm, Vite, ESLint запускаются через него.
| Java | C# | JavaScript | |
|---|---|---|---|
| реестр пакетов | Maven Central | NuGet | npmjs.com |
| программа | mvn, gradle | dotnet | npm |
| описание проекта | pom.xml | .csproj | package.json |
npm ставится вместе с Node.js. Его реестр — крупнейший в мире: больше трёх миллионов пакетов.
npmjs.compackage.json{
"name": "todo",
"private": true,
"type": "module",
"scripts": {
"dev": "vite",
"build": "tsc -b && vite build"
},
"dependencies": {
"react": "^19.3.1",
"react-dom": "^19.3.1"
},
"devDependencies": {
"typescript": "~6.0.3",
"vite": "^8.3.4"
}
}
npm run dev, npm run buildreacttypescript, vite
"type": "module" — файлы проекта используют
import и export из лекции 7.
npm install$ npm install react react-dom added 3 packages in 638ms $ npm install -D typescript vite added 17 packages in 1s
Просили два пакета — пришло три: react-dom тянет за собой
scheduler. Всё ложится в node_modules/, имена и
версии — в package.json. Флаг -D — в
devDependencies.
У пустого шаблона Vite — 27 пакетов и 80 МБ: зависимости зависимостей и готовые программы под вашу ОС.
node_modules не коммитят# .gitignore
node_modules
dist
Всё восстанавливается одной командой npm install по
package.json. Как target/ в Maven и
bin/ в .NET.
Отправить проект с node_modules — отправить 80 МБ чужого кода.
19.3.1
Semantic Versioning — договорённость, а не закон. Авторы пакетов иногда ошибаются.
^ и ~| в package.json | что можно поставить |
|---|---|
"^19.3.1" | 19.x.x, но не ниже 19.3.1 — так по умолчанию |
"~6.0.3" | 6.0.x, но не ниже 6.0.3 |
"19.3.1" | ровно эту |
TypeScript в шаблоне Vite стоит с ~: даже в его MINOR-версиях
появляются новые проверки.
^18.2.0?18.2.5 и 18.9.0^ разрешает всё внутри того же MAJOR, но не ниже указанной
версии.
19.0.0 — новый MAJOR, может сломать код.
18.1.9 — ниже 18.2.0.
package-lock.json
Точные версии всех пакетов, включая зависимости зависимостей.
Появляется сам после npm install. Его коммитят.
package.json, обновляет lock-файлLock-файл и лечит «у меня работает».
npm run и npx$ npm run dev # скрипт из package.json $ npm run build $ npx tsc --noEmit # программа из node_modules/.bin $ npx cowsay привет # скачать и запустить разово
Глобально ставить инструменты не нужно: у каждого проекта свои версии.
Автор удалил из npm свои пакеты, среди них — left-pad:
одиннадцать строк, которые дополняют строку пробелами слева. Сломались
сборки Babel, React и тысяч проектов, которые зависели от него через
другие пакеты.
С тех пор npm не даёт удалять пакеты, от которых зависят другие.
"scripts": {
"postinstall": "node setup.js"
}
Любой пакет из дерева зависимостей может запустить свой скрипт на вашей машине. В 2025 году червь Shai-Hulud заразил сотни пакетов npm и крал токены разработчиков.
Меньше зависимостей — меньше риска. Перед установкой смотрите, что ставите.
🥚 Команду rm -rf / можно безопасно ввести только на главной странице курса
src/tscТо, что Babel в лекции 7 делал в браузере, теперь делается один раз — у разработчика.
Транспилятор — компилятор из языка в язык того же уровня.
rm -rf dist
mkdir -p dist/src
cp index.html 404.html favicon.svg og.png data.json dist/
cp -R src/shower src/highlight dist/src/
for dir in [0-9][0-9]-*/; do
cp -R "${dir%/}" dist/
done
Так собирается сайт этого курса: скрипт build.sh копирует
файлы в dist/. Тоже сборка — только без преобразований.
Создал Эван Ю, автор фреймворка Vue. По-французски vite — «быстро», читается «вит».
Сегодня — стандартный способ начать проект на React, Vue или Svelte.
Сервер для разработки. Отдаёт модули по одному, каждый преобразует по запросу. Правка видна сразу, без перезагрузки.
Сборка для пользователей. Склеивает модули, выбрасывает лишнее, сжимает и кладёт в dist/.
Сборщики прошлого поколения, например webpack, перед стартом собирали весь проект. На больших проектах это минуты.
Vite ничего не собирает заранее: браузер сам загружает модули по
import, а Vite преобразует только запрошенный файл.
Горячая замена (HMR) — меняется один модуль, данные на странице не теряются.
$ npm create vite@latest todo -- --template react-ts $ cd todo $ npm install $ npm run dev VITE v8.3.5 ready in 70 ms ➜ Local: http://localhost:5173/
Шаблон react-ts — React и TypeScript.
todo/
├── index.html точка входа — в корне проекта
├── package.json
├── tsconfig.json настройки TypeScript
├── vite.config.ts настройки Vite
├── public/ файлы как есть: favicon
└── src/
├── main.tsx подключает App к странице
├── App.tsx
└── index.css
index.html и main.tsx<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
import { StrictMode } from 'react';
import { createRoot } from 'react-dom/client';
import App from './App.tsx';
createRoot(document.getElementById('root')!).render(
<StrictMode><App /></StrictMode>
);
! — то самое «точно не null» из части 1.
// src/types.ts
export type Status = 'todo' | 'doing' | 'done';
export type Task = { id: number; text: string; status: Status };
// src/TodoItem.tsx
import type { Task } from './types';
// src/App.tsx
import { TodoList } from './TodoList';
import type — импорт, который исчезнет вместе с типами.
Компоненты — те же, что на слайдах части 1.
Vite только вырезает типы — быстро и молча. С ошибкой типа dev-сервер работает как ни в чём не бывало.
$ npm run build
> tsc -b && vite build
src/TodoList.tsx(13,10): error TS2741: Property 'onToggle' is
missing in type '{ key: number; task: Task; }' but required
in type 'TodoItemProps'.
Типы проверяют редактор и tsc. Поэтому сборка в шаблоне
начинается с tsc -b.
npm run build$ npm run build vite v8.3.5 building client environment for production... ✓ 18 modules transformed. dist/index.html 0.45 kB │ gzip: 0.29 kB dist/assets/index-CC8h9_x1.css 0.11 kB │ gzip: 0.12 kB dist/assets/index-dSUnSNBQ.js 220.20 kB │ gzip: 68.93 kB ✓ built in 55ms
Три файла. В JS — весь React и наш список дел.
index-dSUnSNBQ.js — хэш считается по содержимому файла.
Изменился код — изменилось имя.
Поэтому такие файлы браузер может кэшировать навсегда: новая версия
придёт под новым именем. Не кэшируется только маленький
index.html.
$ npm run preview # посмотреть dist/ локально
dist/ — обычные статические файлы. Их можно выложить на
Netlify, GitHub Pages или любой веб-сервер.
Сайт этого курса так и живёт: папка dist/ на Netlify.
Компилятор проверяет типы, линтер — привычки, форматтер — внешний вид.
package.json и lock-файл коммитят, node_modules — нетdist/tsc и редактор; Vite не проверяет ничегоИ что дальше
src/ в dist/
type для данных и props, union вместо boolean и enum, сужениеany, as и ! — пока можно обойтись проверкойnpm create vite, npm run dev, npm run buildС этого момента весь код курса — в таком проекте.
Promise и async / awaitfetch и HTTP APIСписок дел начнёт загружаться с сервера.
Слайды, демо и игра — в репозитории курса