Uso avançado e exemplos da API do compilador TypeScript

A API do compilador TypeScript fornece ferramentas poderosas para interagir programaticamente com o código TypeScript. Ela permite que os desenvolvedores analisem, transformem e gerem código TypeScript de maneiras sofisticadas. Este artigo se aprofunda em cenários de uso avançado e exemplos para ilustrar os recursos da API do compilador TypeScript.

Introdução à API do compilador TypeScript

Antes de mergulhar no uso avançado, é essencial configurar a API do TypeScript Compiler. Isso envolve instalar o TypeScript e escrever um script básico para interagir com a API.

import * as ts from 'typescript';

const sourceCode = `let x: number = 1;`;
const sourceFile = ts.createSourceFile('example.ts', sourceCode, ts.ScriptTarget.ES2015);

console.log(sourceFile.text);

Analisando código TypeScript

A API do compilador permite analisar código TypeScript em uma árvore de sintaxe abstrata (AST). Isso pode ser útil para tarefas de análise e transformação de código.

const sourceFile = ts.createSourceFile('example.ts', sourceCode, ts.ScriptTarget.ES2015);

function visit(node: ts.Node) {
  if (ts.isVariableDeclaration(node)) {
    console.log(`Variable name: ${node.name.getText()}`);
  }
  ts.forEachChild(node, visit);
}

visit(sourceFile);

Transformando código TypeScript

A API fornece ferramentas para transformar código TypeScript. Este exemplo mostra como usar um transformer para modificar código.

function transformer<T extends ts.Node>(context: ts.TransformationContext) {
  function visit(node: T): T {
    if (ts.isVariableDeclaration(node)) {
      return ts.updateVariableDeclaration(node, node.name, node.type, ts.createLiteral(42)) as T;
    }
    return ts.visitEachChild(node, visit, context);
  }
  return (rootNode: T) => ts.visitNode(rootNode, visit);
}

const result = ts.transform(sourceFile, [transformer]);
const printer = ts.createPrinter();
const transformedCode = printer.printFile(result.transformed[0] as ts.SourceFile);

console.log(transformedCode);

Gerando código TypeScript

Gerar código TypeScript programaticamente é outro recurso poderoso da API. Aqui está um exemplo de como criar um novo arquivo TypeScript do zero.

const newSourceFile = ts.createSourceFile(
  'newFile.ts',
  `const greeting: string = 'Hello, TypeScript!';`,
  ts.ScriptTarget.ES2015
);

const printer = ts.createPrinter();
const newCode = printer.printFile(newSourceFile);

console.log(newCode);

Lidando com diagnósticos e erros

A Compiler API fornece mecanismos para lidar com diagnósticos e erros. Este exemplo demonstra como usar diagnósticos para relatar problemas em código TypeScript.

const program = ts.createProgram(['example.ts'], {});
const diagnostics = ts.getPreEmitDiagnostics(program);

diagnostics.forEach(diagnostic => {
  const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n');
  console.log(`Error: ${message}`);
});

Conclusão

A API do TypeScript Compiler oferece um rico conjunto de recursos para trabalhar com código TypeScript programaticamente. Ao dominar esses recursos avançados, os desenvolvedores podem criar ferramentas poderosas para analisar, transformar e gerar código TypeScript, levando a fluxos de trabalho de desenvolvimento mais eficientes e flexíveis.