Черновое ревью — май 2018: legacy jQuery

Статус: принято в публикационный слой 31 июля 2026 после независимого audit. Партия намеренно не перезаписывает web/data/articles.json: web/data/editorial-revisions.mjs накладывает ревизии только по стабильным slug.

Область партии

Slug	Главный вопрос	Основной текст, знаков
editorial-2018-05-practice-legacy-jquery	Как повторно вызвать mount и оставить один обработчик?	7 718
editorial-2018-05-mechanism-legacy-jquery	Почему прямой click пропадает после .html()?	8 088
editorial-2018-05-field-legacy-jquery	Как держать один активный Ajax-запрос формы?	8 729

Размеры посчитаны без списка источников и HTML-разметки. Каждый текст отвечает на один вопрос, начинает с наблюдаемого сбоя и заканчивается последовательностью действий с ограничениями.

Исследование

Все ссылки — первичная официальная документация jQuery; материалы сверены 31 июля 2026 года.

Статья	Источники
Повторный mount	.on(), .off()
Замена DOM	.html(), .on(), .off(), .data()
Ajax-форма	jQuery.ajax(), .serialize(), .prop(), .data(), .removeData(), deferred.always()

Ревью 1 — факты и техника

Пройдено.

Для mount проверены: пространства имён событий, снятие обработчиков по namespace, различие прямой и делегированной привязки, а также версия .on()/.off() — jQuery 1.7+.
Для .html() проверено основное утверждение: jQuery удаляет данные и события дочерних узлов до замены содержимого. Ограничения делегирования для SVG и не всплывающих событий названы явно. Риск вставки непроверенной HTML-строки не выдан за проблему конкретного API — это предупреждение документации.
Для Ajax-формы проверены: состав .serialize(), динамическое свойство disabled через .prop(), хранение и удаление маркера через .data()/.removeData(), роли done, fail и always у jqXHR. always используется только для освобождения UI и не анализирует разнородные аргументы resolve/reject.
Серверные последствия не выдуманы: клиентский замок ограничен текущим DOM-экземпляром; при timeout текст не обещает, что операция не была выполнена.

Ревью 2 — редактура и голос

Пройдено.

Речь короткая и техническая: симптом → причина → проверка → действие. Нет обещаний «универсального» решения и абстрактных вступлений о важности темы.
Голос соответствует 2018 году: код на jQuery, IIFE, var, $.ajax; без искусственного переноса поздних фреймворков или роли техлида в раннюю заметку.
У каждой статьи свой сценарий, таблица, воспроизводимый код и порядок внедрения. Три текста не повторяют один и тот же вывод под разными заголовками.
Убрано неподтверждённое обобщение о распространённости конкретной версии jQuery в 2018 году; примеры лишь задают поддерживаемую версию.

Ревью 3 — визуал и выпуск

Пройдено для черновой партии; после интеграции нужен штатный общий выпускной прогон.

Три SVG валидированы командой xmllint --noout и открыты в локальном рендере. После финальной правки нет обрезанных заголовков, стрелок или кодовых строк.
У каждого будущего contentHtml есть один figure с осмысленными alt и подписью, одна таблица в обёртке div.table-scroll и три блока кода.
В существующих стилях .table-scroll имеет горизонтальную прокрутку, а таблица — min-width: 620px; это сохраняет читаемость на узком экране без сжатия ячеек.
Команда node --check web/scripts/upgrade-2018-05.mjs прошла. Команда node web/scripts/upgrade-2018-05.mjs --print-revisions печатает валидный JSON ровно трёх ревизий и не записывает архив.

Перед интеграцией

Основной агент импортирует JSON из параметра --print-revisions и сопоставляет только три перечисленных slug.
Запускаются общий аудит партии и production-сборка.
На собранных страницах повторяется проверка таблиц в узком viewport, потому что эта ветка по задаче не изменяет articles.json.

Приёмка основного агента

Повторный quality-gate прошли все три статьи: 7 718 / 8 088 / 8 729 знаков основного текста, по одной схеме, таблице и трём блокам кода.
Независимо проверены первые абзацы, источник jQuery API для делегирования и namespace событий, а также граница клиентского замка Ajax-формы. Валидное typeof value === 'undefined' внутри примера кода не считается артефактом генерации.
Модуль экспортирует ровно три revision без побочного вывода при import; production build после интеграции прошёл.

7.3 KiB Raw Permalink Blame History Unescape Escape