Apprendre les différentes fonctionnalités de TypeScript

Nicolas Legrand

Pour réagir au contenu de ce tutoriel, un espace de dialogue vous est proposé sur le forum. Commentez

- Titre : Apprendre les différentes fonctionnalités de TypeScript

- Auteur : Nicolas Legrand

- Parution : 10 mars 2020

- Licence : Copyright ® 2020 Nicolas Legrand. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Barista part III

- I-A. TypeScript et ses fonctionnalités

- I-B. TypeScript, c’est quoi ?

- I-C. Installer TypeScript

- I-D. La transpilation

- I-E. Le typage de données

- I-F. Les variables et les constantes

- I-G. Templates Strings

- I-H. Les fonctions

- I-I. Les fonctions fléchées

- I-J. Les boucles

- I-K. Les tableaux

- I-L. Les enums

- I-M. Modules

- I-N. Programmation orientée objet (POO)

- I-O. Les classes

- I-P. Héritage

- I-Q. Conclusion

- II. Remerciements Developpez.com

I - Barista part III

I-A - TypeScript et ses fonctionnalités

Animation en format "youtube" non supportée.
Contenu uniquement consultable en ligne à cette adresse :
https://www.youtube.com/watch?v=R6iknAL5xjs

Le cycle Barista utilise le langage TypeScript, toutefois jusqu’ici nous n’avons que très peu utilisé ce langage à bon escient. En effet, nous avons codé comme si nous étions sous JavaScript, il est temps que cela cesse !

Cependant, il est probable que vous ne soyez pas encore à l’aise avec TypeScript. Pourquoi l’utiliser ? Quels avantages apporte-t-il ? Comment l’utiliser ? Vous aurez bientôt toutes les réponses à ces questions.

I-B - TypeScript, c’est quoi ?

TypeScript est un langage de programmation libre et open source développé par Microsoft qui a pour but d’améliorer et de sécuriser la production de code JavaScript. C’est un surensemble de JavaScript (c’est-à-dire que tout code JavaScript correct peut être utilisé avec TypeScript). Le code TypeScript est transpilé en JavaScript, pouvant ainsi être interprété par n’importe quel navigateur web ou moteur JavaScript.

TypeScript permet un typage statique optionnel des variables et des fonctions, la création de classes et d’interfaces, l’import de modules, tout en conservant l’approche non contraignante de JavaScript. Il supporte la spécification ECMAScript 6.

I-C - Installer TypeScript

Même si TypeScript est déjà installé au sein du projet Barista, il est possible que vous souhaitiez l’utiliser en dehors de ce projet, voici la marche à suivre afin de procéder à son installation.

TypeScript n’est pas un langage directement disponible sur le système, il n’est pas non plus interprété directement au sein du navigateur, comme JavaScript. Pour l’utiliser, nous avons besoin de l’installer sur la machine.

Il existe deux façons d’installer TypeScript :

- en installant Visual Studio et le plugin TypeScript ;

- en passant par le gestionnaire de paquets de node.js, npm :

1. #Permet d'installer TypeScript au sein du projet courant

2. #(dans le dossier node_modules)

3. npm install TypeScript

5. #Ou alors, on peut utiliser la méthode suivante qui permet d'installer

6. #TypeScript de façon globale sur la machine

7. npm install -g TypeScript

9. #Puis taper la commande suivante pour obtenir le numéro de version

10. tsc -v

I-D - La transpilation

À ne pas confondre avec « transpiration » (bon j’étais obligé de la faire). La transpilation (ou transcompilation) est en fait une étape que l’on pourrait qualifier de pseudo compilation + traduction. Je m’explique, en gros, le principe de base d’un compilateur est d’analyser votre code source, d’opérer tout un tas de vérifications, etc. Pour finalement traduire le code en langage machine (le fameux code binaire).

TypeScript fonctionne à l’aide d’un programme nommé tsc qui fait la même chose, à ceci près qu’il ne traduit pas le code en binaire, mais en JavaScript! C’est pour ça que l’on dit que TypeScript est un surensemble de JavaScript, car tout code JavaScript est aussi du TypeScript, en vérité à la fin tout est retraduit en JavaScript.

Ce qui signifie que :

- TypeScript n’apporte que du sucre syntaxique à JavaScript ;

