Utiliser Typescript avec Node.js

Pour utiliser Typescript côté serveur, on peut choisir Deno, le moteur d'exécution Typescript conçu par le créateur de Node.js. Problème, il n'est pas encore stable. La seconde solution consiste à transpiler notre Typescript avant de l'exécuter avec Node.js. Il existe déjà des tutoriels sur le sujet, mais peu d'entres eux parlent de Backpack. C'est un module bundler pour Node.js basé sur Webpack.

Backpack

On commence par installer Backpack

yarn add -DE backpack-core

Ensuite on va installer Koa qui sera notre serveur

yarn add -E koa

On créé ensuite le serveur dans un fichier se situant dans

// src/index.js
const Koa = require("koa");

const app = new Koa();

app.use(ctx => {
  ctx.body = "Jon Snow meurt saison 5 épisode 10";
});

app.listen(3000);
console.log("listening on port 3000");

Enfin on ajoute les scripts dans notre package.json

{
  "scripts": {
    "dev": "backpack",
    "build": "backpack build"
  }
}

On lance un

...Backpack bundle nos sources Javascript sans problème

Ajout de Typescript

On commence par ajouter Typescript, ainsi que les types pour Node et Koa

yarn add -DE typescript @types/node @types/koa

Puis on initialise une configuration Typescript avec

yarn tsc --init

Il faut renommer le fichier

// src/index.ts
import Koa, { Context } from "koa";

const app: Koa = new Koa();

app.use((ctx: Context) => {
  ctx.body = "Jon Snow meurt saison 5 épisode 10";
});

app.listen(3000);
console.log("listening on port 3000");

Desormais si je lance de nouveau un

L'erreur est explicite, Backpack ne parvient pas à trouver un fichier dans

Backpack étant basé sur Webpack, on va pouvoir utiliser les loaders existants. Ajoutons le loader Typescript.

yarn add -DE ts-loader

Il ne nous reste plus qu'à créer un fichier de configuration nommé

// backpack.config.js
module.exports = {
  webpack: (config, options, webpack) => {
    // nouveau point d'entrée
    config.entry.main = ["./src/index.ts"];

    // résolution automatique des extensions
    config.resolve = {
      extensions: [".ts", ".js", ".json"],
    };

    // loader Typescript
    config.module.rules.push({
      test: /\.ts$/,
      loader: "ts-loader",
    });

    return config;
  },
};

On lance un

Et voilà c'est fini. Simple non ?

Merci de m'avoir lu.