Чтение сообщений об ошибках SWC

## Структура диагностических сообщений SWC Сообщения об ошибках в SWC формируются как диагностические записи, включающие несколько уровней информации: текстовое описание проблемы, контекст исходного кода, позиционные данные и дополнительные заметки компилятора. Основная цель такой структуры — обеспечить быстрое сопоставление ошибки с конкретным участком AST или строкой исходного файла. Типичное сообщение включает: * **тип ошибки (error / warning / note)** * **текст диагностики** * **позицию в исходном коде (line, column)** * **фрагмент кода (code frame)** * **внутренние коды диагностики** * **дополнительные пояснения (notes)** SWC стремится сохранять совместимость с форматами ошибок Babel и TypeScript, но при этом использует собственную систему диагностик, основанную на Rust-подобной модели ошибок. --- ## Базовый формат диагностического вывода В CLI-режиме сообщение об ошибке обычно представлено в текстовом виде: ``` error: Unexpected token × source.js:10:15 │ 10 │ const a = ; │ ^ ``` Ключевые элементы: * `error:` — уровень серьезности * описание проблемы * путь к файлу и позиция * визуальный указатель на место ошибки Внутренне SWC хранит это как структуру: ```ts { severity: "Error", message: "Unexpected token", location: { file: "source.js", line: 10, column: 15 } } ``` --- ## Code frame и локализация ошибки Code frame — один из наиболее информативных элементов диагностики. Он показывает контекст строки с ошибкой и визуально выделяет проблемный участок. Пример: ``` 8 │ function test() { 9 │ return 10 │ const x = 10; │ ^^^^^^ Unexpected token 11 │ } ``` Особенности формирования: * отображаются несколько строк до и после ошибки * используется моноширинное выравнивание * указатель `^` или подчеркивание указывает точный диапазон При синтаксических ошибках диапазон может охватывать целую конструкцию AST-узла, а не только один символ. --- ## Типы диагностических сообщений ### Синтаксические ошибки Возникают на этапе парсинга JavaScript/TypeScript. SWC использует парсер, написанный на Rust, поэтому ошибки формируются до этапа трансформации AST. Примеры: * пропущенные скобки * некорректные токены * нарушения грамматики ECMAScript ``` error: Unexpected token `}` × app.js:5:1 ``` Часто такие ошибки сопровождаются минимальным контекстом, так как парсер не всегда может восстановить AST. --- ### Ошибки трансформации AST Возникают во время работы плагинов или встроенных трансформаций (например, TypeScript → JavaScript, JSX → JS). Пример: ``` error: Failed to transform JSX element × component.tsx:12:8 ``` Причины: * некорректная структура AST * несовместимость плагина и версии SWC * нарушение ожидаемого типа узла --- ### Ошибки конфигурации `.swcrc` SWC активно использует JSON-конфигурацию, и ошибки в ней являются отдельной категорией диагностик. Пример: ``` error: Invalid configuration × .swcrc │ Unexpected field "jscx" ``` Характерные проблемы: * опечатки в ключах конфигурации * несовместимые опции * неверные типы значений SWC в таких случаях часто указывает путь до конкретного поля конфигурации, если возможно восстановить структуру JSON. --- ## Коды ошибок и диагностика Внутренняя система SWC может использовать коды диагностики, которые помогают классифицировать ошибку. Пример условного формата: ``` error[E1001]: Unexpected token error[E2203]: Invalid JSX syntax ``` Структура: * префикс `E` — ошибка * числовой код — категория * текстовое описание — человекочитаемая форма Коды полезны для: * автоматической обработки логов * интеграции с CI/CD * фильтрации ошибок по типам --- ## Многоуровневые сообщения (notes) SWC поддерживает вложенные диагностические заметки, расширяющие контекст ошибки. Пример: ``` error: Cannot find module note: imported here × index.js:2:1 ``` Структура notes: * дополнительная причина * цепочка вызовов * подсказки о происхождении ошибки Такие сообщения формируют цепочку диагностики, полезную при сложных трансформациях. --- ## Ошибки при работе с TypeScript При обработке TypeScript SWC может выявлять ошибки типов и синтаксиса. Пример: ``` error: Type annotations are not allowed here × file.ts:7:12 ``` Особенности: * SWC не выполняет полноценную type-checking систему как tsc * ошибки ограничены синтаксическим уровнем * типы рассматриваются как грамматические конструкции --- ## Ошибки JSX JSX-диагностика включает проверку структуры элементов: ``` error: Expected corresponding JSX closing tag for