Как передать часть опциональных параметров в функцию TypeScript, пропуская другие?

Лучшее решение: используйте именованные параметры через объект

Проблема с пропуском опциональных параметров — классическая боль JavaScript/TypeScript. Лучший способ её решить — передавать параметры в виде одного объекта. Это делает код самодокументируемым и избавляет от необходимости помнить порядок аргументов.

Базовый подход с интерфейсом

// Определяем интерфейс для параметров
interface ProfileOptions {
  age?: number;
  email?: string;
  isAdmin?: boolean;
}

// Функция принимает обязательный параметр и объект с опциями
function createProfile(username: string, options: ProfileOptions = {}): void {
  const { age, email, isAdmin } = options;
  
  console.log(`Username: ${username}`);
  if (age !== undefined) console.log(`Age: ${age}`);
  if (email !== undefined) console.log(`Email: ${email}`);
  if (isAdmin !== undefined) console.log(`Admin: ${isAdmin}`);
}

// Использование — передаём только нужные поля
createProfile("john_doe", { email: "john@example.com", isAdmin: true });
createProfile("alice", { age: 30 });
createProfile("bob"); // Только username

Почему это лучше?

• Порядок не важен — можно передать любую комбинацию параметров
• Читаемость — сразу видно, что за параметры передаются
• Расширяемость — легко добавить новый параметр без изменения сигнатуры
• Безопасность типов — TypeScript проверяет имена и типы полей

Продвинутый вариант: строгая типизация через Utility Types

// Можно использовать Partial для большей гибкости
function createProfileStrict(
  username: string,
  options: Partial<ProfileOptions> = {}
): void {
  // ... та же реализация
}

// Или Required, если нужно явно указать обязательные опции
interface StrictProfileOptions {
  age: number; // Теперь age обязателен, если передаётся объект
  email?: string;
  isAdmin?: boolean;
}

Альтернативный синтаксис: деструктуризация прямо в параметрах

interface ProfileParams {
  username: string;
  age?: number;
  email?: string;
  isAdmin?: boolean;
}

function createProfileDestructured({
  username,
  age,
  email,
  isAdmin
}: ProfileParams): void {
  console.log(`Username: ${username}`);
  if (age !== undefined) console.log(`Age: ${age}`);
  if (email !== undefined) console.log(`Email: ${email}`);
  if (isAdmin !== undefined) console.log(`Admin: ${isAdmin}`);
}

// Вызов
createProfileDestructured({ username: "john_doe", email: "john@example.com" });

Когда всё же стоит использовать позиционные параметры?

Иногда позиционные параметры оправданы — когда у функции всего 1-2 опциональных параметра, и они редко пропускаются. Например:

function greet(name: string, greeting?: string, punctuation?: string): string {
  const g = greeting ?? "Hello";
  const p = punctuation ?? "!";
  return `${g}, ${name}${p}`;
}

// Пропустить greeting и передать punctuation? Всё равно нужен undefined:
greet("John", undefined, "?"); // "Hello, John?"

Но для 3+ опциональных параметров объектный подход — единственный правильный путь.

Совет: используйте оператор нулевого слияния (??) для значений по умолчанию

function createProfileWithDefaults(
  username: string,
  options: ProfileOptions = {}
): void {
  const { age = 18, email = "noemail@example.com", isAdmin = false } = options;
  console.log(`${username} (${age}), email: ${email}, admin: ${isAdmin}`);
}

createProfileWithDefaults("guest"); // guest (18), email: noemail@example.com, admin: false

Этот подход полностью решает вашу проблему и является стандартом в TypeScript-сообществе. Он используется в React (хуки, пропсы), Angular (сервисы, конфигурации) и многих библиотеках.

function createProfile(username: string, email: string, isAdmin: boolean): void;
function createProfile(username: string, age: number, email: string): void;
function createProfile(username: string, age?: number, email?: string, isAdmin?: boolean): void {
  // Реализация остаётся общей
  console.log(`Username: ${username}`);
  if (age !== undefined) console.log(`Age: ${age}`);
  if (email !== undefined) console.log(`Email: ${email}`);
  if (isAdmin !== undefined) console.log(`Admin: ${isAdmin}`);
}

// Теперь возможны разные комбинации:
createProfile("john_doe", "john@example.com", true); // (username, email, isAdmin)
createProfile("alice", 30, "alice@example.com");     // (username, age, email)