Node.js 24.20.0: trackPromises принимает только boolean. Карта симптома, test/control, матрица исходов, безопасная stop-line и пакет для воспроизведения.
Короткий ответ без обещания результата
Для проблемы «конфигурация async hooks тихо передаёт строку или число вместо boolean и получает неожиданный класс ошибки» не нужен общий совет обновить runtime. Сначала подтвердите change boundary: для trackPromises используется validateBoolean. Затем используйте только «короткий скрипт с true, false, строкой 'false' и числом 1 для одной и той же настройки trackPromises» и сравните её с контрольной веткой «два корректных boolean-вызова с одинаковым пустым async workload». Успех такого опыта доказывает поведение одной функции на одном стенде; он не доказывает совместимость приложения, рост скорости, отсутствие других ошибок или готовность немедленно менять production. Версию бинарника и ожидаемый класс результата запишите до первого запуска.
Карта симптома и различимые состояния
Симптом считается наблюдаемым, только когда заполнена матрица «тип входа × принято или отклонено × error.name × error.code × hooks не запущены». Не заменяйте значения словами «работает» или «сломано»: фиксируйте boolean state, error.name/error.code, event order, размер, fingerprint либо счётчик — в зависимости от этой темы. Исходная боль здесь узкая: конфигурация async hooks тихо передаёт строку или число вместо boolean и получает неожиданный класс ошибки. Похожий лог с другим lifecycle не является тем же результатом. Если хотя бы одно поле нельзя получить без секретов или production-данных, тест нужно перепроектировать, а не расширять доступ.
Сборка пары test и control
Test-ветка строится так: короткий скрипт с true, false, строкой 'false' и числом 1 для одной и той же настройки trackPromises. Control-ветка независимо повторяет «два корректных boolean-вызова с одинаковым пустым async workload». Обе работают в отдельных временных каталогах или процессах, используют одинаковые публичные markers и конечный timeout. Перед B снимите A, после B верните A2. Нельзя менять одновременно версию Node.js, форму входа, платформенный флаг и порядок событий: иначе причина расхождения останется неизвестной. Любые ключи, cookies, реальные hostname, базы, пользовательские файлы и полный env исключаются.
Ход опыта и возврат baseline
Шаг 1: подтвердите версию 24.20.0 и пустое состояние fixture. Шаг 2: выполните control «два корректных boolean-вызова с одинаковым пустым async workload» и сохраните только поля «тип входа × принято или отклонено × error.name × error.code × hooks не запущены». Шаг 3: запустите test «короткий скрипт с true, false, строкой 'false' и числом 1 для одной и той же настройки trackPromises» один раз, затем повторите с теми же входами. Шаг 4: удалите созданные объекты, закройте listener, worker, file handle или timer и повторите A2. Если A2 не совпал с A, не повторяйте B до бесконечности: сначала найдите оставшийся handle, cache entry или файл.
Дерево решения по четырём исходам
Основное правило чтения результата уже определено: true и false приняты, остальные типы отклонены до запуска hooks — граница ясна; любой неверный тип принят — фиксируем case; control падает — проверяем способ вызова. Дополнительно различайте четыре класса. Test совпал с ожиданием и control чист — зафиксирована граница. Оба дают ошибку — сломан fixture или среда. Test не воспроизводится, а control чист — результат неопределён, не «исправлено». A2 расходится с A — состояние загрязнено. Ни один класс не даёт права утверждать массовость проблемы или переносить вывод на другой runtime, provider, filesystem либо network stack.
Красные флаги и право остановиться
Жёсткая stop-line этой статьи: не менять общую фабрику async hooks, пока не найдены все места, где конфиг приходит из env как строка. Также прекращайте работу при crash, зависании без timeout, выходе за temp root, неожиданном внешнем соединении, запросе повышенных прав, создании dump или невозможности закрыть ресурсы. Нельзя лечить неясный результат подавлением error listener, увеличением памяти, отключением проверки сертификата или запуском на живом трафике. Безопасный нулевой вывод лучше удобной выдуманной причины.
Пакет данных для воспроизведения
Минимальный пакет support состоит из: минимальный вызов, четыре типа значений, версия runtime и error.name/error.code. К нему добавьте Moscow timestamp, архитектуру, точный `node --version`, команду с несекретными флагами и таблицу A/B/A2. Удалите домашние пути, содержимое ключей и payload, реальные URL, authorization headers, IP, токены и сырые дампы. Получатель должен суметь повторить один edge case и проверить один error/state transition. Если для воспроизведения требуется рабочая база или пользовательский запрос, пакет не минимизирован.
Протокол T16-1: самостоятельная ценность
Этот материал не является вариантом соседней статьи: его проверяемая боль — «конфигурация async hooks тихо передаёт строку или число вместо boolean и получает неожиданный класс ошибки», релизная граница — «для trackPromises используется validateBoolean», а артефакт — «тип входа × принято или отклонено × error.name × error.code × hooks не запущены». Паспорт этой проверки неделим: намерение «почему trackPromises в async_hooks Node.js 24.20.0 отклоняет не boolean и как проверить границу»; изолированный стенд «короткий скрипт с true, false, строкой 'false' и числом 1 для одной и той же настройки trackPromises»; сравниваемый baseline «два корректных boolean-вызова с одинаковым пустым async workload». Измерительная таблица для этого URL фиксирует именно «тип входа × принято или отклонено × error.name × error.code × hooks не запущены», поэтому её нельзя заменить общим uptime, одним exit code или замером памяти. Сначала создаётся «короткий скрипт с true, false, строкой 'false' и числом 1 для одной и той же настройки trackPromises»; затем отдельно выполняется «два корректных boolean-вызова с одинаковым пустым async workload»; после этого применяется правило «true и false приняты, остальные типы отклонены до запуска hooks — граница ясна; любой неверный тип принят — фиксируем case; control падает — проверяем способ вызова». Условие разворота также предметно: «не менять общую фабрику async hooks, пока не найдены все места, где конфиг приходит из env как строка». Пакет для разбора ограничен полями «минимальный вызов, четыре типа значений, версия runtime и error.name/error.code»; всё остальное не нужно для решения этой боли. После завершения удалите fixture и убедитесь, что процесс не оставил объекты из этого протокола. Именно эта связка боли, fixture, матрицы, control, stop-line и пакета поддержки, а не название Node.js, создаёт самостоятельную практическую ценность URL.
Материал подготовлен редакцией VOne с помощью ИИ по открытым официальным и первичным источникам; факты, даты и ссылки перепроверены. Реальные пользовательские данные не использовались.
Источники и проверка
- Node.js 24.20.0 release notes проверено 2026-08-29
- Node.js pull request #64731 проверено 2026-08-29
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.