Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 30 additions & 31 deletions src/content/reference/react-compiler/logger.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: logger

<Intro>

The `logger` option provides custom logging for React Compiler events during compilation.
A opção `logger` fornece logs personalizados para eventos do React Compiler durante a compilação.

</Intro>

Expand All @@ -22,61 +22,61 @@ The `logger` option provides custom logging for React Compiler events during com

---

## Reference {/*reference*/}
## Referência {/*reference*/}

### `logger` {/*logger*/}

Configures custom logging to track compiler behavior and debug issues.
Configura logs personalizados para rastrear o comportamento do compilador e depurar problemas.

#### Type {/*type*/}
#### Tipo {/*type*/}

```
{
logEvent: (filename: string | null, event: LoggerEvent) => void;
} | null
```

#### Default value {/*default-value*/}
#### Valor padrão {/*default-value*/}

`null`

#### Methods {/*methods*/}
#### Métodos {/*methods*/}

- **`logEvent`**: Called for each compiler event with the filename and event details
- **`logEvent`**: Chamado para cada evento do compilador com o nome do arquivo e os detalhes do evento

#### Event types {/*event-types*/}
#### Tipos de evento {/*event-types*/}

- **`CompileSuccess`**: Function successfully compiled
- **`CompileError`**: Function skipped due to errors
- **`CompileDiagnostic`**: Non-fatal diagnostic information
- **`CompileSkip`**: Function skipped for other reasons
- **`PipelineError`**: Unexpected compilation error
- **`Timing`**: Performance timing information
- **`CompileSuccess`**: Função compilada com sucesso
- **`CompileError`**: Função ignorada devido a erros
- **`CompileDiagnostic`**: Informações de diagnóstico não fatais
- **`CompileSkip`**: Função ignorada por outros motivos
- **`PipelineError`**: Erro inesperado de compilação
- **`Timing`**: Informações de tempo de desempenho

#### Caveats {/*caveats*/}
#### Ressalvas {/*caveats*/}

- Event structure may change between versions
- Large codebases generate many log entries
- A estrutura do evento pode mudar entre as versões
- Bases de código grandes geram muitas entradas de log

---

## Usage {/*usage*/}
## Uso {/*usage*/}

### Basic logging {/*basic-logging*/}
### Log básico {/*basic-logging*/}

Track compilation success and failures:
Rastreie o sucesso e as falhas da compilação:

```js
{
logger: {
logEvent(filename, event) {
switch (event.kind) {
case 'CompileSuccess': {
console.log(`✅ Compiled: ${filename}`);
console.log(`✅ Compilado: ${filename}`);
break;
}
case 'CompileError': {
console.log(`❌ Skipped: ${filename}`);
console.log(`❌ Ignorado: ${filename}`);
break;
}
default: {}
Expand All @@ -86,33 +86,32 @@ Track compilation success and failures:
}
```

### Detailed error logging {/*detailed-error-logging*/}
### Log detalhado de erros {/*detailed-error-logging*/}

Get specific information about compilation failures:
Obtenha informações específicas sobre falhas de compilação:

```js
{
logger: {
logEvent(filename, event) {
if (event.kind === 'CompileError') {
console.error(`\nCompilation failed: ${filename}`);
console.error(`Reason: ${event.detail.reason}`);
console.error(`\nFalha na compilação: ${filename}`);
console.error(`Motivo: ${event.detail.reason}`);

if (event.detail.description) {
console.error(`Details: ${event.detail.description}`);
console.error(`Detalhes: ${event.detail.description}`);
}

if (event.detail.loc) {
const { line, column } = event.detail.loc.start;
console.error(`Location: Line ${line}, Column ${column}`);
console.error(`Localização: Linha ${line}, Coluna ${column}`);
}

if (event.detail.suggestions) {
console.error('Suggestions:', event.detail.suggestions);
console.error('Sugestões:', event.detail.suggestions);
}
}
}
}
}
```

```