Skip to content

TypeScript 7 з нативним компілятором на Go перевірив типи цього сайту в 5 разів швидше, але демо-проєкт зі старим tsconfig зламався в п'яти місцях. Розбираю, що змінилось у 7.0 і 7.1 Beta, де пастки з ESLint і next build, і даю скрипт перевірки та план міграції.

Опубліковано
Читання
15 хв
Автор
Yaroslav Tsarenko
–переглядів
Темний рельєф, крізь який повільна звивиста лінія випрямляється в яскравий швидкий промінь

TypeScript 7 вийшов 8 липня, і Microsoft обіцяє збирання у 8–12 разів швидше. 20 жовтня вийшла 7.1 Beta з новим API для інструментів, а Release Candidate обіцяють «приблизно за місяць». Отже, саме зараз команди вирішують: переходити вже чи почекати?

Я перевірив обидва сценарії. На копії коду цього сайту (Next.js 16, 2 379 файлів у програмі разом із типами з node_modules) tsc --noEmit пройшов за 1,4 секунди замість 7,4. Нових помилок нуль, у tsconfig нічого міняти не довелось. А маленький Node-сервіс із типовим tsconfig 2023 року впав одразу з трьома помилками конфігурації, потім ще з двома, і зібрався в неправильну папку. Знайомо? Спойлер: ваш код майже напевно в порядку. Ламаються конфіг та інструменти навколо.

Нижче все по черзі: що змінилось, де пастки (зокрема одна неочевидна з next build), скрипт, який знаходить проблеми до оновлення, і план на тиждень. Усі виводи в статті справжні: macOS, Apple M1 Pro, Node.js 25.7, TypeScript 5.9.3, 6.0.2, 7.0.2 і 7.1.0-beta.

Що сталося: TypeScript 7.0, 7.1 Beta і чому саме зараз

TypeScript 7 — це компілятор, повністю переписаний на Go. Мова та сама, типи ті самі, але tsc тепер нативна програма, яка перевіряє файли в кілька потоків. Хронологія:

Дата Подія
23 березня 2026 TypeScript 6.0: останній реліз на JavaScript, усі застарілі опції помічені
18 червня 2026 TypeScript 7.0 RC
8 липня 2026 TypeScript 7.0, стабільний реліз
3 серпня 2026 Next.js 16.3: next build уміє перевіряти типи через TypeScript 7
20 жовтня 2026 TypeScript 7.1 Beta: новий API, es2026, ще швидше
≈ кінець 2026 7.1 RC і реліз (оцінка за словами команди, точних дат немає)

Чому це питання саме листопада? Тому що 7.1 закриває головну прогалину 7.0. У 7.0 немає JavaScript API: пакет більше не можна підключити через require("typescript") і попросити типи файлу. Саме цим живуть typescript-eslint, плагіни для Vue і Svelte та купа внутрішніх скриптів. 7.1 повертає API, хоч і зовсім інший. Тож зараз найкращий момент підготувати проєкт: прибрати конфіг-борги, перевести CLI на 7.0, а інструменти переключити, коли вони наздоженуть.

