المحوّلات المخصّصة وتوليد الشيفرة

ما المحوّلات؟

import ts from "typescript";
type Transformer = ts.TransformerFactory<ts.SourceFile>;

بنية مصنع المحوّل

const myTransformer: ts.TransformerFactory<ts.SourceFile> =
  (ctx) => (sf) => {
    function visit(node: ts.Node): ts.Node {
      // Modify node here
      return ts.visitEachChild(node, visit, ctx);
    }
    return ts.visitNode(sf, visit) as ts.SourceFile;
  };

الزيارة باستخدام السياق

function visit(node: ts.Node): ts.Node {
  if (ts.isStringLiteral(node)) {
    return ts.factory.createStringLiteral(node.text.toUpperCase());
  }
  return ts.visitEachChild(node, visit, ctx);
}

إنشاء عقد جديدة باستخدام ts.factory

const newCall = ts.factory.createCallExpression(
  ts.factory.createIdentifier("console.log"),
  undefined,
  [ts.factory.createStringLiteral("hello")]
);

تطبيق المحوّلات على برنامج

program.emit(undefined, undefined, undefined, false, {
  before: [myTransformer],
});

توليد الشيفرة: طباعة العقد

const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
const result = printer.printNode(
  ts.EmitHint.Unspecified,
  newCall,
  sf
);
console.log(result); // console.log("hello")

توليد ملفات مصدر كاملة

const statements = [
  ts.factory.createExpressionStatement(
    ts.factory.createCallExpression(
      ts.factory.createIdentifier("console.log"),
      undefined,
      [ts.factory.createStringLiteral("generated!")]
    )
  ),
];

تحويل الاستيرادات

if (ts.isImportDeclaration(node)) {
  const spec = node.moduleSpecifier as ts.StringLiteral;
  if (spec.text.startsWith("@app/")) {
    return ts.factory.updateImportDeclaration(
      node, node.modifiers, node.importClause,
      ts.factory.createStringLiteral(spec.text.replace("@app/", "../")),
      node.assertClause
    );
  }
}

اختبار المحوّلات

const result = ts.transpileModule("const x = 'hello';", {
  compilerOptions: { target: ts.ScriptTarget.ES2020 },
  transformers: { before: [myTransformer] },
});
console.log(result.outputText);

أنظمة المكوّنات الإضافية

// tsconfig.json with ts-patch:
// "plugins": [{ "transform": "./my-transformer.js" }]

مراجعة: المحوّلات المخصصة

تحقق سريع

ما تعلمتموه