Как понимаешь что требует функция

Функция требует анализа её сигнатуры, документации и поведения. Вот ключевые шаги:

1. Параметры — смотрим аргументы, их типы и обязательность:

function formatDate(date: Date, withTime?: boolean) { ... }
// Требует Date и опционально boolean

2. Возвращаемое значение — что функция возвращает (тип, структура).

3. Документация/JSDoc — описание назначения:

/**
 * Форматирует число в денежный формат
 * @param {number} sum - Сумма
 * @param {string} currency - Валюта (USD/RUB)
 */

4. Исходный код — если доступен, анализируем логику.

5. Примеры использования — как вызывается в коде.

6. Поведение — сайд-эффекты, ошибки, edge-cases.

Для сложных случаев используйте TypeScript или runtime-валидацию (Zod, Joi).