- les possibilités de TypeScript ne peuvent aller au-delà des capacités de JavaScript (puisqu’à la fin on transpile tout vers du JavaScript ;

- tout code JavaScript est un code TypeScript valide.

Pour transpiler, il vous suffit d’ouvrir un terminal et de taper la commande suivante :

# Ici on transpile le fichier monfichier.ts et l'on
# obtient ainsi un fichier équivalent, traduit en JavaScript
tsc monfichier.ts

Maintenant que l’on a bien compris ce qu’est TypeScript, passons à la suite.

I-E - Le typage de données

TypeScript doit son nom à l’une de ses fonctionnalités les plus utiles, à savoir le support du typage statique de données. Le typage statique, contrairement au typage dynamique (qui est aussi supporté) permet d’effectuer ce que l’on appelle du type checking à la compilation.

En gros, tsc va vérifier, comme le ferait un compilateur C ou C++, que les données que l’on manipule correspondent bien aux types de données déclarés. Ce qui nous évite de découvrir ce genre d’erreurs une fois le programme lancé.

JavaScript est à la base, un langage interprété, le fait de laisser un outil comme tsc vérifier le type de données revient à faire les vérifications de l’interpréteur, mais avant l’exécution du code, et du coup on ne pousse pas en production un code défectueux (en tout cas pas au niveau du type de données manipulées).

Les types de données de base supportés par TypeScript sont les suivants (liste non exhaustive) :

- Boolean : une simple valeur pouvant être vraie (true) ou fausse (false );

- Number : un nombre flottant (ex. : 1.5) ;

- String : une chaîne de caractères (ex. : "Hello World") ;

- Any : un type désignant « n’importe quel type de données », équivalent du type object en JavaScript ;

- Void : un type désignant du vide, rien, aucune valeur, souvent utilisé pour préciser qu’une fonction/méthode ne retourne pas de valeur (on attend du vide, donc rien) ;

- Enum : un type de données permettant de créer son propre type de données customisé avec un choix prédéfini dans les valeurs (ex. : enum Color {Red, Green, Blue}) ;

- Array : un tableau pouvant contenir toutes sortes d’éléments (ex. : [10,true, "google"] ). On peut également définir le type de données d’un tableau (ex. : let tab:Array;) ;

- Null and Undefined : équivalent des types null et undefined JavaScript.

Il est important de noter qu’il est recommandé de faire appel à l’inférence de type, qui est moins verbeuse et est un mécanisme assez central en TypeScript. Pour les besoins de notre cours, nous emploierons un typage fort explicite, mais je vous encourage vivement à aller jeter un œil à la documentation sur l’inférence de type.

Pour plus de détails sur les types de données en général, rendez-vous sur la documentation en ligne du langage TypeScript.

I-F - Les variables et les constantes

En TypeScript, on n’emploie plus le mot-clé var pour déclarer une variable, mais les mots-clés let et const. Le mot-clé const est utilisé, comme son nom l’indique, pour déclarer une valeur constante, ç.-à-d. une valeur ne pouvant être modifiée, si vous essayez de modifier une constante, une erreur à la compilation est levée. Le mot-clé let est quant à lui utilisé pour déclarer une valeur variable, ç.-à-d. une valeur capable de changer au cours de la durée de vie de votre programme.

Contrairement à JavaScript, qui n’est pas typé, le TypeScript l’est lui, comme son nom l’indique. Il est donc utile de préciser le type de données que l’on souhaite stocker au sein de la variable (ou de la constante) à l’aide de la syntaxe.

1. // constante, ne peut être modifiée

2. const LIGHT_SPEED:string = "299 792 458 m / s";

3. // variable, peut être modifiée

4. let msg:string = "Hello World";

I-G - Templates Strings

Les « templates strings » permettent d’insérer plus facilement des valeurs de variables au sein d’une chaîne de caractères, celles-ci peuvent également être définies sur plusieurs lignes. Il s’agit d’une nouveauté de la norme ES6 et TypeScript la supporte également.

1. let jedi = {surname:"Obiwan", name:"Kenobi"};

2. let msg = `${jedi.name} ${jedi.surname} is the Jedi Master`;

3. console.log(msg);

I-H - Les fonctions

En TypeScript comme en JavaScript, les fonctions sont incontournables. Il s’agit de blocs d’instructions répétables que l’on peut appeler (on dit invoquer) autant de fois que nécessaire. Les fonctions TypeScript, contrairement aux fonctions JavaScript, précisent le type de données qu’elles renvoient, et si elles ne renvoient rien, alors le type de retour est void (du vide).

1. // les paramètres sont typés, et le type de la donnée

2. // retournée également à l'aide de la syntaxe suivante:

3. function sum( a:number, b:number ):number{

4. return a + b;

5. }

7. // quand une fonction ne retourne aucune donnée

8. // alors on le précise en utilisant le type "void"

9. function notif( msg:string ):void{

10. alert(msg);

11. }

13. // les fonctions anonymes sont également utilisables, comme en JS

14. let anonymous:Function = function():void{

15. console.log("I am an anonymous function");

16. };

18. // on peut invoquer une fonction anonyme comme en JS

19. anonymous();

I-I - Les fonctions fléchées

En TypeScript comme en JavaScript ES6, les fonctions fléchées sont supportées, bien entendu le typage des paramètres et En TypeScript comme en JavaScript ES6, les fonctions fléchées sont supportées, bien entendu le typage des paramètres et de la donnée de retour est à ajouter au sein de la version TypeScript. Il est également possible de spécifier des valeurs par défaut aux paramètres. Les fonctions fléchées ont également l’avantage de préserver le contexte this dans lequel elles sont déclarées. La donnée de retour est à ajouter au sein de la version TypeScript. Il est également possible de spécifier des valeurs par défaut aux paramètres. Les fonctions fléchées ont également l’avantage de préserver le contexte dans lequel elles sont déclarées.

1. // fonction fléchée anonyme avec valeur de paramètre par défaut

2. let hello = (param_user: string = "user"): void => {

3. console.log("Hello", param_user);

4. };

6. hello(); // invoquons cette fonction

8. // les fonctions fléchées anonymes préservent le contexte

9. class Gandalf {

10. name: string = "Gandalf";

11. introduce = () => {

12. console.log("Hello my name is", this.name);

13. }

14. }

16. // testons notre code

17. new Gandalf().introduce();

I-J - Les boucles

En TypeScript, les boucles fonctionnent comme en JavaScript :

1. let i:number = 10;

3. // une boucle for classique en TypeScript

4. for( i = 0; i < 10; i ++){

5. console.log(i);

6. }

8. // une boucle while classique en TypeScript

9. i = 10;

10. while( --i > -1 ){

11. console.log(i);

12. }

14. // une boucle do while classique en TypeScript

15. i = -1;

16. do{

17. if( i == -1 ){

18. i = 10;

19. }

20. }while( --i > -1)

I-K - Les tableaux

TypeScript, comme JavaScript, permet de travailler avec des tableaux de valeurs. À la différence qu’en Typescipt, les tableaux (si on le souhaite) peuvent être typés ; ce qui signifie qu’ils ne peuvent contenir qu’un seul type de données. La déclaration de type pour les tableaux peut s’écrire de deux façons :

1. // première façon de déclarer un tableau typé

2. let notes:number[] = [

3. 0,10,12,7,8,20,13,15

4. ];

6. // seconde façon de déclarer un tableau typé

7. let notes2:Array<number> = [

8. 0,10,12,7,8,20,13,15

9. ];

I-L - Les enums

TypeScript nous permet de créer et d’utiliser des enums. Les enums permettent au développeur de créer un lot de constantes et de les regrouper de façon à former un nouveau type de données.

1. // créons un type de données "Direction"

2. // qui peut prendre 4 valeurs différentes

4. enum Direction { Up = 1, Down = 2, Left = 3, Right = 4 };

6. let haut: Direction = Direction.Up;

7. let bas: Direction = Direction.Down;

8. let gauche: Direction = Direction.Left;

9. let droite: Direction = Direction.Right;

11. console.log(haut, bas, gauche, droite);

I-M - Modules

À partir de ECMAScript 2015 (ES6), JavaScript introduit le concept de modules, et bien entendu, ce concept est supporté en TypeScript. Les modules sont exécutés au sein de leur propre portée, et non pas au sein de la portée globale. Cela signifie que les variables, fonctions, classes, etc. déclarées au sein d’un module ne sont pas visibles en dehors du module à moins qu’elles ne soient explicitement exportées à l’aide du mot-clé export. De fait, pour utiliser un élément exporté, au sein d’un module différent, il faut utiliser le mot-clé import.

1. export function toto(){

2. console.log("toto est beau");

3. }

5. import {toto} from './ts_modules_1';

6. toto();

I-N - Programmation orientée objet (POO)

La programmation orientée objet est un style de programmation nous permettant de représenter des concepts informatiques sous forme d’objets. Pour conceptualiser un objet, nous avons besoin de plusieurs outils directement intégrés au langage. Il existe également plusieurs façons de « coder objet », JavaScript est un langage orienté objet par prototypage, mais TypeScript lui émule le comportement d’un langage orienté objet par classe. Il est important de retenir qu’un objet possède plusieurs caractéristiques :

- un objet possède des propriétés, c.-à-d. des variables qui lui appartiennent en propre, la portée de ces propriétés peut être publique, protégée ou privée ;

- un objet possède également des méthodes, c.-à-d. des fonctionnalités (fonctions) qui lui appartiennent en propre, la portée de ces méthodes peut être publique, protégée ou privée ;

- dans un langage orienté objet par classe, un objet peut hériter d’un autre objet ;

- un objet peut prendre plusieurs formes et redéfinir ses propriétés héritées.

Et il ne s’agit ici que des caractéristiques minimales, c.-à-d. celles qui définissent base d’un langage orienté objet, on parle des principes d’encapsulation, d’héritage et de polymorphisme.

I-O - Les classes

Voyons tout de suite comment coder une classe en TypeScript.

1. class Hero{

2. // une propriété peut être publique, protégée ou privée

3. public name:string;

4. public power:string;

6. // la fonction constructrice est invoquée automatiquement

7. // à la création d'un nouvel objet

8. constructor(

9. param_name:string,

10. param_power:string

11. ){

12. // on attribue à nos propriétés les valeurs passées

13. // en paramètres

14. this.name = param_name;

15. this.power = param_power;

16. }

18. // une méthode peut être publique, protégée ou privée

19. public sayMyName():void{

20. console.log(this.name);

21. }

23. public sayMyPower():void{

24. console.log(this.power);

25. }

26. }

28. let myHero:Hero = new Hero("Batman", "Being rich");

29. myHero.sayMyName();

I-P - Héritage

Maintenant, voyons comment une classe peut hériter d’une autre en TypeScript.

1. class Personnage {

2. // on veut transmettre cette propriété à nos enfants, on utilise donc protected

3. protected name: string;

4. // on veut transmettre cette propriété à nos enfants, on utilise donc protected

5. protected lifepoint: number;

6. constructor(param_name: string, param_lifepoint: number) {

7. this.name = param_name;

8. this.lifepoint = param_lifepoint;

9. }

11. //  on doit pouvoir demander à un personnage s'il est mort

12. // sans être soi-même un personnage, la portée est donc publique

13. public isDead(): boolean {

14. // si le nombre de points de vie est inférieur

15. // ou égal à 0 alors le personnage est mort

16. if (this.lifepoint <= 0) {

17. return true;

18. }

19. else {

20. return false;

21. }

22. }

24. public sayMyName():void{

25. console.log(this.name);

26. }

27. }

29. class Wizard extends Personnage{

30. constructor( ){

31. // on peut invoquer le constructor de la classe parente à l'aide de "super"

32. super("Gandalf", 100);

34. //... maintenant un nouvel objet de type wizard se nommera toujours

35. // Gandalf et aura 100 points de vie

36. }

38. // on réécrit la méthode sayMyName définie par le parent

39. // et héritée de celui-ci.

40. public sayMyName():void{

41. //, mais on peut toujours invoquer l'ancienne "version" de la méthode

42. // toujours à l'aide de "super"

43. super.sayMyName();

45. // si on veut, on peut ajouter des opérations supplémentaires

46. console.log("I am a super magician !");

47. }

48. }

50. // on crée un nouveau sorcier

51. let gandalf:Wizard = new Wizard();

52. // on crée un personnage Gollum qui possède 2 points de vie

53. let gollum:Personnage = new Personnage("Gollum", 2);

55. gandalf.sayMyName();

56. gollum.sayMyName();

I-Q - Conclusion

C’est tout pour ce petit tour de TypeScript ! À partir de maintenant nous allons l’utiliser de façon rigoureuse, nous typerons donc l’ensemble de nos variables et nous allons également faire en sorte de créer des objets qui vont représenter les concepts que nous manipulerons. On se dit à bientôt, devant un petit café !

II - Remerciements Developpez.com

Nous tenons à remercier l’auteur Nicolas Legrand. Nos remerciements également à Yahiko pour la relecture technique, Malick pour la mise au gabarit et ClaudeLELOUP pour la relecture orthographique.