Ответ.

История вопроса: В JavaScript функции часто используют деструктуризацию объектов прямо в сигнатуре. В TypeScript такой подход требует чёткого описания структуры деструктурируемых параметров и постановки дефолтных значений — иначе возможны ошибки при обращении к несуществующим свойствам и неверный вывод типов.

Проблема: Неочевидно, как правильно описывать тип всего параметра или отдельных вложенных свойств в деструктурируемом объекте, особенно при наличии необязательных и вложенных полей, а также значениях по умолчанию.

Решение: Всегда описывайте отдельный тип или интерфейс для структуры параметров функции, явно указывайте, какие поля обязательны, какие — опциональны, а дефолтные значения задавайте в теле функции или прямо в параметрах с помощью ES6-синтаксиса.

Пример кода:

interface UserOptions {
  name: string;
  age?: number;
  address?: { city: string; zipcode?: string };
}

function registerUser(
  { name, age = 18, address = { city: 'Unknown' } }: UserOptions
): string {
  return `${name}, ${age}, ${address.city}`;
}

Ключевые особенности:

• Для деструктуризации вложенных параметров обязательно используйте интерфейс или тип.
• Дефолтные значения полей задавайте в сигнатуре функции.
• Для опциональных свойств (age?, address?) всегда продумайте сценарии, где они могут отсутствовать.

Вопросы с подвохом.

Можно ли опускать описание типа объекта-параметра — полагаясь на автоматический вывод?

Нет, это опасно. Если не указывать тип UserOptions, компилятор не подскажет про обязательные свойства, дефолтные значения не будут подхвачены для вложенных полей, появятся неявные ошибки на этапе использования.

function example({ x, y }) { ... } // x и y — any

Как задать дефолтное значение для вложенного объекта, частично подменяя свойства?

Используйте spread. Однако spread не "склеивает" типы, если тип address опционален. Надо выполнить проверку или задать дефолт явно.

function fn({ obj = { foo: 1 } }: { obj?: { foo: number } }) {
  const address = { foo: 42, ...obj };
}

Чем опасна деструктуризация с опциональными полями без дефолта?

Если опустить дефолт у опциональных свойств, обращения к свойствам (например, address.city) могут привести к ошибкам выполнения. Лучше явно ставить ? и дефолт.

function danger({ address }: { address?: { city: string } }) {
  console.log(address.city); // Ошибка, address может быть undefined
}

Типовые ошибки и анти-паттерны

• Неявная типизация деструктурируемых аргументов (any)
• Отсутствие дефолта для вложенных/опциональных свойств
• Неиспользование интерфейсов и type alias для структурных параметров

Пример из жизни

Негативный кейс

В старом коде деструктурировали объект параметров без явной типизации. При добавлении нового поля в функцию все места использования не были найдены автоматически, ломались вызовы на продакшене.

Плюсы:

• Быстро и просто писать

Минусы:

• Отсутствие безопасности и контроля над структурой
• Хрупкость при изменениях

Позитивный кейс

Внедрили интерфейсы для всех таких функций, покрыли тестами сценарии с undefined и дефолтными значениями, подсказки компилятора позволили легко вносить массовые изменения.

Плюсы:

• Высокая безопасность типов
• Простота рефакторинга и масштабирования

Минусы:

• Чуть больше текста в декларациях типов