Cara yang Benar Menjalankan Typescript di Node.js

Dunia pemrograman website tahun 2025 ini sudah banyak developer yang mengadopsi typescript sebagai bahasa pemrograman untuk membuat website atau aplikasi berbasis nodejs.

Kenapa typescript lebih baik dibanding javascript?. Selain memberikan penulisan tipe pada bahasa javacsript, juga memberikan kemudahan programmer untuk mengubah, mengatur dan mengembangkan software karena typescript menjaga setiap data memiliki tipe yang tepat.

Kenapa nodejs? tidak runtime bun atau runtime deno? karena nodejs sudah ada sejak tahun 2009, artinya ketika artikel ini ditulis sudah berusia 16 tahun!. Pengalaman yang panjang ini pastinya memberikan pengalaman yang solid, komunitas yang luas, dan support yang banyak.

Typescript

Bagaimana cara terbaik menjalankan typescript di nodejs?, mari lihat bagaimana typescript bekerja dengan cara install typescript di folder projek.

$ npm init
$ npm install typescript
$ npx tsc --init

Siapkan file typescript seperti ini

const person: {
  name: string;
  age: number;
} = {
  name: "John Doe",
  age: 30,
}

console.log(`Name: ${person.name}, Age: ${person.age}`);

Kemudian ubah file typescript menjadi javascript menggunakan perintah tsc

$ ls src
main.ts # hanya 1 file typescript
$ npx tsc
$ ls src 
main.js main.ts # menjadi 2 file

Setelah konversi, maka sekarang kita bisa menjalankan file javascript menggunakan nodejs

$ node src/main.js
Name: John Doe, Age: 30

Mari kita coba import dari module yang berbeda

// ./src/greet.ts
export const greet = (name: string): string => {
  return `Hello, ${name}!`;
}

// ./src/main.ts
import { greet } from './greet';

const person: {
  name: string;
  age: number;
} = {
  name: "John Doe",
  age: 30,
}

console.log(greet(person.name));

Kode diatas akan menghasilkan kode javascript seperti berikut

// ./src/greet.js
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.greet = void 0;
const greet = (name) => {
    return `Hello, ${name}!`;
};
exports.greet = greet;

// ./src/main.js
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
const greet_1 = require("./greet");
const person = {
    name: "John Doe",
    age: 30,
};
console.log((0, greet_1.greet)(person.name));

Ok, nampaknya cukup ribet, tapi kode main.js bisa dijalankan dengan baik.

$ node src/main.js
Hello, John Doe!

CommonJS vs Module

Sekarang kita coba gunakan library yaitu chalk agar program kita lebih berwarna

$ npm install chalk

Kemudian update fil greet.ts menjadi seperti ini

import chalk from "chalk";

export const greet = (name: string): string => {
  return `Hello, ${chalk.green(name)}!`;
}

Lalu kita coba jalankan seperti langkah sebelumnya

$ npx tsc
$ node ./src/main.js
/Users/riochandra/dev/project/typescript/src/greet.js:7
const chalk_1 = __importDefault(require("chalk"));
                                ^

Error [ERR_REQUIRE_ESM]: require() of ES Module /Users/riochandra/dev/project/typescript/node_modules/chalk/source/index.js from /Users/riochandra/dev/project/typescript/src/greet.js not supported.
Instead change the require of index.js in /Users/riochandra/dev/project/typescript/src/greet.js to a dynamic import() which is available in all CommonJS modules.
    at Object.<anonymous> (/Users/riochandra/dev/project/typescript/src/greet.js:7:33) {
  code: 'ERR_REQUIRE_ESM'
}

Node.js v22.3.0

Wow.. error? Kenapa ini?

Error ini mengatakan bahwa “Membutuhkan ESM dari modul chalk”. ESM adalah ECMAScript Modules. Sebelum memcahkan masalah ini lebih baik kita kenali dahulu sejarahnya, Nodejs terdapat 2 tipe kode javascript yaitu

const chalk = require('chalk');

console.log(chalk.green("hello"));

import chalk from 'chalk'

console.log(chalk.green("hello"));

Secara default tsc mengubah typescript menjadi CommonJS. Tetapi module yang diimport didalam kode javascript (contohnya chalk) menggunakan tipe ESM. Perbedaan Tipe ini membuat kode javascript tidak bisa dijalankan.

Hanya ada 2 cara agar kode ini bisa dijalankan yaitu:

1. Kode projek diubah menjadi ESM
2. atau bundle seluruh kode (termasuk modul seperti chalk) menjadi CommonJS

Cara 1: Ubah kode projek menjadi ESM

1. tambah type: module di file package.json