Видалено, тепер помилка

  • baseUrlpaths тепер відносні: ./src/*
  • moduleResolution nodeлише nodenext або bundler
  • target es5, AMD, UMDі downlevelIteration

Нові значення (з 6.0)

  • types: []@types більше не підтягуються самі
  • rootDir: ./збірка може поїхати в dist/src
  • strict і перевірка side-effect імпортівувімкнені

Інструменти

  • tscу 8–12 разів швидше
  • JavaScript APIнемає у 7.0, новий у 7.1
Що змінилось у TypeScript 7: видалено, нові значення, інструменти

Наскільки швидше насправді

Офіційні цифри з анонсу 7.0, повна збірка, 4 потоки перевірки за замовчуванням:

Проєкт TypeScript 6 TypeScript 7 Прискорення
vscode 125,7 с 10,6 с 11,9×
sentry 139,8 с 15,7 с 8,9×
bluesky 24,3 с 2,8 с 8,7×
playwright 12,8 с 1,47 с 8,7×
tldraw 11,2 с 1,46 с 7,7×

Там само наведено досвід компаній: у Slack перевірка типів у CI скоротилась приблизно з 7,5 до 1,25 хвилини, а в Canva перша помилка в редакторі з'являється через 4,8 секунди замість 58.

Мої виміри скромніші, і це нормально: що менший проєкт, то більшу частку займає запуск процесу. П'ять запусків tsc --noEmit -p . --incremental false на копії цього сайту, медіана:

tsc --noEmit на копії цього сайтумедіана з 5 запусків, менше — кращеTypeScript 5.9.3пам'ять 865 МБ7,38 сTypeScript 7.0.2пам'ять 730 МБ1,40 су 5,3 раза швидшеTypeScript 7.1 betaпам'ять 540 МБ1,14 сна 19% менше часу, ніж 7.0Apple M1 Pro · Node.js 25.7 · 2 379 файлів у програмі
  • TypeScript 5.9.3: 7,38 с, 865 МБ пам'яті;
  • TypeScript 7.0.2: 1,40 с, 730 МБ — у 5,3 раза швидше;
  • TypeScript 7.1.0-beta: 1,14 с, 540 МБ.

У next build крок «Running TypeScript» скоротився з 6,9 с до 1,26 с. На одному білді це дрібниця, але CI запускається на кожен пул-реквест, а редактор перевіряє типи на кожне натискання клавіші. На проєктах на кшталт AllShip, де 290 тестів і десятки маршрутів, швидший цикл «змінив → перевірив» відчувається щодня. І так, якщо ви пишете код із ШІ-агентами, вони теж ганяють tsc після кожної правки, тож прискорення множиться.

Що ламається в tsconfig: живий приклад

Візьмімо типовий Node API з 2023 року. TypeScript 5.9 компілює його без жодного попередження:

json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "commonjs",
    "moduleResolution": "node",
    "baseUrl": ".",
    "paths": { "@lib/*": ["src/lib/*"] },
    "esModuleInterop": true,
    "strict": true,
    "outDir": "dist"
  },
  "include": ["src"]
}

Ставимо typescript@7.0.2 і запускаємо tsc -p . --noEmit:

text
tsconfig.json(5,25): error TS5108: Option 'moduleResolution=node10' has been removed. Please remove it from your configuration.
tsconfig.json(6,5): error TS5102: Option 'baseUrl' has been removed. Please remove it from your configuration.
  Use '"paths": {"*": ["./*"]}' instead.
tsconfig.json(7,27): error TS5090: Non-relative paths are not allowed. Did you forget a leading './'?

Три помилки ще до того, як компілятор подивився на код. Виправляємо: module і moduleResolution ставимо в nodenext, baseUrl видаляємо, шляхи в paths робимо відносними ("./src/lib/*"). Запускаємо знову:

text
src/index.ts(2,8): error TS2882: Cannot find module or type declarations for side-effect import of './polyfills'.
src/lib/env.ts(1,28): error TS2591: Cannot find name 'process'. Do you need to install type definitions for node? Try `npm i --save-dev @types/node` and then add 'node' to the types field in your tsconfig.

Обидві помилки — це нові значення за замовчуванням, і обидві корисні:

  • noUncheckedSideEffectImports: true. Рядок import "./polyfills" вказував на файл, якого не існувало. TypeScript 5.9 мовчав роками, TypeScript 7 знайшов битий імпорт з першого запуску.
  • types: []. Раніше TypeScript підтягував усі пакети з node_modules/@types автоматично. Тепер жодного: глобальні типи треба перелічити явно, наприклад "types": ["node"] або ["node", "jest"]. Старе поводження повертає ["*"], але краще перелічити: менше випадкових глобальних змінних з чужих @types.

Чесне уточнення: ці дві зміни, як і rootDir нижче, з'явились ще в TypeScript 6.0. Я прогнав той самий конфіг на 6.0.2, і помилки ті самі. Різниця в іншому: 6.0 дозволяв відкласти видалені опції через "ignoreDeprecations": "6.0", а 7.0 вже ні. Тож якщо ви на 5.x, перехід на 7 — це два стрибки одразу.

Додаємо "types": ["node"], створюємо файл і запускаємо вже збірку, а не лише перевірку.

Найпідступніша зміна: rootDir

text
tsconfig.json(9,5): error TS5011: The common source directory of 'tsconfig.json' is './src'. The 'rootDir' setting must be explicitly set to this or another path to adjust your output's file layout.
  Visit https://aka.ms/ts6 for migration information.

Тут уважно. Помилка є, але tsc все одно записав файли (код виходу 2 означає «є помилки, але вивід згенеровано»). І записав не туди:

TypeScript 5.9 TypeScript 7.0 без rootDir
Головний файл dist/index.js dist/src/index.js
Модулі dist/lib/env.js dist/src/lib/env.js

Раніше rootDir обчислювався як спільна папка всіх вхідних файлів, тобто src. Тепер за замовчуванням це папка з tsconfig. Якщо ваш Dockerfile чи npm start запускає node dist/index.js, а CI не зупиняється на коді виходу 2, ви задеплоїте контейнер, який не стартує. Лікується одним рядком: "rootDir": "./src". Після нього збірка чиста, файли там, де були.

tsconfig: TypeScript 5.x → TypeScript 7ОпціяTypeScript 5.xTypeScript 7typesусі @types самілише переліченіrootDirспільна папка (src)папка tsconfig (./)strictвимкненоувімкненоside-effect імпортине перевіряютьсяперевіряютьсяbaseUrlпрацюєпомилкаmoduleResolution nodeпрацюєпомилкаНові значення з'явились у 6.0, видалені опції стали помилками в 7.0

Що ще варто знати про нові значення за замовчуванням:

  • strict: true. Якщо ви ніколи не вмикали strict, після оновлення помилок може стати сотні. Тимчасово поставте "strict": false явно і вмикайте прапорці по одному, а не все одразу.
  • module: esnext і target — остання стабільна версія ECMAScript. Якщо ви покладались на значення за замовчуванням, а не писали їх явно, вивід зміниться.
  • Повністю видалені опції: target: es5, downlevelIteration, module зі значеннями amd, umd, systemjs, none, esModuleInterop: false, moduleResolution: classic і node10. Повний список — в анонсі 7.0.
  • Шаблонні літеральні типи тепер не розрізають емодзі та інші символи поза базовою площиною Unicode навпіл. Якщо у вас є «хитрі» типи для довжини рядка на рівні типів, перевірте їх.

Для Next.js-проєктів новина краща. Конфіг, який генерує create-next-app, уже використовує moduleResolution: "bundler" і не має baseUrl, а next-env.d.ts підтягує типи Next.js. Саме тому на цьому сайті TypeScript 7 пройшов без жодної правки в tsconfig.

Чи переходити зараз: коротке дерево рішень

Не всім проєктам варто оновлюватись цього тижня. Ось як я вирішую:

Переходити на TypeScript 7 зараз?перевіряйте зверху вниз, перше «так» — ваша відповідьТрансформери, ts-morph, кодогенерація?такЧекайте 7.1 і новий APIVue, Svelte, Astro, MDX чи Angular?такTS 7 у CI, TS 6 у редакторіtypescript-eslint з правилами на типах?такTS 7 + аліас для ESLintНічого з переліченогоПереходьте на 7.0 зараз
  • Next.js або Node.js, ESLint без перевірок на основі типів — переходьте зараз. Це година роботи, а виграш щоденний.
  • Є typescript-eslint з правилами на основі типів (recommendedTypeChecked, no-floating-promises) — переходьте з аліасом, про нього нижче.
  • Vue, Svelte, Astro, MDX або шаблони Angular — для tsc у CI можна вже зараз, а в редакторі лишайте TypeScript 6 до 7.1. Саме для таких файлів у 7.1 з'явились content mappers.
  • Власні трансформери, ts-morph, генератори коду, що роблять require("typescript") — чекайте 7.1, а потім переписуйте під новий API. Сумісності зі старим не буде.

Хто у вас звертається до API компілятора, показує скрипт нижче. Зазвичай список довший, ніж ви очікуєте.

Next.js: що робить next build з TypeScript 7

Починаючи з Next.js 16.3, next build не завантажує API компілятора, а запускає локальний tsc окремим процесом. Документація useTypeScriptCli описує це як поведінку за замовчуванням, тож оновлення — одна команда:

bash
npm install -D typescript@^7

Для гілки 16.2 є бекпорт: там CLI-режим треба ввімкнути прапорцем experimental.useTypeScriptCli: true. Без нього next build з TypeScript 7 падав без пояснень (SIGSEGV або SIGABRT), тож оновлюйтесь до останнього патча гілки.

Три нюанси CLI-режиму, які варто знати до першого червоного білду:

  • помилки друкує сам tsc, без звичних code frame від Next.js;
  • перевіряється весь проєкт, який описує tsconfig, разом із тестами і .next/dev/types, а не лише файли збірки;
  • typescript.ignoreBuildErrors вимикає й цей крок.

Пастка з ESLint і аліасом

Тепер найцікавіше. Якщо у вас є typescript-eslint, то після npm i -D typescript@7 спершу побачите попередження npm, а потім:

text
typescript-eslint does not support TS 7.0.
Please see https://devblogs.microsoft.com/typescript/announcing-typescript-7-0/#running-side-by-side-with-typescript-6.0 to run typescript-eslint using the TS 6 API.

Oops! Something went wrong! :(
Error: typescript-eslint does not support TS 7.0.

typescript-eslint 8.72.2 має peerDependencies: typescript >=4.8.4 <6.1.0. Підтримку 7.1 роблять: 29 вересня мейнтейнер написав, що WIP-версія стає дедалі стабільнішою, але попередив, що перша версія буде приблизно такою ж швидкою, як на TypeScript 6. ESLint бракує API для пакетних запитів типів.

Офіційне рішення від команди TypeScript — два пакети під різними назвами:

json
{
  "devDependencies": {
    "typescript": "npm:@typescript/typescript6@^6.0.2",
    "@typescript/native": "npm:typescript@^7.0.2",
    "typescript-eslint": "^8.72.2"
  }
}

Перевіряємо:

text
$ npx tsc -v
Version 7.0.2
$ npx tsc6 -v
Version 6.0.3
$ node -p "require('typescript').version"
6.0.3

Команда tsc веде на TypeScript 7, а require("typescript") віддає API шостої версії, тож ESLint працює. Здається, все вирішено, чи не так?

А тепер next build з таким package.json:

text
  Running TypeScript ...
  Finished TypeScript in 7.1s ...

Не 1,26 с, а 7,1. Я заглянув у next/dist/lib/typescript/runTypeScriptCli.js (Next.js 16.3.8): він шукає typescript/package.json і запускає бінарник з поля bin цього пакета — tsc або tsc6. Під назвою typescript тепер лежить шоста версія, тож збірка мовчки перевіряє типи старим компілятором. Нічого не ламається, просто прискорення зникає, і ніхто цього не помічає.

package.json"typescript": @typescript/typescript6"@typescript/native": typescript@7.0.2npx tsc→ @typescript/nativeTypeScript 7 · швидкоESLintrequire("typescript")API 6.0.3 · працюєnext buildtypescript/package.jsontsc6 · 7,1 с, не 1,26Аліас лагодить ESLint, але next build тихо повертається на TS 6

Робочий варіант: перевіряти типи окремим кроком через tsc сьомої версії, а в next build цей крок вимкнути. Тільки якщо CI запускає typecheck до збірки:

json
{
  "scripts": {
    "typecheck": "tsc --noEmit",
    "lint": "eslint .",
    "build": "next build"
  }
}
ts
import type { NextConfig } from "next";

const nextConfig: NextConfig = {
  typescript: { ignoreBuildErrors: process.env.CI === "true" },
};

export default nextConfig;

У CI порядок такий: npm run typecheck && npm run lint && npm run build. GitHub Actions виставляє CI=true сам. Там, де змінної немає, наприклад локально, next build далі перевіряє типи сам, просто повільніше. Хочете простіше? Залиште як є і прийміть повільний крок у next build до виходу typescript-eslint з підтримкою 7.1. Обидва варіанти чесні, головне — знати, який із них у вас.

Що дає 7.1 Beta і чи ставити її вже

7.1 Beta встановлюється через npm i -D typescript@beta. Головне в ній:

  • Новий API: точки входу typescript/sync, typescript/async, typescript/ast та інші. Об'єкти API і Program реалізують Disposable, тож їх треба закривати через using, інакше пам'ять тече на боці Go. Це новий контракт: старі скрипти доведеться переписати.
  • Content mappers для .vue, .svelte, .astro, .mdx — офіційна точка розширення замість хаків.
  • Ще швидше: на mui-docs перевірка скоротилась з 22,2 до 11,9 с, а пам'ять — з 8 093 до 4 079 МБ. У мене на копії сайту вийшло 1,14 с проти 1,40 на 7.0.
  • --target es2026 стабільний.
  • Одна breaking-зміна в типах: у гілці дистрибутивного умовного типу параметр тепер вважається новим, вужчим типом, тож деякі складні generic-типи почнуть падати.

З es2026 є пастка, яку легко проґавити. TypeScript перевіряє типи, але нічого не поліфілить. Ось код, що використовує Map.prototype.getOrInsertComputed і Error.isError з ES2026:

ts
type Order = { customer: string; total: number };

const orders: Order[] = [
  { customer: "acme", total: 120 },
  { customer: "globex", total: 75 },
  { customer: "acme", total: 30 },
];

const byCustomer = new Map<string, number[]>();
for (const o of orders) {
  byCustomer.getOrInsertComputed(o.customer, () => []).push(o.total);
}

console.log(Object.fromEntries(byCustomer));
console.log(Error.isError(new TypeError("boom")), Error.isError({ message: "boom" }));

З "target": "es2026" компілюється чисто. На Node.js 26:

text
{ acme: [ 120, 30 ], globex: [ 75 ] }
true false

На Node.js 24 той самий файл падає:

text
TypeError: byCustomer.getOrInsertComputed is not a function

Я перевірив кожен API зі списку ES2026 у трьох версіях Node:

API Node 24.22 Node 25.7 Node 26.13
Error.isError, Array.fromAsync, JSON.rawJSON так так так
Uint8Array.fromBase64 ні так так
Iterator.concat, Map#getOrInsertComputed ні ні так
Math.sumPrecise ні ні ні

Висновок: target і lib описують середовище, в якому код запускатиметься, а не версію TypeScript. Якщо продакшен на Node 24, лишайте es2024 або менше. Як переходити на Node 26 і що там нового, я розібрав у гайді з оновлення Node.js 26.

Чи ставити 7.1 Beta в продакшен-CI? Я б не став. Але прогнати її локально на своєму проєкті — п'ять хвилин, і ви одразу побачите, чи зачепить вас зміна з дистрибутивними типами.

Скрипт перевірки: знайдіть проблеми до оновлення

Щоб не ловити помилки по одній, я написав скрипт, який читає tsconfig і node_modules і показує все одразу: видалені опції, неправильні paths, відсутні rootDir і types, пакети, що використовують API компілятора. Запускається напряму з Node.js 22.18+ (TypeScript-файли без збирання):

ts
import { readFileSync, readdirSync, existsSync } from "node:fs";
import { join } from "node:path";

type Finding = { level: "error" | "warn"; message: string };

function readJsonc(path: string): any {
  const text = readFileSync(path, "utf8");
  let out = "";
  let inString = false;
  for (let i = 0; i < text.length; i++) {
    const c = text[i];
    if (inString) {
      out += c;
      if (c === "\\") out += text[++i];
      else if (c === '"') inString = false;
    } else if (c === '"') {
      inString = true;
      out += c;
    } else if (c === "/" && text[i + 1] === "/") {
      while (i < text.length && text[i] !== "\n") i++;
      out += "\n";
    } else if (c === "/" && text[i + 1] === "*") {
      i = text.indexOf("*/", i + 2) + 1;
    } else out += c;
  }
  return JSON.parse(out.replace(/,\s*([}\]])/g, "$1"));
}

