Начиная с Deno 1.0.0, API пространства имён Deno стабильны. Это означает, что мы будем стремиться к тому, чтобы код, работающий в версии 1.0.0, продолжал работать и в будущих версиях.

График выпусков, каналы и долгосрочная поддержка

Deno выпускает новую стабильную минорную версию (например, v2.1.0, v2.0.0) каждые 12 недель.

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

Каналы выпуска

Deno распространяется по четырём каналам выпуска. Каждый канал — это независимая ветка со своей версией «latest» и местом загрузки, поэтому переход по одной ветке никак не влияет на другую:

• stable — минорные версии и версии с исправлениями по semver, как описано выше. Это канал по умолчанию, рекомендуемый большинству пользователей. Стабильные сборки можно загрузить со страницы выпусков на GitHub.
• lts — долгосрочная поддержка: одна стабильная минорная ветка, в которую включаются только обратно совместимые исправления ошибок. Рекомендуется корпоративным пользователям, которые предпочитают обновляться реже. См. раздел Долгосрочная поддержка.
• rc — кандидат на выпуск предстоящей минорной версии по semver.
• canary — нестабильная сборка, которая меняется несколько раз в день. С её помощью можно опробовать последние исправления ошибок и функции до того, как они попадут в stable.

Во время цикла предварительных выпусков новой основной версии (например, 3.0) Deno также публикует каналы alpha и beta. Все каналы, кроме stable, доступны на сервере загрузок Deno по адресу dl.deno.land.

Выбор канала

Установленная версия Deno относится ровно к одному каналу, который встраивается в двоичный файл при его сборке. deno upgrade считывает канал текущего двоичного файла, чтобы определить значение «latest»; на основе тех же данных формируется и периодически отображаемое уведомление об обновлении. Например, двоичный файл LTS выводит сообщение A new LTS release of Deno is available и предлагает выполнить команду deno upgrade lts.

Сам по себе номер версии не определяет канал. Одна и та же версия может выпускаться в двух побайтно различающихся сборках: например, 2.9.3 существует и как стабильный выпуск, и как выпуск LTS. Эти сборки созданы из одного и того же исходного кода и содержат одинаковую строку версии; различаются они только встроенным маркером канала и местом загрузки. Нельзя запросить «сборку LTS версии 2.9.3» по номеру версии, поскольку строка версии у обеих сборок одинакова. Сборка выбирается по каналу, а не по версии; если указан только номер версии, всегда выбирается стабильная сборка.

Чтобы намеренно переключить канал, укажите его название, например deno upgrade lts или deno upgrade stable. Поскольку простой номер версии всегда выбирает стабильную сборку, пользователь LTS, выполнивший deno upgrade 2.9.3, загрузит стабильную сборку и перейдёт с канала lts на stable. Чтобы оставаться на LTS, обновляйтесь с помощью deno upgrade lts.

Название канала всегда соответствует самой новой сборке в этом канале, поэтому deno upgrade lts устанавливает последний выпуск LTS. Команды вида deno upgrade для установки более старой версии с исправлениями LTS не существует. Номер версии выбирает только стабильную сборку (или сборку rc, alpha, beta), но никогда — сборку LTS. Подробнее см. deno upgrade.

Долгосрочная поддержка (LTS)

Deno предлагает канал LTS (долгосрочная поддержка): одну стабильную минорную ветку, в которую мы включаем только обратно совместимые исправления ошибок. Он предназначен для корпоративных пользователей, которые предпочитают оставаться на одной ветке выпуска, не получая новые функции и критические изменения. Установите или обновите его с помощью deno upgrade lts.

Канал LTS действует для ветки Deno 2.9, начиная с v2.9.3, и будет поддерживаться до 31 января 2027 года.

В выпуски LTS с обратным переносом включаются:

• Исправления уязвимостей
• Критические исправления ошибок (например, аварийное завершение работы, неверные вычисления)
• Критические улучшения производительности могут включаться с учётом степени серьёзности.

Изменения API и новые основные функции не будут включаться с обратным переносом.

Нестабильные API

Новые API сначала помечаются как нестабильные. Это означает, что API может измениться в будущем. Эти API недоступны без явной передачи флага нестабильности, например --unstable-kv. Подробнее о флагах --unstable-*.

Некоторые функции Deno, не относящиеся к среде выполнения, также считаются нестабильными и доступны только с флагами нестабильности. Например, флаг --unstable-sloppy-imports используется для включения import кода без указания расширений файлов.

Стандартная библиотека

Стандартная библиотека Deno (jsr.io/@std) в основном стабильна. Все модули стандартной библиотеки версии 1.0.0 или выше считаются стабильными. Все остальные модули (0.x) считаются нестабильными и могут измениться в будущем.

Не рекомендуется использовать нестабильные модули стандартной библиотеки в рабочем коде, однако они отлично подходят для экспериментов с новыми функциями и передачи отзывов команде Deno. Для использования нестабильных модулей стандартной библиотеки флаги нестабильности не требуются.