Spec-Zone.ru › React

panicThreshold

Параметр panicThreshold определяет, как React Compiler обрабатывает ошибки во время компиляции.

{
  panicThreshold: 'none' // Recommended
}
  • Справочник
    • panicThreshold
  • Использование
    • Конфигурация для production (рекомендуется)
    • Отладка при разработке

Справочник

panicThreshold

Определяет, должны ли ошибки компиляции приводить к сбою сборки или пропуску оптимизации.

Тип

'none' | 'critical_errors' | 'all_errors'

Значение по умолчанию

'none'

Параметры

  • 'none' (по умолчанию, рекомендуется): пропускать компоненты, которые не удалось скомпилировать, и продолжать сборку
  • 'critical_errors': завершать сборку с ошибкой только при критических ошибках компилятора
  • 'all_errors': завершать сборку с ошибкой при любой диагностике компилятора

Ограничения

  • Для production-сборок всегда следует использовать 'none'
  • Сбои сборки не позволяют собрать приложение
  • Компилятор автоматически обнаруживает проблемный код и пропускает его при использовании 'none'
  • Более высокие пороговые значения полезны только при отладке во время разработки

Использование

Конфигурация для production (рекомендуется)

Для production-сборок всегда используйте 'none'. Это значение используется по умолчанию:

{
  panicThreshold: 'none'
}

Это гарантирует, что:

  • Сборка не завершится с ошибкой из-за проблем компилятора
  • Компоненты, которые не удалось оптимизировать, будут работать в обычном режиме
  • Будет оптимизировано максимальное количество компонентов
  • Развертывания production-сборок будут стабильными

Отладка при разработке

Временно используйте более строгие пороговые значения, чтобы выявить проблемы:

const isDevelopment = process.env.NODE_ENV === 'development';

{
  panicThreshold: isDevelopment ? 'critical_errors' : 'none',
  logger: {
    logEvent(filename, event) {
      if (isDevelopment && event.kind === 'CompileError') {
        // ...
      }
    }
  }
}

© 2013–present Facebook Inc.
Licensed under the Creative Commons Attribution 4.0 International Public License.
https://react.dev/reference/react-compiler/panicThreshold

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API