const removed: Record<string, (v: unknown) => boolean> = {
  baseUrl: () => true,
  downlevelIteration: () => true,
  target: (v) => /^es(3|5)$/i.test(String(v)),
  moduleResolution: (v) => /^(node|node10|classic)$/i.test(String(v)),
  module: (v) => /^(amd|umd|system|systemjs|none)$/i.test(String(v)),
  esModuleInterop: (v) => v === false,
  allowSyntheticDefaultImports: (v) => v === false,
  alwaysStrict: (v) => v === false,
};

function checkTsconfig(dir: string): Finding[] {
  const findings: Finding[] = [];
  const config = readJsonc(join(dir, "tsconfig.json"));
  const opts = config.compilerOptions ?? {};
  if (config.extends) findings.push({ level: "warn", message: `extends "${config.extends}": check that file too` });

  for (const [key, isRemoved] of Object.entries(removed)) {
    if (key in opts && isRemoved(opts[key])) findings.push({ level: "error", message: `${key}: ${JSON.stringify(opts[key])} is removed in TS 7` });
  }
  for (const [alias, targets] of Object.entries<string[]>(opts.paths ?? {})) {
    for (const t of targets) {
      if (!t.startsWith("./") && !t.startsWith("../")) findings.push({ level: "error", message: `paths["${alias}"] → "${t}" must start with ./` });
    }
  }
  if (opts.outDir && !opts.rootDir) findings.push({ level: "warn", message: "outDir without rootDir: TS 7 defaults rootDir to ./ (dist/src/...)" });
  if (!opts.types) {
    const typesDir = join(dir, "node_modules", "@types");
    const installed = existsSync(typesDir) ? readdirSync(typesDir) : [];
    findings.push({ level: "warn", message: `no "types": TS 7 loads none by default; installed @types: ${installed.join(", ") || "none"}` });
  }
  if (opts.strict === undefined) findings.push({ level: "warn", message: "strict is not set: TS 7 turns it on" });
  return findings;
}