{
  "name": "typescript",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",                                                                                            
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "description": "",
  "devDependencies": {
    "typescript": "^5.8.3"
  },
  "dependencies": {
    "chalk": "^5.4.1"
  }
}

2. ubah module di tsconfig.json

    "module": "NodeNext", /* Specify what module code is generated. */

3. tambah .js pada file yang di-impor

import { greet } from './greet.js';

const person: {
  name: string;
  age: number;
} = {
  name: "John Doe",
  age: 30,
}

console.log(greet(person.name));

Selesai.

Sekarang kita bisa jalankan kode typescript tanpa masalah

$ npx tsc && node src/main.js
Hello, John Doe!

Metode ini bisa berjalan normal di lingkungan nodejs saja, sedangkan dilingkungan browser hanya browser terbaru sejak 2016.

Cara 2: Ubah seluruh projek menjadi CommonJS

Mengubah seluruh projek kode termasuk modul terinstall menjadi commonjs adalah salah satu cara yang sering digunakan, selain support pada browser dan teknologi lama juga memiliki kemungkinan digunakan oleh banyak lingkungan.

Typescript tidak bisa mengubah kode didalam node_modules, bundling datang jadi solusi untuk mengubah dan menggabungkan seluruh script menjadi satu file javascript (atau beberapa file). Konsep ini lebih mirip seperti mengubah kode c++ menjadi Executable Binary.

Library yang sering digunakan untuk bundling adalah seperti webpack, esbuild, dan parcel. Kali ini kita akan gunakan esbuild karena kecepatannya dan support typescript. Sehingga kita tidak memerlukan tsc kecuali untuk pengecekan tipe saja.

Mari kembalikan module di tsconfig.json jadi CommonJS

- "module": "ESNext", /* Specify what module code is generated. */
+ "module": "CommonJS", /* Specify what module code is generated. */

Pada file main.ts import file tanpa .js, sehingga seluruh file main.ts seperti ini

-import { greet } from './greet.js';
+import { greet } from './greet';

const person: {
  name: string;
  age: number;
} = {
  name: "John Doe",
  age: 30,
}

console.log(greet(person.name));

Install package esbuild

npm install --save-exact --save-dev esbuild

Buatlah script tambahan di file package.json.

{
  "name": "typescript",
  "version": "1.0.0",
  "main": "index.js",
  "type": "commonjs",
  "scripts": {
    "build": "esbuild src/main.ts --bundle --platform=node --target=node18 --outdir=dist"
  },
  "author": "",
  "license": "ISC",
  "description": "",
  "devDependencies": {
    "esbuild": "0.25.2",
    "typescript": "^5.8.3"
  },
  "dependencies": {
    "chalk": "^5.4.1"
  }
}

Script esbuild memiliki beberapa konfigurasi yaitu:

• src/main.ts, file permulaan yang dibaca pertama kali
• --bundle: Menggabungkan semua file js menjadi 1
• --platform=node: compile untuk nodejs, bukan browser
• --target=node18: karena untuk nodejs, maka targetkan minimal versi nodejs
• --outdir=dist: output folder yaitu folder dist

Jalankan perintah npm run build

$ npm run build

> typescript@1.0.0 build
> esbuild src/main.ts --bundle --platform=node --target=node18 --outdir=dist

  dist/main.js  15.8kb

⚡ Done in 11ms

Periksa apakah file js bisa dijalankan

$ node dist/main.js
Hello, John Doe!

Ok, it works perfectly.

import { greet } from './greet';

const person: {
  name: string;
  age: number;
} = {
  name: "John Doe",
  age: 30,
}

// harusnya error
console.log(greet(person.other));

$ npm run build                                                               

> typescript@1.0.0 build
> esbuild src/main.ts --bundle --platform=node --target=node18 --outdir=dist


  dist/main.js  15.8kb

⚡ Done in 25ms

$ npx tsc --noEmit && npm run build
src/main.ts:11:26 - error TS2339: Property 'other' does not exist on type '{ name: string; age: number; }'.

11 console.log(greet(person.other));
                            ~~~~~


Found 1 error in src/main.ts:11

Dengan cara mengubah kode ESM menjadi CommonJS akan menjadikan kode projek bisa dijalankan SELURUH runtime javascript termasuk browser.

Kesimpulan

Menjalankan typescript di nodejs memerlukan beberapa library seperti typescript dan bundling untuk mengubah kode typescript menjadi javascript. Pemilihan esbuild sebagai library bundling sangat bagus karena sudah support typescript secara default dan memiliki fitur bundling. Terima kasih sudah membaca semoga bermanfaat.