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

Проблема: неправильный дизайн функции

Корень проблемы — в том, что вы используете позиционные параметры для опциональных аргументов. Это антипаттерн, особенно когда параметров больше 2-3. Решение — перейти на объект-конфигурацию с именованными свойствами.

Решение: используйте объект параметров (options object)

В TypeScript для этого принято использовать интерфейс или тип, описывающий все опциональные параметры как необязательные свойства объекта:

interface ConnectionOptions {
  port?: number;
  username?: string;
  password?: string;
  database?: string;
}

function createConnection(
  host: string,
  options: ConnectionOptions = {}
): Connection {
  const { port, username, password, database } = options;
  // ... реализация
}

Теперь вы можете вызывать функцию, передавая только нужные параметры:

// Передаём только host и password с database
createConnection('localhost', {
  password: 'secret123',
  database: 'mydb'
});

// Можно вообще ничего не передавать, кроме host
createConnection('localhost');

Продвинутый вариант: строгая типизация с Partial

Если у вас уже есть интерфейс с обязательными и необязательными полями, используйте встроенный утилитарный тип Partial<T>:

interface Config {
  host: string;
  port: number;
  username: string;
  password: string;
  database: string;
}

function createConnection(config: Partial<Config>): Connection {
  // config.host может быть undefined, поэтому проверяем
  if (!config.host) throw new Error('Host is required');
  // ... остальная логика
}

Альтернатива: перегрузка функций

Если количество комбинаций параметров ограничено, можно использовать перегрузку (overloads):

function createConnection(host: string, password: string, database: string): Connection;
function createConnection(host: string, port: number, username: string): Connection;
function createConnection(host: string, ...args: any[]): Connection {
  // Реализация с проверкой типов args
}

Но это решение становится громоздким при увеличении числа параметров.

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

Обязательные параметры (без которых функция не имеет смысла) оставляйте позиционными, а все опциональные — собирайте в объект:

function createConnection(
  host: string,
  port?: number,  // часто используемый, можно оставить позиционным
  options?: {
    username?: string;
    password?: string;
    database?: string;
    ssl?: boolean;
    timeout?: number;
  }
): Connection;

Вызов:

createConnection('localhost', 5432, { 
  username: 'admin', 
  database: 'mydb' 
});

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

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

const SKIP = Symbol('skip');

function createConnection(
  host: string,
  port?: number | typeof SKIP,
  username?: string | typeof SKIP
) {
  const actualPort = port === SKIP ? undefined : port;
  const actualUsername = username === SKIP ? undefined : username;
}

Но это костыль. Лучше сразу проектировать API с объектом параметров.

Итог

• Не используйте длинные цепочки позиционных необязательных параметров — это нечитаемо и чревато ошибками.
• Используйте объект-конфигурацию с интерфейсом или типом.
• Обязательные параметры оставляйте позиционными, опциональные — в объекте.
• Partial<T> — ваш друг, если нужно сделать все поля интерфейса необязательными.

// Исходная функция (нельзя менять)
function legacyCreateConnection(
  host: string,
  port?: number,
  username?: string,
  password?: string,
  database?: string
) { /* ... */ }

// Функция-обёртка с объектом параметров
interface Params {
  host: string;
  port?: number;
  username?: string;
  password?: string;
  database?: string;
}

function createConnection(params: Params) {
  const { host, port, username, password, database } = params;
  return legacyCreateConnection(host, port, username, password, database);
}

// Использование
createConnection({
  host: 'localhost',
  password: 'secret',
  database: 'mydb'
});

type ConnectionParams = [string] | [string, number] | [string, number, string] | [string, number, string, string, string];

function createConnection(...args: ConnectionParams) {
  const [host, port, username, password, database] = args;
  // ... реализация
}