function apiConsumers(dir: string): string[] {
  const root = join(dir, "node_modules");
  if (!existsSync(root)) return [];
  const names = readdirSync(root).flatMap((n) => (n.startsWith("@") ? readdirSync(join(root, n)).map((s) => `${n}/${s}`) : [n]));
  return names.filter((name) => {
    const pkgPath = join(root, name, "package.json");
    if (!existsSync(pkgPath) || name === "typescript") return false;
    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
    return Boolean(pkg.peerDependencies?.typescript ?? pkg.dependencies?.typescript);
  });
}

const dir = process.argv[2] ?? ".";
const findings = checkTsconfig(dir);
for (const f of findings) console.log(`${f.level === "error" ? "ERROR" : "warn "}  ${f.message}`);
const consumers = apiConsumers(dir);
if (consumers.length) console.log(`warn   packages that load the TypeScript API: ${consumers.join(", ")}`);
console.log(`\n${findings.filter((f) => f.level === "error").length} errors, ${findings.filter((f) => f.level === "warn").length + (consumers.length ? 1 : 0)} warnings`);
process.exitCode = findings.some((f) => f.level === "error") ? 1 : 0;

Запуск на тому самому Node API з 2023 року (з коментарем і висячою комою в tsconfig, як це зазвичай буває):

