Когда имеет смысл выносить константы в отдельный модуль?

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

Когда это имеет смысл?

• Многократное использование: Если одна и та же строка, число или объект используются в нескольких модулях, файлах или компонентах.
• Логическая группировка: Когда константы относятся к одной предметной области, например, настройки API (URL, ключи, таймауты), коды статусов, сообщения об ошибках или конфигурация UI (цвета, размеры).
• Упрощение изменений: Если значение может измениться в будущем (например, базовый URL API при смене окружения), его проще обновить в одном месте.
• Повышение читаемости: Именованные константы (например, MAX_RETRY_ATTEMPTS) понятнее, чем "магические числа" (например, 3), разбросанные по коду.

Практический пример

Рассмотрим пример на JavaScript/TypeScript. Вместо того чтобы хардкодить значения в разных файлах, мы создаем модуль constants.js или config.ts.

// constants/api.js
export const API_BASE_URL = 'https://api.example.com/v1';
export const API_TIMEOUT = 30000; // 30 секунд
export const DEFAULT_PAGE_SIZE = 20;

// constants/errors.js
export const ERROR_CODES = {
  NOT_FOUND: 404,
  UNAUTHORIZED: 401,
  SERVER_ERROR: 500
};

// constants/ui.js
export const COLORS = {
  PRIMARY: '#007bff',
  SUCCESS: '#28a745',
  DANGER: '#dc3545'
};

Теперь в любом компоненте или модуле приложения мы импортируем эти константы:

// userService.js
import { API_BASE_URL, DEFAULT_PAGE_SIZE } from '../constants/api';

async function fetchUsers(page = 1) {
  const response = await fetch(
    `${API_BASE_URL}/users?page=${page}&limit=${DEFAULT_PAGE_SIZE}`
  );
  return response.json();
}

Где применяется

Этот подход универсален и применяется практически во всех парадигмах программирования и стеках технологий: фронтенд (React, Vue, Angular), бэкенд (Node.js, Python, Java), а также в конфигурации сборки (Webpack) и настройках окружения.

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