{"canonical_url":"https://engineer.company/uk/glossary/typescript/","content_markdown":"# TypeScript\n\n## Що це таке\n\nTypeScript — мова програмування від Microsoft, яка додає до JavaScript анотації типів, разом із\nкомпілятором `tsc`, що їх перевіряє. Назву скорочують до TS, а файли мають розширення `.ts` або\n`.tsx`, коли містять розмітку JSX. Синтаксис JavaScript є коректним TypeScript, тому мову називають\nнадмножиною JavaScript. Компілятор відкритий під ліцензією Apache License 2.0.\n\nТипи живуть лише доти, доки триває перевірка. Звичайні анотації типів\nстираються, коли TypeScript генерує JavaScript; вони не перевіряють дані під\nчас роботи програми й не потребують бібліотеки для перевірки типів під час\nвиконання. Анотації типів не змінюють поведінки коду JavaScript під час роботи.\nЦей один факт пояснює і силу мови, і її межі: засіб перевірки аналізує типи,\nописані у вихідному коді; він не перевіряє дані, які надходять уже під час\nроботи програми.\n\nСистема типів структурна. Два типи сумісні, коли збігається їхня форма, хоч би як вони називалися, і\nце пасує звичці JavaScript передавати звичайні об'єкти; C# і Java натомість порівнюють оголошені\nімена. Більшу частину типів компілятор виводить сам, тож анотації стоять переважно на сигнатурах\nфункцій та експортованих значеннях. У системі також є кілька навмисних прогалин. `any` вимикає\nперевірку для значення, а твердження типу через `as` просить компілятор повірити програмістові на\nслово. Обидва зникають із результату разом з усім іншим.\n\nЄ три поширені способи запуску. `tsc` перевіряє проєкт і генерує JavaScript. Бандлери на кшталт\nesbuild вилучають типи без перевірки й лишають її окремому запуску `tsc --noEmit`. Node.js,\nпочинаючи з v23.6.0 і v22.18.0, виконує файли `.ts` напряму, замінюючи синтаксис типів пробілами,\nзнову ж таки без перевірки типів, і приймає лише той синтаксис, який можна так прибрати. TypeScript\n7.0, анонсований у липні 2026 року, — це компілятор, перенесений на Go, який, за словами команди,\nзазвичай від 8 до 12 разів швидший на повних збираннях.\n\n## Чому це важливо\n\nПитання, на яке відповідає команда: чи окупають крок збирання й перевірка своє місце тим, що ловлять\nпомилки до запуску коду. У кодовій базі, яку щотижня змінюють кілька людей, зазвичай окупають.\nПерейменування поля показує кожне місце, де воно використовувалося, редактор доповнює й пояснює код\nна основі типів, а сигнатура модуля стає контрактом, який викликачі не можуть тихо порушити. Ціна —\nперевірка в кожному конвеєрі, файл конфігурації з безліччю параметрів і визначення типів, які мають\nвстигати за бібліотеками, що їх описують.\n\nНайважливіше налаштування — суворість. Прапорець `strict` вмикає родину перевірок, серед них\n`strictNullChecks` і `noImplicitAny`, і посібник порівнює результат із регулятором, а не з\nперемикачем. Починаючи з TypeScript 6.0, цей прапорець увімкнений за замовчуванням, тож новий проєкт\nодразу стартує суворим. Старіший проєкт може досі мати значення false, і якщо ввімкнути прапорець\nпізніше, доведеться пройтися по кожному файлу, якого це стосується. Дві корисні перевірки стоять\nпоза цією родиною і вмикаються окремо: `noUncheckedIndexedAccess` та `exactOptionalPropertyTypes`.\n\nСтирання типів визначає межу. Програма, яка читає JSON із мережевого запиту, файлу, черги чи форми,\nмає щодо форми цих даних лише слово програміста, бо коли дані надходять, типів уже немає. Тому межі\nз зовнішнім світом потребують валідації під час виконання, найкраще згенерованої з тієї самої схеми,\nщо й типи, щоб перевірка і тип завжди збігалися. TypeScript робить узгодженим нутро програми, а краї\nзалишає коду.\n\nПеревірка типів живить і інші інструменти. Лінтер на кшталт typescript-eslint може запитати в\nкомпілятора інформацію про типи, і тоді правило здатне позначити проміс, залишений без `await`, або\nзначення типу `any`, що розповзається модулем. Так команда перетворює власні домовленості на\nпомилки, а не на коментарі в рев'ю.\n\n## Як це виглядає на практиці\n\nУ проєктах, показаних на цьому сайті, TypeScript тримають чесним згенерований код та інструменти, а\nне домовленості. Три сторінки показують, як саме.\n\nНа одній платформі TypeScript-клієнт фронтенду ніколи не пишуть вручну.\n[Його генерують з опису самого API](/uk/portfolio/generated-the-api-contract-from-the-database-out/),\nякий Huma формує з типів Go, а ті своєю чергою випливають зі схеми бази даних та її функцій. На задокументованому етапі реалізації клієнт\nналічував 44 076 рядків, а 61 mock-обробник, згенерований поруч із ним, давав тестам фронтенду працювати\nз реальним контрактом замість рукописної фікстури. Кожен перехід має свій запобіжник. Перевірка\nконтракту в CI порівнює те, що надсилає фронтенд, із тим, що очікує API, і валить білд за\nрозбіжності, а під нею працює перевірка схеми, яка звіряє реальну структуру даних. Вона охоплює\nопціональні поля тіла запиту, де легко сплутати «відсутнє» і null, та enum-и query-параметрів. Поле,\nзмінене з одного боку, тепер валить білд за кілька хвилин після зміни, а не виринає як 422 у\nбраузері вже після того, як розбіжність потрапила в продакшн. Натомість зміна контракту доходить до типів клієнта лише після повторного\nзапуску всього ланцюжка, а повторна генерація потребує зайвих зусиль.\n\nІнша сторінка задає одну планку для шести мов, серед яких і TypeScript.\n[Кожна діагностика ESLint вважається помилкою](/uk/portfolio/set-a-zero-warnings-bar-across-six-languages/),\nрівня попереджень, у якому можна сховатися, там немає, а inline-придушення заборонені, тож знахідку\nдоводиться виправляти, а не глушити. Pre-commit- і pre-push-хуки запускають лінтери й тести, а\nобмеження на довжину функцій і файлів тримають модулі читабельними.\n\nЛінтери, що постачаються з мовою, не дістають до правил, специфічних для проєкту, тому\n[п'ятнадцять власних правил ESLint](/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/)\nутримували прийняті в цьому репозиторії патерни TypeScript на\nзадокументованому етапі реалізації. Вони належали до рушія guard-перевірок із\n274 скриптів, 268 з яких були зареєстровані в commit-хуках, а самі перевірки\nмали 146 власних тестів: зламана перевірка пропускає все, і ніхто цього не\nпомічає. Одне правило стосується тестів, а не типів: коміт із префіксом `fix:` мусить містити\nтест, який без виправлення падає. Час рев'ю перемістився з механіки на проєктування, а натомість\nкомітити стало повільно.\n\n## Де виникають проблеми\n\nБільшість збоїв у TypeScript виникає тоді, коли типам довіряють далі, ніж бачить компілятор.\n\n**Поле з типом string під час виконання виявляється undefined.** Дані прийшли ззовні, і їм дали тип\nзамість перевірки. Бібліотека DOM типізує `res.json()` як проміс від `any`, тож компілятор приймає\nвсе, що код робить із результатом, а твердження типу робить довіру явною, але не безпечною:\n\n```ts\nconst res = await fetch(\"/api/user\");\nconst user = (await res.json()) as User; // trusted, never checked\nuser.email.toLowerCase(); // TypeError if email is missing\n```\n\nЗовнішні дані варто обробляти як `unknown`, валідувати на межі за схемою часу виконання й генерувати\nтип із тієї самої схеми, щоб вони не розходилися. Правило лінтера з інформацією про типи тоді\nпозначить кожен `any`, що прослизне.\n\n**Код із помилками типів однаково потрапляє в продакшн.** `tsc` записує JavaScript навіть тоді, коли\nповідомляє про помилки, бо `noEmitOnError` за замовчуванням має значення false, а бандлери й Node.js\nвилучають типи взагалі без перевірки. Варто запускати `tsc --noEmit` як обов'язковий крок у CI та в\npre-commit-хуку й валити білд за його кодом виходу.\n\n**Звернення за індексом повертає undefined, який тип виключав.** Елемент масиву або ключ, прочитаний\nчерез індексну сигнатуру, отримує тип так, ніби значення є завжди, навіть за кінцем масиву.\nДопомагає `noUncheckedIndexedAccess`: він додає `undefined` до таких читань і змушує код це\nобробити. У парі з ним варто ввімкнути `exactOptionalPropertyTypes`, який відрізняє відсутню\nвластивість від властивості зі значенням `undefined`.\n\n**Файл, що компілюється через tsc, падає, коли його запускає Node.js.** Вилучення типів прибирає\nлише синтаксис, що не впливає на виконання. Enum-и та простори імен зі значеннями зупиняють Node.js\nіз помилкою `ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`, а тип, імпортований без ключового слова `type`,\nвважається імпортом значення й падає під час виконання. Прапорці `erasableSyntaxOnly` і\n`verbatimModuleSyntax` змушують компілятор повідомити про обидва випадки раніше за Node.js; для\nтипів варто писати `import type`, а enum-и замінювати об'єктними літералами з позначкою `as const`.\n\n## Що почитати далі\n\n- [TypeScript Documentation](https://www.typescriptlang.org/docs/) — посібник, довідкові сторінки й\n  примітки до випусків, які підтримує команда TypeScript.\n- [The Basics](https://www.typescriptlang.org/docs/handbook/2/basic-types.html) — розділ посібника\n  про статичну перевірку, генерацію коду попри помилки, стерті типи й суворість.\n- [TSConfig Reference: strict](https://www.typescriptlang.org/tsconfig/#strict) — усі параметри\n  компілятора з їхніми типовими значеннями, зокрема перевірки, які вмикає прапорець strict.\n- [Type Compatibility](https://www.typescriptlang.org/docs/handbook/type-compatibility.html) —\n  структурна підтипізація та місця, де система типів навмисно ненадійна.\n- [Node.js: Modules: TypeScript](https://nodejs.org/api/typescript.html) — вилучення типів,\n  синтаксис, який воно відхиляє, і налаштування компілятора, які радить Node.js.\n- [Linting with Type Information](https://typescript-eslint.io/getting-started/typed-linting/) — як\n  typescript-eslint дає правилам лінтера доступ до перевірки типів.\n\n\u003chttps://engineer.company/uk/glossary/typescript/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Що TypeScript перевіряє і що стирає, наскільки суворим його налаштувати, як його запускає Node.js і де типи перестають захищати програму.","formats":{"gemtext":"https://engineer.company/uk/glossary/typescript/index.gmi","gopher":"https://engineer.company/uk/glossary/typescript/gophermap","html":"https://engineer.company/uk/glossary/typescript/","json":"https://engineer.company/uk/glossary/typescript/index.json","markdown":"https://engineer.company/uk/glossary/typescript/index.md","pdf":"https://engineer.company/uk/glossary/typescript/index.pdf"},"kind":"page","language":"uk","title":"Що таке TypeScript?","url":"https://engineer.company/uk/glossary/typescript/","version":1}