text
$ node ts7-preflight.ts legacy
ERROR  baseUrl: "." is removed in TS 7
ERROR  moduleResolution: "node" is removed in TS 7
ERROR  paths["@lib/*"] → "src/lib/*" must start with ./
warn   outDir without rootDir: TS 7 defaults rootDir to ./ (dist/src/...)
warn   no "types": TS 7 loads none by default; installed @types: estree, istanbul-lib-coverage, istanbul-lib-report, istanbul-reports, jest, json-schema, node, stack-utils, yargs, yargs-parser
warn   strict is not set: TS 7 turns it on
warn   packages that load the TypeScript API: @typescript-eslint/eslint-plugin, @typescript-eslint/parser, @typescript-eslint/project-service, @typescript-eslint/tsconfig-utils, @typescript-eslint/type-utils, @typescript-eslint/typescript-estree, @typescript-eslint/utils, ts-api-utils, typescript-eslint

3 errors, 4 warnings

Зверніть увагу на список @types: з десяти пакетів вам потрібні два (node і jest), решта — транзитивні залежності. Саме тому types: [] за замовчуванням — це добре. Скрипт не замінює tsc, він лише збирає все в один список, щоб ви оцінили обсяг роботи до того, як почнете. Код виходу 1 при помилках, тож його можна поставити в CI як перевірку на тиждень міграції.

