├── .gitignore ├── src └── index.ts ├── package.json ├── README.md └── tsconfig.json /.gitignore: -------------------------------------------------------------------------------- 1 | /build 2 | /node_modules 3 | src/index.js 4 | -------------------------------------------------------------------------------- /src/index.ts: -------------------------------------------------------------------------------- 1 | import { Command } from "commander"; 2 | const program = new Command(); 3 | program 4 | .option("-d, --debug", "output extra debugging") 5 | .option("-s, --small", "small pizza size") 6 | .option("-p, --pizza-type ", "flavour of pizza"); 7 | 8 | program.parse(process.argv); 9 | 10 | const options = program.opts(); 11 | 12 | console.log("options", options); 13 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "esrun-tsnode-esno", 3 | "homepage": "https://www.peterbe.com/plog/ts-node-vs-esrun-vs-esno-vs-bun", 4 | "version": "1.0.0", 5 | "description": "", 6 | "main": "index.js", 7 | "scripts": { 8 | "test": "echo \"Error: no test specified\" && exit 1" 9 | }, 10 | "keywords": [], 11 | "author": "@peterbe", 12 | "license": "ISC", 13 | "dependencies": { 14 | "commander": "11.1.0" 15 | }, 16 | "devDependencies": { 17 | "esno": "4.0.0", 18 | "esrun": "3.2.26", 19 | "ts-node": "10.9.2", 20 | "tsx": "4.7.0", 21 | "typescript": "5.3.3" 22 | } 23 | } 24 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Bestest TypeScript runner in Node 2 | 3 | This is the sample code used for this blog post: 4 | [**ts-node vs. esrun vs. esno vs. bun**](https://www.peterbe.com/plog/ts-node-vs-esrun-vs-esno-vs-bun) 5 | 6 | ## Install 7 | 8 | ```sh 9 | npm i -D typescript ts-node esno esrun tsx 10 | ``` 11 | 12 | ## Run options 13 | 14 | 1. `tsc` 15 | 16 | tsc src/index.ts && node src/index.js 17 | 18 | 1. `ts-node` 19 | 20 | ts-node src/index.ts 21 | 22 | 1. `ts-node --transpileOnly` 23 | 24 | ts-node --transpileOnly src/index.ts 25 | 26 | 1. `esrun` 27 | 28 | esrun src/index.ts 29 | 30 | 1. `esno` 31 | 32 | esno src/index.ts 33 | 34 | 1. `bun` 35 | 36 | bun src/index.ts 37 | 38 | 1. `tsx` 39 | 40 | tsx src/index.ts 41 | 42 | ## Hyperfine 43 | 44 | Run: 45 | 46 | ```sh 47 | hyperfine "tsc src/index.ts && node src/index.js" "ts-node src/index.ts" "ts-node --transpileOnly src/index.ts" "esrun src/index.ts" "esno src/index.ts" "bun src/index.ts" "tsx src/index.ts" 48 | ``` 49 | 50 | ### Result 51 | 52 | ```sh 53 | Benchmark 1: tsc src/index.ts && node src/index.js 54 | Time (mean ± σ): 1.867 s ± 0.069 s [User: 4.374 s, System: 0.157 s] 55 | Range (min … max): 1.714 s … 1.983 s 10 runs 56 | 57 | Benchmark 2: ts-node src/index.ts 58 | Time (mean ± σ): 944.2 ms ± 26.2 ms [User: 1974.5 ms, System: 126.0 ms] 59 | Range (min … max): 900.5 ms … 984.0 ms 10 runs 60 | 61 | Benchmark 3: ts-node --transpileOnly src/index.ts 62 | Time (mean ± σ): 292.0 ms ± 8.0 ms [User: 272.4 ms, System: 47.2 ms] 63 | Range (min … max): 281.4 ms … 303.3 ms 10 runs 64 | 65 | Benchmark 4: esrun src/index.ts 66 | Time (mean ± σ): 184.7 ms ± 3.5 ms [User: 157.2 ms, System: 34.5 ms] 67 | Range (min … max): 177.1 ms … 189.6 ms 15 runs 68 | 69 | Benchmark 5: esno src/index.ts 70 | Time (mean ± σ): 285.9 ms ± 8.1 ms [User: 270.4 ms, System: 46.4 ms] 71 | Range (min … max): 272.6 ms … 293.5 ms 10 runs 72 | 73 | Benchmark 6: bun src/index.ts 74 | Time (mean ± σ): 40.3 ms ± 1.1 ms [User: 28.7 ms, System: 12.1 ms] 75 | Range (min … max): 37.2 ms … 43.9 ms 61 runs 76 | 77 | Benchmark 7: tsx src/index.ts 78 | Time (mean ± σ): 277.2 ms ± 9.1 ms [User: 265.1 ms, System: 45.0 ms] 79 | Range (min … max): 266.2 ms … 292.6 ms 10 runs 80 | 81 | Summary 82 | bun src/index.ts ran 83 | 4.58 ± 0.15 times faster than esrun src/index.ts 84 | 6.88 ± 0.29 times faster than tsx src/index.ts 85 | 7.10 ± 0.28 times faster than esno src/index.ts 86 | 7.25 ± 0.28 times faster than ts-node --transpileOnly src/index.ts 87 | 23.43 ± 0.90 times faster than ts-node src/index.ts 88 | 46.33 ± 2.11 times faster than tsc src/index.ts && node src/index.js 89 | ``` 90 | 91 | Considering how significantly slower `tsc src/index.ts && node src/index.js` 92 | and `ts-node src/index.ts` are, because they write a `index.js` file to 93 | disk every time, here's a benchmark with them skipped: 94 | 95 | ```sh 96 | hyperfine "ts-node --transpileOnly src/index.ts" "esrun src/index.ts" "esno src/index.ts" "bun src/index.ts" "tsx src/index.ts" 97 | ``` 98 | 99 | ```sh 100 | Benchmark 1: ts-node --transpileOnly src/index.ts 101 | Time (mean ± σ): 305.3 ms ± 27.3 ms [User: 278.9 ms, System: 51.7 ms] 102 | Range (min … max): 283.7 ms … 380.8 ms 10 runs 103 | 104 | Warning: Statistical outliers were detected. Consider re-running this benchmark on a quiet system without any interferences from other programs. It might help to use the '--warmup' or '--prepare' options. 105 | 106 | Benchmark 2: esrun src/index.ts 107 | Time (mean ± σ): 193.6 ms ± 7.0 ms [User: 164.0 ms, System: 35.6 ms] 108 | Range (min … max): 183.4 ms … 206.6 ms 15 runs 109 | 110 | Benchmark 3: esno src/index.ts 111 | Time (mean ± σ): 298.6 ms ± 11.8 ms [User: 286.8 ms, System: 50.1 ms] 112 | Range (min … max): 285.7 ms … 325.0 ms 10 runs 113 | 114 | Benchmark 4: bun src/index.ts 115 | Time (mean ± σ): 41.3 ms ± 1.0 ms [User: 28.9 ms, System: 12.6 ms] 116 | Range (min … max): 39.8 ms … 44.7 ms 59 runs 117 | 118 | Benchmark 5: tsx src/index.ts 119 | Time (mean ± σ): 291.6 ms ± 10.1 ms [User: 278.4 ms, System: 47.5 ms] 120 | Range (min … max): 272.4 ms … 311.3 ms 10 runs 121 | 122 | Summary 123 | bun src/index.ts ran 124 | 4.69 ± 0.20 times faster than esrun src/index.ts 125 | 7.07 ± 0.30 times faster than tsx src/index.ts 126 | 7.24 ± 0.33 times faster than esno src/index.ts 127 | 7.40 ± 0.68 times faster than ts-node --transpileOnly src/index.ts 128 | ``` 129 | -------------------------------------------------------------------------------- /tsconfig.json: -------------------------------------------------------------------------------- 1 | { 2 | "compilerOptions": { 3 | /* Visit https://aka.ms/tsconfig to read more about this file */ 4 | 5 | /* Projects */ 6 | // "incremental": true, /* Save .tsbuildinfo files to allow for incremental compilation of projects. */ 7 | // "composite": true, /* Enable constraints that allow a TypeScript project to be used with project references. */ 8 | // "tsBuildInfoFile": "./.tsbuildinfo", /* Specify the path to .tsbuildinfo incremental compilation file. */ 9 | // "disableSourceOfProjectReferenceRedirect": true, /* Disable preferring source files instead of declaration files when referencing composite projects. */ 10 | // "disableSolutionSearching": true, /* Opt a project out of multi-project reference checking when editing. */ 11 | // "disableReferencedProjectLoad": true, /* Reduce the number of projects loaded automatically by TypeScript. */ 12 | 13 | /* Language and Environment */ 14 | "target": "es2016", /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */ 15 | // "lib": [], /* Specify a set of bundled library declaration files that describe the target runtime environment. */ 16 | // "jsx": "preserve", /* Specify what JSX code is generated. */ 17 | // "experimentalDecorators": true, /* Enable experimental support for legacy experimental decorators. */ 18 | // "emitDecoratorMetadata": true, /* Emit design-type metadata for decorated declarations in source files. */ 19 | // "jsxFactory": "", /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */ 20 | // "jsxFragmentFactory": "", /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */ 21 | // "jsxImportSource": "", /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */ 22 | // "reactNamespace": "", /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */ 23 | // "noLib": true, /* Disable including any library files, including the default lib.d.ts. */ 24 | // "useDefineForClassFields": true, /* Emit ECMAScript-standard-compliant class fields. */ 25 | // "moduleDetection": "auto", /* Control what method is used to detect module-format JS files. */ 26 | 27 | /* Modules */ 28 | "module": "commonjs", /* Specify what module code is generated. */ 29 | // "rootDir": "./", /* Specify the root folder within your source files. */ 30 | // "moduleResolution": "node10", /* Specify how TypeScript looks up a file from a given module specifier. */ 31 | // "baseUrl": "./", /* Specify the base directory to resolve non-relative module names. */ 32 | // "paths": {}, /* Specify a set of entries that re-map imports to additional lookup locations. */ 33 | // "rootDirs": [], /* Allow multiple folders to be treated as one when resolving modules. */ 34 | // "typeRoots": [], /* Specify multiple folders that act like './node_modules/@types'. */ 35 | // "types": [], /* Specify type package names to be included without being referenced in a source file. */ 36 | // "allowUmdGlobalAccess": true, /* Allow accessing UMD globals from modules. */ 37 | // "moduleSuffixes": [], /* List of file name suffixes to search when resolving a module. */ 38 | // "allowImportingTsExtensions": true, /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */ 39 | // "resolvePackageJsonExports": true, /* Use the package.json 'exports' field when resolving package imports. */ 40 | // "resolvePackageJsonImports": true, /* Use the package.json 'imports' field when resolving imports. */ 41 | // "customConditions": [], /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */ 42 | // "resolveJsonModule": true, /* Enable importing .json files. */ 43 | // "allowArbitraryExtensions": true, /* Enable importing files with any extension, provided a declaration file is present. */ 44 | // "noResolve": true, /* Disallow 'import's, 'require's or ''s from expanding the number of files TypeScript should add to a project. */ 45 | 46 | /* JavaScript Support */ 47 | // "allowJs": true, /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */ 48 | // "checkJs": true, /* Enable error reporting in type-checked JavaScript files. */ 49 | // "maxNodeModuleJsDepth": 1, /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */ 50 | 51 | /* Emit */ 52 | // "declaration": true, /* Generate .d.ts files from TypeScript and JavaScript files in your project. */ 53 | // "declarationMap": true, /* Create sourcemaps for d.ts files. */ 54 | // "emitDeclarationOnly": true, /* Only output d.ts files and not JavaScript files. */ 55 | // "sourceMap": true, /* Create source map files for emitted JavaScript files. */ 56 | // "inlineSourceMap": true, /* Include sourcemap files inside the emitted JavaScript. */ 57 | // "outFile": "./", /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */ 58 | // "outDir": "./", /* Specify an output folder for all emitted files. */ 59 | // "removeComments": true, /* Disable emitting comments. */ 60 | // "noEmit": true, /* Disable emitting files from a compilation. */ 61 | // "importHelpers": true, /* Allow importing helper functions from tslib once per project, instead of including them per-file. */ 62 | // "importsNotUsedAsValues": "remove", /* Specify emit/checking behavior for imports that are only used for types. */ 63 | // "downlevelIteration": true, /* Emit more compliant, but verbose and less performant JavaScript for iteration. */ 64 | // "sourceRoot": "", /* Specify the root path for debuggers to find the reference source code. */ 65 | // "mapRoot": "", /* Specify the location where debugger should locate map files instead of generated locations. */ 66 | // "inlineSources": true, /* Include source code in the sourcemaps inside the emitted JavaScript. */ 67 | // "emitBOM": true, /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */ 68 | // "newLine": "crlf", /* Set the newline character for emitting files. */ 69 | // "stripInternal": true, /* Disable emitting declarations that have '@internal' in their JSDoc comments. */ 70 | // "noEmitHelpers": true, /* Disable generating custom helper functions like '__extends' in compiled output. */ 71 | // "noEmitOnError": true, /* Disable emitting files if any type checking errors are reported. */ 72 | // "preserveConstEnums": true, /* Disable erasing 'const enum' declarations in generated code. */ 73 | // "declarationDir": "./", /* Specify the output directory for generated declaration files. */ 74 | // "preserveValueImports": true, /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */ 75 | 76 | /* Interop Constraints */ 77 | // "isolatedModules": true, /* Ensure that each file can be safely transpiled without relying on other imports. */ 78 | // "verbatimModuleSyntax": true, /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */ 79 | // "allowSyntheticDefaultImports": true, /* Allow 'import x from y' when a module doesn't have a default export. */ 80 | "esModuleInterop": true, /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */ 81 | // "preserveSymlinks": true, /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */ 82 | "forceConsistentCasingInFileNames": true, /* Ensure that casing is correct in imports. */ 83 | 84 | /* Type Checking */ 85 | "strict": true, /* Enable all strict type-checking options. */ 86 | // "noImplicitAny": true, /* Enable error reporting for expressions and declarations with an implied 'any' type. */ 87 | // "strictNullChecks": true, /* When type checking, take into account 'null' and 'undefined'. */ 88 | // "strictFunctionTypes": true, /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */ 89 | // "strictBindCallApply": true, /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */ 90 | // "strictPropertyInitialization": true, /* Check for class properties that are declared but not set in the constructor. */ 91 | // "noImplicitThis": true, /* Enable error reporting when 'this' is given the type 'any'. */ 92 | // "useUnknownInCatchVariables": true, /* Default catch clause variables as 'unknown' instead of 'any'. */ 93 | // "alwaysStrict": true, /* Ensure 'use strict' is always emitted. */ 94 | // "noUnusedLocals": true, /* Enable error reporting when local variables aren't read. */ 95 | // "noUnusedParameters": true, /* Raise an error when a function parameter isn't read. */ 96 | // "exactOptionalPropertyTypes": true, /* Interpret optional property types as written, rather than adding 'undefined'. */ 97 | // "noImplicitReturns": true, /* Enable error reporting for codepaths that do not explicitly return in a function. */ 98 | // "noFallthroughCasesInSwitch": true, /* Enable error reporting for fallthrough cases in switch statements. */ 99 | // "noUncheckedIndexedAccess": true, /* Add 'undefined' to a type when accessed using an index. */ 100 | // "noImplicitOverride": true, /* Ensure overriding members in derived classes are marked with an override modifier. */ 101 | // "noPropertyAccessFromIndexSignature": true, /* Enforces using indexed accessors for keys declared using an indexed type. */ 102 | // "allowUnusedLabels": true, /* Disable error reporting for unused labels. */ 103 | // "allowUnreachableCode": true, /* Disable error reporting for unreachable code. */ 104 | 105 | /* Completeness */ 106 | // "skipDefaultLibCheck": true, /* Skip type checking .d.ts files that are included with TypeScript. */ 107 | "skipLibCheck": true /* Skip type checking all .d.ts files. */ 108 | } 109 | } 110 | --------------------------------------------------------------------------------