ts-morph

Underlying Compiler Nodes

Sometimes it might be useful to get the node from the TypeScript compiler.

They're accessible via the .compilerNode property that's found on all node objects:

const compilerNode = interfaceDeclaration.compilerNode;

Warning: When manipulating the AST via this library, the underlying TypeScript AST tree is regenerated each time. For this reason, it's important not to hold on to TypeScript compiler nodes between manipulations or you could end up working with out of date information.

Compiler node properties

Sometimes there isn't a helper function in this library for accessing certain properties on the underlying compiler node.

In these situations, you can access any underlying compiler node property by using the .getNodeProperty(propName) method:

const nameNode = propertyAccessExpression.getNodeProperty("name"); // returns: PropertyName
// also works with arrays and possibly undefined properties
const typeParameters = classDeclaration.getNodeProperty("typeParameters"); // returns: TypeParameterDeclaration[] | undefined

...and then please open an issue so that I can implement something I forgot to implement.

Sometimes you might want to easily navigate an existing compiler node.

Do that by using the createWrappedNode function:

import { createWrappedNode, ClassDeclaration, ts, SyntaxKind } from "ts-morph";

// some code that creates a class declaration using the ts object
const classNode: ts.ClassDeclaration = ...;

// create and use a wrapped node
const classDec = createWrappedNode(classNode).asKindOrThrow(SyntaxKind.ClassDeclaration);
const firstProperty = classDec.getProperties()[0];

// ... do more stuff here ...

Note: This is a lightweight way to navigate a node, but there are certian functionalities which will throw an error since there is no language service, type checker, or program. For example, finding references will not work because that requires a language service.

Providing Type Checker

If you would like to easily get the type information of the types in the provided source file, then provide a type checker:

// given an existing node and type checker
const classNode: ts.ClassDeclaration = ...;
const compilerTypeChecker: ts.TypeChecker = ...;

// create and use a wrapped node
const classDec = createWrappedNode(classNode, { typeChecker: compilerTypeChecker }).asKindOrThrow(SyntaxKind.ClassDeclaration);
console.log(classDec.getPropertyOrThrow("propName").getType().getText()); // ok, because a type checker was provided

Important: Using both the TypeScript API and ts-morph

It is highly recommended to always use the ts named export from ts-morph when needing to use the TypeScript Compiler API and ts-morph at the same time:

// do this
import { ts } from "ts-morph";
// not this
import * as ts from "typescript";

They're almost identical and the ts named export from ts-morph should serve your needs.

There's lots of reasons why this is done and it's outlined in #333.