План міграції на тиждень

Для типового Next.js або Node.js проєкту середнього розміру:

  1. день 1
    Аудитскрипт перевірки, чистий білд на TS 6.0
  2. день 1
    tsconfigrootDir, types, paths, moduleResolution
  3. день 2
    Інструментиаліас для ESLint, окремий typecheck
  4. дні 3–5
    CI поручTS 7 і TS 6 паралельно, порівняти помилки
  5. після 7.1
    Прибрати аліасколи typescript-eslint підтримає 7.1
Міграція на TypeScript 7: план на тиждень
  1. Чистий білд на TypeScript 6.0. Якщо ви ще на 5.x, спершу оновіться до 6.0 і приберіть усі попередження про застарілі опції. Команда TypeScript прямо радить цей крок: якщо код чисто компілюється на 6.0 без ignoreDeprecations, на 7.0 він компілюватиметься так само.
  2. Скрипт перевірки — і виправлення tsconfig за його списком: rootDir, types, paths, moduleResolution.
  3. Інструменти. Є typescript-eslint з правилами на основі типів — аліас і окремий typecheck. Є Vue, Svelte чи MDX — TypeScript 7 лише для CLI.
  4. CI паралельно. Тиждень запускайте і tsc6 --noEmit, і tsc --noEmit. Різниця в помилках — сигнал розібратися до того, як прибрати шосту версію.
  5. Порівняйте вивід збірки, якщо tsc генерує JavaScript: diff -r старого і нового dist швидко покаже, чи не змінились шляхи або target.
  6. Після виходу 7.1 і typescript-eslint з її підтримкою — приберіть аліас, і next build знову перевірятиме типи сам.

