Сначала верните воспроизводимость. Возьмите коммит до обновления, его lockfile и ту же версию Node; установите зависимости чисто. Затем повторите с новым lockfile. Если старый lockfile уже даёт поломку, причина не обязательно в заявленном пакете: мог измениться незакреплённый инструмент, браузер или конфигурация окружения.
npm ci предназначен для чистой установки из существующего lockfile и завершится ошибкой, если package.json с ним расходится. Зафиксируйте менеджер пакетов и его флаги в CI. Сравнивать два запуска после обычного install опасно: дерево может незаметно обновиться ещё раз.
Симптом указывает на нарушенный контракт
| Симптом | Проверьте первым | Частая причина |
|---|---|---|
| Поле не печатает | onChange и новый state | value остаётся прежним |
| Значение очищается | undefined/null между render | переход controlled в uncontrolled |
| Checkbox не меняется | checked и event payload | читается value вместо checked |
| Курсор прыгает | нормализацию на каждый символ | state переписывается форматтером |
| Работает нативный input, ломается UI-kit | имя prop и сигнатуру callback | изменён adapter contract |
React требует, чтобы controlled input получал строковый value или булев checked и синхронно обновлял backing value в onChange. Поле не должно переключаться между controlled и uncontrolled в течение жизни. Поэтому данные API нормализуют до render, а не временно передают null.
Инвариант поля помещается в короткий пример
const [name, setName] = useState('');
<input
value={name ?? ''}
onChange={event => setName(event.target.value)}
/>
// checkbox: checked={Boolean(enabled)}Этот пример не предлагает ставить ?? везде и скрывать ошибку модели. Он показывает границу: компонент ввода всегда получает ожидаемый тип. Если сервер различает «не задано» и пустую строку, это различие сохраняют в доменной модели и преобразуют на границе формы.
У составного компонента откройте типы и migration guide новой версии. Один UI-kit вызывает onChange(event), другой — onValueChange(value), третий возвращает value вторым аргументом. Adapter должен преобразовать новый контракт в единый интерфейс формы; чтение event.target у строки даст undefined без явной ошибки TypeScript, если тип был ослаблен any.
Bisect делают по фактическому дереву зависимостей
- Сохраните package.json, старый и новый lockfile, версии Node и package manager.
- Сравните прямые и транзитивные версии вокруг формы, UI-kit и runtime.
- Верните половину изменений, каждый раз выполняя чистую установку и один минимальный тест.
- После найденного пакета прочитайте официальный upgrade guide и release notes.
- Временный pin фиксирует инцидент, но рядом создаётся задача миграции с тестом.
Для React крупное обновление стоит проводить через рекомендованный промежуточный релиз и warnings; официальный guide для React 19 советует сначала перейти на React 18.3. Не смешивайте в одном коммите обновление runtime, form library, UI-kit и рефакторинг состояния: иначе поиск причины становится многомерным.
Курсор и IME проверяют реальное управление значением
Тест setValue не заменяет живой ввод. Наберите текст в середине строки, вставьте фрагмент, удалите символ, удерживайте клавишу и проверьте composition events для ввода на языках с IME. Форматирование денег и телефонов должно сохранять selection; преобразование регистра на каждый keystroke часто переставляет курсор.
Проверьте асинхронную валидацию. Поздний ответ не должен записывать в поле устаревшее значение. Храните request sequence или abort signal, а ошибку валидации отделяйте от value. Если сторонний компонент кеширует внутреннее состояние, убедитесь, что его key не меняется на каждом render и не вызывает remount.
Исправление подтверждается на двух версиях
- Создать минимальную форму без бизнес-обвязки и воспроизвести дефект на новой версии.
- Записать props, callback payload и state после одного символа.
- Исправить invariant или adapter и прогнать ввод, paste, clear, checkbox и IME.
- Запустить тест на закреплённой старой и целевой новой версии.
- Зафиксировать lockfile и добавить сценарий в CI до снятия временного pin.
В отчёт приложите минимальный компонент, версии пакетов, фрагмент lockfile и один лог перехода state без персональных данных. Скриншот замершего поля почти бесполезен: важен путь от пользовательского события до следующего value, который React получил при render.