Project Oxygen & Ideo-LabIDEO LAB Dashboard 2026

đŸ•žïž WebStorm – IDE JavaScript, TypeScript & Frameworks

Guide complet IDEO-Lab pour maĂźtriser l'IDE Web de JetBrains (React, Vue, Angular, Node).

1.1

Vue d'ensemble

Qu'est-ce que WebStorm ? L'IDE JS de JetBrains.

IDE JavaScript TypeScript
1.2

vs. VS Code

Comparaison (IDE IntĂ©grĂ© vs Éditeur Modulaire).

VS Code Refactoring Indexation
1.3

Installation (Toolbox)

Toolbox App (reco), Snap, Inclus dans IntelliJ Ultimate.

Toolbox IntelliJ
2.1

Structure Projet & UI

.idea, package.json, node_modules.

package.json node_modules UI
2.2

Gestion des Paquets

UI npm/yarn, auto-détection package.json.

npm yarn pnpm
2.3

Linters & Formatters

Intégration ESLint, Prettier, Stylelint.

ESLint Prettier Format
3.1

Éditeur & Intentions

Smart completion, Alt+Entrée (imports, types).

Alt+Entrée Completion TypeScript
3.2

Refactoring

Rename (Shift+F6), Extract Component/Hook.

Refactor Shift+F6 Safe
3.3

Navigation (Usages)

Ctrl+B (CSS/JS/HTML), Find Usages (Alt+F7).

Alt+F7 Ctrl+B Navigation
4.1

Run/Debug Configs

Gérer les configurations (Node, npm, Jest).

Run Debug Configuration
4.2

Débogage Node.js

Breakpoints, Stepping (F7/F8), Console.

Debugger Node.js Breakpoints
4.3

Débogage Client (Browser)

Connexion Ă  Chrome/Firefox, DOM, breakpoints.

Chrome Browser Client-side
5.1

Support React

JSX, Hooks, Refactor (Extract Component).

React JSX Hooks
5.2

Support Angular

Intégration CLI, templates, navigation.

Angular TypeScript
5.3

Support Vue.js

SFC (.vue), Nuxt.js, Pinia, Navigation.

Vue.js Nuxt Volar
6.1

Intégration Git

Commit, Push, Pull, Branches, Merge (UI).

Git VCS Ctrl+K
6.2

Tests (Jest, Vitest)

Lancer les tests via l'UI, débogage de tests.

Jest Vitest Test Runner
6.3

Cheat-sheet

Top 10 des raccourcis indispensables.

Shortcuts Raccourcis
1.1 Vue d'ensemble WebStorm
L'IDE JavaScript "Intelligent"

WebStorm est l'Environnement de Développement Intégré (IDE) de JetBrains, spécifiquement conçu pour l'écosystÚme JavaScript et TypeScript.

Il est construit sur la plateforme IntelliJ et est considéré comme l'un des IDE les plus puissants pour le développement front-end et Node.js.

Cas d'usage
  • Front-end : React, Angular, Vue.js, Svelte.
  • Back-end : Node.js, Express, NestJS.
  • Full-stack : Applications TypeScript modernes.
  • Mobile : React Native, Ionic.
Flux de travail typique (JS/TS)
1. Création/Clone Projet
    │
    ▌
2. Installation (npm/yarn)
    │ (WebStorm indexe node_modules)
    ▌
3. Configuration Linter
    │ (ESLint, Prettier)
    ▌
4. Codage
    │ (Éditeur, Auto-complĂ©tion, Alt+EntrĂ©e)
    ▌
5. Refactoring
    │ (Rename, Extract Component)
    ▌
6. Debug
    │ (Serveur Node.js ou Browser Chrome)
    ▌
7. Test
    │ (Lancement de Jest/Vitest)
    ▌
8. Commit (VCS)
1.2 WebStorm vs. VS Code

C'est le dĂ©bat principal dans l'Ă©cosystĂšme JS. Le choix dĂ©pend de la philosophie (IDE vs Éditeur).

CritĂšreWebStormVS Code (avec extensions)
TypeIDE IntĂ©grĂ© (Tout-en-un).Éditeur de code (Modulaire).
Prise en mainPayant. Plus lourd (indexation).Gratuit. Léger, démarrage rapide.
Configuration"Zéro-config". Tout fonctionne (Git, Debug, TS) à l'installation.Nécessite une configuration (launch.json) et des extensions.
RefactoringExcellent. "Safe Rename" (Shift+F6) met à jour les imports et les usages de maniÚre fiable.Bon, mais moins fiable. Le "Rename" est souvent un "Find/Replace" sémantique.
NavigationExcellente. Ctrl+B sur une classe CSS dans du HTML saute au fichier .css.Bonne, mais dépend des extensions (ex: "Go to Definition" sur CSS).
DébogueurExcellent (UI graphique).Excellent (launch.json).

