Product
Introducing License Enforcement in Socket
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
The tsutils package provides a set of utility functions for working with TypeScript. It is particularly useful for developers building TypeScript tools and plugins, as it offers a variety of functions to manipulate and analyze TypeScript code.
Type Guards
This feature provides type guard functions to check the type of TypeScript nodes. In the example, `isVariableStatement` is used to check if a node is a variable statement.
const ts = require('typescript');
const tsutils = require('tsutils');
const node = ts.createSourceFile('example.ts', 'let x: number = 42;', ts.ScriptTarget.Latest);
if (tsutils.isVariableStatement(node.statements[0])) {
console.log('This is a variable statement');
}
AST Utilities
AST (Abstract Syntax Tree) utilities help in traversing and manipulating the AST of TypeScript code. The example demonstrates how to find all variable declarations in a source file.
const ts = require('typescript');
const tsutils = require('tsutils');
const sourceFile = ts.createSourceFile('example.ts', 'let x: number = 42;', ts.ScriptTarget.Latest);
const variableDeclarations = tsutils.findVariableDeclarations(sourceFile);
console.log(variableDeclarations);
Type Utilities
Type utilities provide functions to work with TypeScript types. The example shows how to check if a variable's type is a number using `isTypeFlagSet`.
const ts = require('typescript');
const tsutils = require('tsutils');
const program = ts.createProgram(['example.ts'], {});
const checker = program.getTypeChecker();
const sourceFile = program.getSourceFile('example.ts');
sourceFile.forEachChild(node => {
if (ts.isVariableDeclaration(node)) {
const type = checker.getTypeAtLocation(node);
console.log(tsutils.isTypeFlagSet(type, ts.TypeFlags.Number)); // true if the type is a number
}
});
typescript-eslint is a set of tools for using ESLint with TypeScript. It includes a parser and a set of rules that help in linting TypeScript code. While tsutils focuses on utility functions for TypeScript AST and types, typescript-eslint is more about integrating TypeScript with ESLint for code quality and style enforcement.
ts-morph is a library for TypeScript compiler API wrapper. It simplifies the process of working with the TypeScript AST and provides a higher-level API compared to tsutils. While tsutils offers utility functions, ts-morph provides a more comprehensive and user-friendly interface for manipulating TypeScript code.
babel-plugin-transform-typescript is a Babel plugin that allows Babel to transform TypeScript code. It is used for compiling TypeScript to JavaScript. Unlike tsutils, which provides utility functions for TypeScript AST and types, this plugin focuses on the transformation of TypeScript code during the build process.
This package consists of two major parts: utilities and typeguard functions. By importing the project you will get both of them.
import * as utils from "tsutils";
utils.isIdentifier(node); // typeguard
utils.getLineRanges(sourceFile); // utilities
If you don't need everything offered by this package, you can select what should be imported. The parts that are not imported are never read from disk and may save some startup time and reduce memory consumtion.
If you only need typeguards you can explicitly import them:
import { isIdentifier } from "tsutils/typeguard";
// You can even distiguish between typeguards for nodes and types
import { isUnionTypeNode } from "tsutils/typeguard/node";
import { isUnionType } from "tsutils/typeguard/type";
If you only need the utilities you can also explicitly import them:
import { forEachComment, forEachToken } from "tsutils/util";
This package is backwards compatible with typescript 2.1.0 at runtime although compiling might need a newer version of typescript installed.
Using typescript@next
might work, but it's not officially supported. If you encounter any bugs, please open an issue.
2.25.0
Features:
isStatementInAmbientContext
and isAmbientModuleBlock
FAQs
utilities for working with typescript's AST
The npm package tsutils receives a total of 11,636,667 weekly downloads. As such, tsutils popularity was classified as popular.
We found that tsutils demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Ensure open-source compliance with Socket’s License Enforcement Beta. Set up your License Policy and secure your software!
Product
We're launching a new set of license analysis and compliance features for analyzing, managing, and complying with licenses across a range of supported languages and ecosystems.
Product
We're excited to introduce Socket Optimize, a powerful CLI command to secure open source dependencies with tested, optimized package overrides.