Окремо про ШІ-асистентів. Якщо ваш проєкт пишуть разом з Cursor чи Claude Code, швидкий tsc — найдешевші рейки, які можна поставити: агент перевіряє кожну правку за секунду замість семи. Про такі рейки для застосунків, зібраних із ШІ, я писав у статті про вайбкодинг MVP.

Чек-лист перед оновленням

  • Проєкт чисто збирається на TypeScript 6.0 без ignoreDeprecations
  • Немає baseUrl, усі шляхи в paths починаються з ./
  • moduleResolution — nodenext або bundler
  • rootDir вказано явно, якщо є outDir
  • types перелічено явно (node, jest, vitest/globals...)
  • strict вказано явно, true або тимчасово false
  • Знаєте всі пакети, що роблять require("typescript")
  • Для typescript-eslint налаштовано аліас, tsc -v показує 7.x
  • next build перевіряє типи справді через TypeScript 7 (час кроку TypeScript у лозі) або CI запускає typecheck окремо
  • target і lib відповідають версії Node.js у продакшені, а не версії TypeScript
  • CI падає на коді виходу 2, а не лише 1

Що зробити цього тижня

Запустіть скрипт перевірки на своєму репозиторії. Якщо помилок нуль або дві-три — переходьте на 7.0 сьогодні, це година роботи. Якщо список довгий, почніть з TypeScript 6.0 і поверніться до сьомої версії разом із 7.1.

А якщо у вас Next.js-продукт, де оновлення фреймворку, TypeScript і Node.js накопичились і ніхто не хоче чіпати конфіг, — це звична для мене робота. Детальніше про те, як я веду такі проєкти, на сторінці розробки на Next.js, а як влаштувати App Router у продакшені — у гайді з App Router.

Було корисно?

– вподобань · – переглядів

LinkedInXTelegramFacebook
Потрібно таке для вашого продукту?Розробка на Next.js і Node.js — від бази даних до інтерфейсуДетальніше →

Часті запитання

Чи готовий TypeScript 7 до продакшену?

Так, для перевірки типів і збирання. TypeScript 7.0 вийшов 8 липня 2026 року як стабільний реліз, актуальна версія 7.0.2. Обмеження одне: у 7.0 немає JavaScript API, тому інструменти, які роблять require('typescript'), як-от typescript-eslint, поки працюють на TypeScript 6 через npm-аліас.

Чи підтримує Next.js TypeScript 7?

Так. Починаючи з Next.js 16.3 (3 серпня 2026) next build перевіряє типи через локальний tsc, тому достатньо встановити typescript@^7. У гілці 16.2 те саме вмикається прапорцем experimental.useTypeScriptCli. Помилки типів тоді друкує сам tsc, без форматування Next.js.

Чому ESLint падає після оновлення на TypeScript 7?

typescript-eslint 8.x вимагає typescript нижче 6.1 і завантажує JavaScript API компілятора, якого у 7.0 немає. Рішення від команди TypeScript: поставити під назвою typescript пакет @typescript/typescript6, а TypeScript 7 — під іншою назвою, наприклад @typescript/native.

Чи треба спершу переходити на TypeScript 6?

Рекомендовано. Усе, що в 6.0 позначено як застаріле, у 7.0 стало помилкою. Якщо проєкт чисто компілюється на 6.0 без ignoreDeprecations, перехід на 7.0 зазвичай зводиться до кількох рядків у tsconfig.

Коли вийде TypeScript 7.1?

7.1 Beta вийшла 20 жовтня 2026 року. Команда обіцяла Release Candidate приблизно через місяць і фінальний реліз невдовзі після нього, тобто орієнтовно кінець 2026 року. Точних дат в анонсі немає.