TypeScript AST Query library
Last updated a year ago by cancerberosgx .
MIT · Original npm · Tarball · package.json
$ cnpm install cannabis 
SYNC missed versions from official npm registry.

Build Status Coverage Status

TypeScript AST Query Selector library

Based on the powerful astq AST Query engine and syntax language.



Try out this interactive TypeScript AST Query editor with examples to understand what this is all about.


npm install cannabis
import { queryAst } from 'cannabis'

const code = `
function f(o: any){
  for(let i in o)
class A{
  private method1(){
    for(var name in this)
// match Blocks containing ForInStatement direct children
const query = '//Block [ /ForInStatement ]'
const { result, error} = queryAst(query, code1)
  // there was a query syntax error 
}else{>console.log(node.getStart(), node.getEnd()))

From string

From ts.Node

Loading projects

cannabis supports AST Nodes of type File and Directory, so it's possible to load a project or folder or sets of files as AST Nodes.

TODO example


In general attributes will return a value if there is something to return, empty array, empty string, false or 0 for those types if there is no value to return, and null if thevalue is an object or there was an error.


@text - string

returns current node's text as in ts.Node#getText(). Example:

// VariableDeclaration [ @text!~'2' ]


@name - string

There are node kinds that have name, like InterfaceDeclaration, and others that don't, like IfStatement. Example: // * [ @name=='f' && @modifiers=~'export' ]


@modifiers - string

A comma separated modifier names in "export","default","declare","abstract","public","protected","private","readonly","static","async","const".


// PropertyDeclaration [ @modifiers=~'private' || @modifiers=~'protected' ]

If the node has no modifiers at all it returns empty string.


@type - string

Returns current node's type string representation.

If type is not declared it will be inferrer form usage.

If type doesn't apply to current node it will return empty string.


// VariableDeclaration [ @type=='Date[]'],

// Parameter [ @type=='boolean' || @type=='number']


@expression - Node (ts-morph Node instance)

Returns a AST Node if the node has an expression, or null other wise.

Examples: TODO


Gets the literal text of a literal-like node , example

// LiteralString [compareText({forbidden}, @literalText, 'verb:equals,caseSensitive:true']


Returns the position of current node in its source file.


Returns the position of current node's end, in its source file.


Returns the amount of characters of current node.


Return current node's body node, or null if it doesn't have a body.


Returns the text of comments before this node.


Returns the text of comments after this node.


Returns a child-index based path for the node, similar to src/services/login/loginService/2/1


Returns a node kind based path for the node, like src/services/login/loginService/InterfaceDeclaration/Identifier. Notice that unlike @indexPath, this doesn't necessarily points to the node.


Returns a node-name based path for current node, like src/services/login/loginService/LoginService/method1/param1. Notice that unlike @indexPath, this doesn't necessarily points to the node. If a node doesn't have a name, its kind name will be printed in the path instead.


The following are custom function that can be used in the queries directly, added to standard query functions of astq library, related to TypeScript AST.


  • isFunctionLike(arg?) - boolean

Returns true if current node kind is function like, this is a callable node like FunctionDeceleration, MethodDeclaration, ArrowFunction, etc.


//* [ isFunctionLike() && type() != ConstructorDeclaration]


Supports two signatures:

extendsAnyNamed(name: string) - boolean extendsAnyNamed(node: ASTNode, name: string|string[]) - boolean

Returns true if current node (or given node given as parameter) extends any class or interface (directly or indirectly) which name is included in names parameter. If names is a string then it will be split using ','.

Example: //ClassDeclaration [extendsAnyNamed('Base,ExternalBase')]: Returns true if current node ClassDeclaration extends (directly or indirectly) a class named 'Base' OR 'ExternalBase'.

Example: Identifier [extendsAnyNamed(parent(), {names}): Returns true if current node's parent extends (directly or indirectly) a type with name included in names parameter.

Take into account that it will search across all extends HeritageClauses, (directly or indirectly) so it's an expensive operation. Also remember that an interface can extend both interfaces and classes. Examples:



implementsAnyNamed(name: string): boolean

Returns true if current node (class declaration) implements recursively an interface with given name.

Take into account that it will search across all implemented HeritageClauses of all interfaces implemented by super classes and also interfaces extended by super interfaces, recursively.


//ClassDeclaration [implementsAnyNamed('Touchable')]



sourceFile(node?: ASTNode): ASTNode | null

Returns current sourceFile Node.


(node?: ASTNode): ASTNode[]

Returns an array of Nodes which are referencing current node. If a project was used as starting node, and current node is exported, then it could return references of nodes in other files.

If an argument is passed it will return the references of that node.


Find unused variables:

// VariableDeclaration [@modifiers!~'export' && count(findReferences())==0]

Passing a node argument:

// Identifier [@name=='Foo22' && count(findReferences(parent()))>=0]

debug(...args?: any[]): true


// Identifier [..//* && debug(count(findReferences()), kindName(), @name) && count(findReferences())==2]


includes(a: string | any[], b: any): boolean


parent(arg?ASTNode): ASTNode|null


children(arg?:ASTNode): ASTNode[]


Gets given node's SourceFile or current node's if no node is given.

Query Syntax



Current Tags

  • 0.1.2                                ...           latest (9 months ago)

13 Versions

  • 0.1.2                                ...           9 months ago
  • 0.1.1                                ...           10 months ago
  • 0.1.0                                ...           a year ago
  • 0.0.11                                ...           a year ago
  • 0.0.10                                ...           a year ago
  • 0.0.9                                ...           a year ago
  • 0.0.8                                ...           a year ago
  • 0.0.7                                ...           a year ago
  • 0.0.6                                ...           a year ago
  • 0.0.5                                ...           a year ago
  • 0.0.4                                ...           a year ago
  • 0.0.3                                ...           a year ago
  • 0.0.2                                ...           a year ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (4)
Dev Dependencies (10)

Copyright 2014 - 2016 © |