Démarrer et tester un projet TypeScript

Ce guide part du principe que Node.js est déjà installé sur la machine.

L’objectif est simple : savoir créer un projet TypeScript, le lancer, puis le tester avec des commandes faciles à retenir.

1. Créer le projet

Commencez par créer un dossier puis initialiser un projet npm.

mkdir mon-projet-typescript
cd mon-projet-typescript
npm init -y

2. Installer TypeScript

Installez TypeScript en dépendance de développement.

npm install -D typescript

Si vous voulez exécuter directement vos fichiers TypeScript sans étape de compilation manuelle, ajoutez aussi un outil de lancement rapide :

npm install -D tsx

3. Créer la configuration TypeScript

Générez le fichier de configuration TypeScript.

npx tsc --init

Un fichier tsconfig.json est créé. Pour un projet de découverte, une configuration simple suffit généralement.

4. Créer un premier fichier

Créez un dossier src puis un fichier d’entrée.

mkdir src

Dans src/index.ts, mettez par exemple :

function hello(name: string): string {
    return `Bonjour ${name}`
}

console.log(hello("les étudiants"))

5. Lancer le projet

Option simple: lancer le fichier TypeScript directement

npx tsx src/index.ts

Option classique: compiler puis exécuter le JavaScript généré

Ajoutez un script de compilation dans package.json :

{
  "scripts": {
    "build": "tsc"
  }
}

Puis lancez :

npm run build
node dist/index.js