En résumé : WebStorm est un "tank" qui brille par son refactoring sécurisé et son intégration "zéro-config". VS Code est plus léger, gratuit, et incroyablement populaire, mais demande plus de configuration manuelle.

1.3 Installation & Écosystùme
La JetBrains Toolbox App

C'est la méthode d'installation recommandée par JetBrains pour tous les OS (Windows, macOS, Linux).

  1. Téléchargez "Toolbox App" depuis le site de JetBrains.
  2. Installez-la.
  3. Depuis la Toolbox, cliquez sur "Install" à cÎté de "WebStorm".
Avantages de la Toolbox
  • Mises Ă  jour faciles : Met Ă  jour l'IDE en un clic.
  • Rollbacks : Si une mise Ă  jour pose problĂšme, vous pouvez revenir Ă  la version prĂ©cĂ©dente.
  • Gestion centralisĂ©e : GĂšre tous vos IDE JetBrains.
Note : Inclus dans IntelliJ IDEA Ultimate

WebStorm est un IDE payant (aprÚs une période d'essai de 30 jours).

Important : Si vous possédez déjà IntelliJ IDEA Ultimate (pour le développement Java/Kotlin/Spring), vous n'avez pas besoin de WebStorm.

IntelliJ Ultimate contient 100% des fonctionnalités de WebStorm (ainsi que celles de PyCharm Pro, GoLand, etc.) sous forme de plugins pré-installés.

2.1 Structure Projet & UI
Structure de Fichiers

L'IDE est centré sur package.json.

mon-projet/
  ├── .idea/
  │   └── (Fichiers de config de WebStorm.
  │        À mettre dans .gitignore)
  │
  ├── node_modules/
  │   └── (DĂ©pendances. WebStorm les indexe
  │        pour l'auto-complĂ©tion.)
  │
  ├── src/
  │   └── (Vos fichiers .js/.ts)
  │
  ├── package.json
  │   (Le cƓur du projet)
  │
  └── tsconfig.json (ou jsconfig.json)
Indexation

Au premier lancement, WebStorm indexe tout le projet, y compris node_modules. Cela peut prendre du temps, mais c'est ce qui permet :

  • L'auto-complĂ©tion instantanĂ©e des imports.
  • La navigation (Ctrl+B) vers le code source des librairies.
  • Le refactoring "safe".
Vues Principales (Tool Windows)
  • 1. Project (Alt+1) : L'arbre de vos fichiers.
  • 9. Git (Alt+9) : L'interface de version control.
  • 5. Debug (Alt+5) : Le dĂ©bogueur.
  • npm (Tool Window) : GĂ©rer vos scripts et dĂ©pendances.
2.2 Gestion des Paquets (npm/yarn)

WebStorm s'intÚgre profondément avec package.json et vos gestionnaires de paquets (npm, yarn, pnpm).

La FenĂȘtre "npm"

Une fenĂȘtre d'outil dĂ©diĂ©e (Tool Window) "npm" apparaĂźt si un package.json est dĂ©tectĂ©.

Elle liste :

  • Scripts : Tous les scripts de votre package.json ("start", "build", "test"). Vous pouvez double-cliquer pour les lancer.
  • DĂ©pendances : (dependencies, devDependencies).
Gestion Intelligente

Auto-Import : Si vous tapez le nom d'une librairie (ex: axios) dans le code, Alt+Entrée proposera de l'installer (npm install axios) et de l'ajouter à package.json.

Auto-Installation : Si vous ouvrez un projet (ou changez de branche Git) et que package.json a changé, WebStorm vous proposera de lancer npm install.

2.3 Linters & Formatters (ESLint, Prettier)

C'est une des forces de WebStorm : l'intégration "zéro-config" des outils de qualité de code.

ESLint / Stylelint

Si WebStorm détecte eslint (ou stylelint pour CSS) dans votre package.json, il l'active automatiquement.

  • Analyse "on-the-fly" : Les erreurs ESLint apparaissent dans l'Ă©diteur (soulignĂ©es).
  • Alt+EntrĂ©e : Propose de corriger l'erreur (ex: "Fix ESLint problem").
  • Configuration : (Settings > Languages & Frameworks > ESLint) pour configurer l'auto-fix au sauvegardage.
Prettier

L'intégration de Prettier (formateur de code) est également automatique.

  • DĂ©tecte .prettierrc.
  • Permet de reformater le code (Ctrl+Alt+L) en utilisant les rĂšgles de Prettier.
  • Permet de configurer "Reformat on Save".
3.1 Éditeur, Intentions & TypeScript
Intentions (Alt + Entrée)

C'est la "baguette magique" (comme dans tous les IDE JetBrains).

Exemples JS/TS :

  • Import : Si vous tapez useState (React), Alt+EntrĂ©e proposera "Import 'useState' from 'react'".
  • Correction : "Fix ESLint problem".
  • Refactor : "Convert to async function".
  • Types : "Add type annotation" (TS).
Support TypeScript

WebStorm inclut un service TypeScript intégré, qui lit votre tsconfig.json.

Il fournit :

  • Auto-complĂ©tion basĂ©e sur les types (interfaces, classes).
  • Erreurs de type (soulignĂ©es) en temps rĂ©el, sans avoir Ă  lancer tsc.
  • Refactoring intelligent (ex: Renommer un champ d'interface met Ă  jour toutes les implĂ©mentations).
  • Alt+EntrĂ©e pour "Add missing import" ou "Implement interface".
3.2 Refactoring (Le Point Fort)

C'est la raison principale de choisir WebStorm plutĂŽt que VS Code. Le refactoring est "safe" car WebStorm comprend la structure du code grĂące Ă  son indexation.

RaccourciActionDescription
Shift + F6RenameRenomme l'élément (variable, fonction, classe, fichier) ET met à jour tous les imports (import ... from './old-name') dans tout le projet.
Ctrl + Alt + MExtract Method/FunctionSélectionne un bloc de code et le transforme en une nouvelle fonction.
(Alt+Entrée)Extract Component(React/Vue) Sélectionne du JSX/Template et le transforme en un nouveau fichier composant (en passant les props).
Ctrl + Alt + VExtract VariableExtrait une expression dans une variable (const).
F6MoveDéplace un fichier (.ts, .js) et met à jour tous les chemins d'import qui pointaient vers lui.
4.1 Run/Debug Configurations

Les "Run Configurations" (en haut à droite) sont des profils sauvegardés pour lancer ou déboguer des tùches. WebStorm les crée souvent automatiquement.

Types de Configurations Courantes
  • Node.js : ExĂ©cute un fichier .js avec Node (ex: node mon_script.js).
  • npm : ExĂ©cute un script de package.json (ex: npm start). WebStorm dĂ©tecte automatiquement les scripts "dev", "start", "test".
  • Jest / Vitest : ExĂ©cute le "Test Runner" sur vos fichiers de test.
  • JavaScript Debug : (Pour le client) Lance un serveur et ouvre Chrome en mode debug.
4.2 Débogage Node.js (Back-end)

Le débogage de Node.js est "zéro-config".

Workflow
  1. Créez une configuration "Node.js" (ou "npm" pour npm start).
  2. Posez un breakpoint (point rouge) dans la marge.
  3. Cliquez sur l'icîne "Insecte" (Debug 🐞) au lieu de "Play" (Run).
Stepping (Navigation pas-Ă -pas)

Une fois arrĂȘtĂ© sur un breakpoint, la fenĂȘtre "Debug" (Alt+5) s'ouvre :

  • F8 (Step Over) : ExĂ©cute la ligne (sans entrer dans les fonctions).
  • F7 (Step Into) : Entre dans la fonction.
  • Shift + F8 (Step Out) : Sort de la fonction.
  • Variables : Affiche l'Ă©tat de toutes les variables (locales, globales, closures).
  • Console : REPL interactif dans le contexte du breakpoint.
4.3 Débogage Client (Browser)

WebStorm peut se connecter au débogueur du navigateur (Chrome, Firefox) pour vous permettre de déboguer le code front-end (React, Vue) directement dans l'IDE.

Workflow (Exemple avec Create React App)
  1. WebStorm détecte npm start et crée une configuration "npm".
  2. Créez une configuration "JavaScript Debug".
  3. URL : Mettez http://localhost:3000 (l'URL de votre app).
  4. Lancez d'abord "npm start" (Run).
  5. Lancez ensuite "JavaScript Debug" (Debug).

Désormais, un breakpoint posé dans votre code React (JSX) dans WebStorm mettra l'application en pause dans Chrome, et vous pourrez voir les variables et le "Call Stack" dans l'IDE.

5.1 Support React

Le support de React (et JSX/TSX) est une fonctionnalité centrale de WebStorm.

  • ComprĂ©hension du JSX : Auto-complĂ©tion des composants (ex: <MyComp...), des props, et des attributs HTML.
  • Hooks : ComprĂ©hension des rĂšgles des Hooks (ex: alerte si useState est dans un if).
  • Refactoring (Alt+EntrĂ©e) :
    • "Extract Component" : SĂ©lectionne du JSX et crĂ©e un nouveau fichier .jsx.
    • "Add import" pour les composants.
  • Navigation (Ctrl+B) : Saute de l'utilisation d'un composant (<Button />) Ă  sa dĂ©finition.
5.2 Support Angular

WebStorm offre le meilleur support du marché pour Angular (historiquement, Angular est développé avec IntelliJ/WebStorm chez Google).

  • IntĂ©gration CLI : Outil graphique pour ng generate, ng serve...
  • Templates HTML : ComprĂ©hension complĂšte des templates Angular (*ngFor, [property], (event)).
  • Navigation (Ctrl+B) :
    • Saute du template .html au champ .ts.
    • Saute de templateUrl au fichier .html.
  • Refactoring (Shift+F6) : Renommer une variable dans le .ts la renomme dans le .html.
5.3 Support Vue.js

WebStorm (via le plugin Volar ou l'intégration native) supporte pleinement Vue.js (2 et 3).

  • Support des SFC (.vue) : ComprĂ©hension des blocs <template>, <script setup>, et <style scoped>.
  • Auto-complĂ©tion : ComplĂ©tion des props, de l'API (ref, computed).
  • Navigation : Ctrl+B sur un composant dans le template saute Ă  son import.
  • Frameworks : Support pour Nuxt.js, Pinia, Vuex.
6.1 Intégration Git

L'intĂ©gration VCS (Git) est identique Ă  celle d'IntelliJ IDEA. Elle est extrĂȘmement complĂšte et visuelle.

RaccourciActionDescription
Ctrl + KCommitOuvre la fenĂȘtre "Commit". Montre les fichiers modifiĂ©s (diff), permet d'Ă©crire le message, de cocher les fichiers.
Ctrl + Shift + KPushPousse les commits locaux.
Ctrl + TUpdate Project (Pull)Tire les changements (Pull). Vous pouvez choisir Merge ou Rebase.
Alt + 9Git Tool WindowOuvre la vue "Git", qui montre l'historique (Log) du projet et des branches.
Gestion des Branches

En bas à droite, le sélecteur de branche permet de voir la branche actuelle, de créer/changer de branche (Checkout), et de gérer les fusions (Merge) et les conflits visuellement.

6.2 Tests (Jest, Vitest, Cypress)

WebStorm intĂšgre des "Test Runners" graphiques pour les frameworks de test les plus populaires.

Jest / Vitest

WebStorm détecte les fichiers .test.js ou .spec.ts.

Vous pouvez cliquer sur l'icÎne "Play" (flÚche verte) dans la marge à cÎté d'un describe ou it pour :

  • Run : Lancer ce test (ou cette suite).
  • Debug : Lancer ce test avec le dĂ©bogueur attachĂ©.

Une fenĂȘtre de rĂ©sultats (Vert/Rouge) s'ouvre pour voir les Ă©checs.

Cypress & Playwright

WebStorm (via des plugins ou intégrations natives) supporte les tests End-to-End (E2E).

  • Auto-complĂ©tion des commandes (cy.get()).
  • PossibilitĂ© de lancer le runner E2E depuis l'IDE.
6.3 Cheat-sheet (Top Raccourcis)

Les raccourcis sont identiques Ă  ceux d'IntelliJ et PyCharm.

Top 10 (Indispensables)
1. Shift + Shift
   (Search Everywhere)

2. Alt + Entrée
   (Show Intentions / "Baguette Magique")

3. Ctrl + N
   (Go to Class - ou Symbole JS)

4. Ctrl + Shift + N
   (Go to File)

5. Alt + F7
   (Find Usages)

6. Shift + F6
   (Rename / Refactor)

7. Ctrl + B
   (Go to Definition)

8. F8
   (Step Over - Debug)

9. Ctrl + K
   (Commit - Git)

10. Ctrl + Espace
    (Basic Completion)
Édition & Refactor
Ctrl + W / Ctrl + Shift + W
(Extend / Shrink Selection)

Ctrl + D
(Duplicate Line)

Ctrl + Y
(Delete Line)

Ctrl + /
(Comment / Uncomment Line)

Ctrl + Alt + L
(Reformat Code - Prettier)

Ctrl + Alt + O
(Optimize Imports)
Navigation & Vues
Alt + 1
(Project View)

Alt + 5
(Debug View)

Alt + 9
(Git View)

Alt + F12
(Terminal)

Ctrl + E
(Recent Files)