TypeScript 5.7: полное руководство для веб-разработчиков

Перезапись путей: конец диссонанса между .ts и .js

Главная боль разработчиков на TypeScript всегда была в несоответствии между тем, что мы пишем (./helper.ts), и тем, что требует runtime (./helper.js). С появлением нативного выполнения TypeScript в Node.js 22 через --experimental-strip-types эта проблема стала критической.

Флаг —rewriteRelativeImportExtensions

TypeScript 5.7 наконец решает эту проблему. Новый компиляторный флаг автоматически переписывает относительные импорты с TypeScript-расширений на JavaScript-эквиваленты:

// Входной код (src/utils/helpers.ts)
export function formatDate(date: Date): string {
  return date.toLocaleDateString('ru-RU');
}

// Импорт в компоненте
import { formatDate } from './utils/helpers.ts';

// После компиляции с --rewriteRelativeImportExtensions:
import { formatDate } from './utils/helpers.js';

Конфигурация tsconfig.json

{
  "compilerOptions": {
    "target": "ES2024",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "rewriteRelativeImportExtensions": true,
    "allowImportingTsExtensions": true
  }
}

Эта комбинация позволяет писать код один раз и запускать его и в режиме разработки (через tsx/ts-node), и в production-сборке без дополнительных трансформаций.

Проверка инициализации: охота на скрытые баги

TypeScript всегда проверял использование переменных до присваивания. Но раньше этот анализ проваливался, если переменная использовалась внутри вложенной функции:

// TypeScript 5.6 и раньше — ошибки НЕТ
function processUserData() {
  let userData: UserData;
  
  if (someCondition()) {
    userData = fetchFromCache();
  }
  // Забыли else-ветку — userData не инициализирована!
  
  function renderProfile() {
    console.log(userData.name); // ⚠️ Баг проходил незамеченным
  }
  
  renderProfile();
}

TypeScript 5.7 теперь отслеживает поток данных даже через границы функций:

// TypeScript 5.7 — ошибка обнаружена
function processUserData() {
  let userData: UserData;
  // Ошибка: Variable 'userData' is used before being assigned.
  
  function renderProfile() {
    console.log(userData.name);
  }
}

Это особенно важно для React-компонентов с вложенными хендлерами и Vue-composables с внутренними функциями.

ECMAScript 2024: полная нативная поддержка

TypeScript 5.7 добавляет полную поддержку ES2024 через флаги --target es2024 и --lib es2024.

Promise.withResolvers()

Новый API для создания промисов с внешним контролем resolve/reject — идеален для абстракций над асинхронными процессами:

// До ES2024: приходилось изобретать велосипед
function createControlledPromise() {
  let resolve: (value: T) => void;
  let reject: (reason: unknown) => void;
  
  const promise = new Promise((res, rej) => {
    resolve = res;
    reject = rej;
  });
  
  return { promise, resolve: resolve!, reject: reject! };
}

// TypeScript 5.7 с ES2024 — нативно и типобезопасно
const { promise, resolve, reject } = Promise.withResolvers();

// Типы выводятся автоматически
resolve({ id: 1, name: 'Анна' }); // ✅
resolve('строка'); // ❌ Type error

Object.groupBy и Map.groupBy

Функциональная группировка коллекций без lodash:

const products = [
  { category: 'electronics', name: 'Наушники', price: 150 },
  { category: 'clothing', name: 'Футболка', price: 30 },
  { category: 'electronics', name: 'Зарядка', price: 25 }
];

// Группировка по категории
const byCategory = Object.groupBy(products, p => p.category);
// Тип: Record

// Результат:
// {
//   electronics: [{...}, {...}],
//   clothing: [{...}]
// }

Generic TypedArrays

TypedArrays теперь обобщены над ArrayBufferLike, что позволяет сохранять тип буфера при работе с бинарными данными:

// Uint8Array теперь имеет тип-параметр с дефолтом
interface Uint8Array {
  readonly buffer: TArrayBuffer;
  // ...
}

// Работа с SharedArrayBuffer для многопоточности
const sharedBuffer = new SharedArrayBuffer(1024);
const sharedView = new Uint8Array(sharedBuffer); // Uint8Array

// Обычный ArrayBuffer
const regularBuffer = new ArrayBuffer(1024);
const regularView = new Uint8Array(regularBuffer); // Uint8Array

V8 Compile Caching: 2.5× ускорение холодного старта

Node.js 22 представил API module.enableCompileCache(), который позволяет V8 кэшировать результаты парсинга и компиляции между запусками. TypeScript 5.7 использует этот API автоматически.

Результаты бенчмарков команды TypeScript:

Это ускорение особенно заметно в:

• CI/CD пайплайнах с частыми перезапусками
• Монорепозиториях с большим количеством файлов
• Editor extensions и language server

Изменения поведения: на что обратить внимание

Индексные сигнатуры для символьных методов

Классы с методами, определёнными через вычисляемые символьные ключи, теперь корректно генерируют индексные сигнатуры:

const processMethod = Symbol('process');

class DataProcessor {
  [processMethod](data: string): number {
    return data.length;
  }
}

// TypeScript 5.7: тип эквивалентен
// class DataProcessor {
//   [x: symbol]: (data: string) => number;
// }

Строгая проверка JSON-импортов

При использовании --module nodenext TypeScript теперь требует явного указания типа импорта и разрешает только дефолтный экспорт:

// ✅ Правильно
import config from './config.json' assert { type: 'json' };

// ❌ Ошибка: named exports не поддерживаются
import { setting } from './config.json' assert { type: 'json' };

// ❌ Ошибка: отсутствует assert
import config from './config.json';

Миграция с предыдущих версий

npm install -D typescript@5.7
# или
yarn add -D typescript@5.7
# или  
pnpm add -D typescript@5.7

npx tsc --noEmit
# Исправьте ошибки
# инициализации переменных

Лучшие практики 2026 года

1. Отказ от .js-расширений в импортах

Пишите ./utils.ts вместо ./utils.js. Компилятор сделает всё остальное.

2. Использование Promise.withResolvers для абстракций

Замените все самописные deferred-реализации на нативный API.

3. Активация strict проверок

Убедитесь, что включены strictNullChecks и noImplicitAny — тогда новая проверка инициализации переменных работает максимально эффективно.

4. Подготовка к Node.js без сборки

Изучите флаг --erasableSyntaxOnly (появился в TypeScript 5.8) — он готовит код к нативному выполнению в Node.js без транспиляции.

Чек-лист для аудита кода

Заключение

TypeScript 5.7 — это релиз, который размывает границу между разработкой и production. Возможность писать .ts и запускать без сборки, 2.5-кратное ускорение компиляции и охват 100% ES2024 делают TypeScript не просто надстройкой над JavaScript, а самодостаточной платформой.

Главные тезисы для внедрения:

• Перезапись путей устраняет последнее серьёзное трение в DX TypeScript
• Проверка инициализации ловит баги, которые раньше уходили в production
• ES2024 даёт современные абстракции без полифилов
• V8 Caching делает TypeScript конкурентоспособным по скорости с нативным JavaScript

Обновляйтесь. Пишите .ts. Не компилируйте лишний раз.

Удачной типизации! 🎯