Перейти к содержанию
ERITKOM
ВебНовость

htmx 4.0.1 исправляет гонку запросов, частичные ответы и историю переходов

Обновление новой ветки устраняет случаи, когда старый ответ перекрывал свежий. При этом htmx 4 пока не заменяет 2.x под тегом latest в npm.

Настоящий логотип библиотеки htmx
HTMX / Wikimedia Commons, Zero-Clause BSD. Изменены размер и формат. Логотип проекта, не снимок интерфейса релиза.

Исправления относятся к четвёртой ветке

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

Библиотека позволяет задавать сетевое взаимодействие атрибутами HTML: элемент отправляет запрос, а полученная разметка обновляет нужную часть страницы. Такой подход отличается от полной перезагрузки документа и не требует превращать каждый переход в отдельное клиентское приложение. Но корректность порядка ответов и истории при этом становится частью поведения интерфейса, заметной обычному пользователю.

Как отменённый запрос мешал новому

Одна из исправленных ошибок связана с hx-sync в режиме replace. Более старый ответ мог перезаписать свежий результат. В первичном запросе на изменение причина описана точнее: очистка отменённого запроса могла убрать из очереди запись о текущем активном запросе. Последующий вызов терял возможность правильно отменить его.

Исправление проверяет, какой именно запрос владеет очередью, прежде чем очищать её. Это важно отличать от общего запрета параллельных запросов: библиотека сохраняет выбранную стратегию, но устраняет ошибку управления её состоянием. Сам PR был объединён ещё в сентябре; ноябрьская новость — выпуск версии, включающей исправление, а не внезапное обнаружение новой проблемы в этот день.

Проверка поля и отправка формы могут конкурировать

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

Именно поэтому выражение «последний запрос победил» должно описывать не только момент отправки, но и то, какой ответ изменяет документ. В справочнике также разделены обновление целевого элемента, несколько обновляемых фрагментов и история переходов. Эти механизмы существовали как части модели взаимодействия; релиз 4.0.1 не объявляет их все новыми возможностями с нуля.

Частичный ответ не должен очищать всю страницу

В новом выпуске исправлен случай, когда ответ, содержащий только hx-partial, очищал body. Для частичных обновлений добавлена корректная обработка ignoreTitle. Отдельно улучшена надёжность переходов назад и вперёд и исправлена отметка POST в hx-history-cache. Эти пункты относятся к разным участкам обработки ответа, хотя пользователь мог воспринимать их как одну нестабильную навигацию.

В списке также есть работа hx-trigger на boosted-элементах, фильтр периодического every и несколько модификаторов changed на одном элементе. Исправления не являются измерением скорости сайта и не говорят, что любая форма использовала каждый из затронутых механизмов. Состав обновления следует сопоставлять с конкретными атрибутами приложения.

Почему npm latest всё ещё не означает htmx 4

Официальная главная отдельно сообщает: четвёртая ветка выпущена, но пока не помечена latest в npm, чтобы пользователи 2.x не получили случайное основное обновление. Перенос тега запланирован на некоторый момент 2027 года, без точного дня в этом сообщении. Номер свежего релиза на GitHub и значение тега пакета — разные сведения.

Для перехода существует отдельная документация htmx 4, включая руководство миграции и слой совместимости. Поэтому стандартная установка без явного выбора версии не должна описываться как доказательство перехода на новую ветку. Публикация основана на release notes, описании исходного исправления и документации; собственный прогон пользовательских приложений здесь не проводился.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача