Платформа

Платформа определяет целевую среду выполнения для собранного JavaScript-кода.

По умолчанию tsdown собирает код для среды выполнения node, но вы можете настроить это с помощью опции --platform:

tsdown --platform node    # по умолчанию
tsdown --platform browser
tsdown --platform neutral

Доступные платформы

• node: Предназначен для среды выполнения Node.js и совместимых окружений, таких как Deno и Bun. Это платформа по умолчанию, где встроенные модули Node.js (например, fs, path) разрешаются автоматически. Идеально подходит для инструментальных цепочек или серверных проектов.
• browser: Нацелен на веб-браузеры (например, Chrome, Firefox). Это подходит для фронтенд-проектов. Если ваш код использует встроенные модули Node.js, будет отображено предупреждение, и вам может потребоваться использовать полифиллы или прослойки для обеспечения совместимости.
• neutral: Универсальный режим без привязки к конкретной среде выполнения. Используйте это, если ваш код предназначен для работы в нескольких средах или вы хотите полностью контролировать поведение среды выполнения. Это особенно полезно для библиотек или переиспользуемого кода, который может использоваться как в Node.js, так и в браузерах.

NOTE

Для формата CJS платформа всегда установлена как 'node' и не может быть изменена.

Пример

# Сборка для Node.js (по умолчанию)
tsdown --platform node

# Сборка для браузеров
tsdown --platform browser

# Сборка для нейтральной платформы
tsdown --platform neutral

TIP

Выбор правильной платформы гарантирует, что ваш код оптимизирован для предполагаемой среды выполнения. Например, используйте browser для фронтенд-проектов, node для серверных приложений и neutral для универсальных библиотек.