Espace de noms TypeScript

L'objectif le plus explicite d'un espace de noms est de résoudre le problème des noms en double.

Supposons qu'il y ait une situation où deux élèves nommés Xiao Ming se trouvent dans une classe. Pour les distinguer clairement, nous devons utiliser des informations supplémentaires en plus de leurs noms, comme leurs noms de famille (Wang Xiaoming, Li Xiaoming), ou les noms de leurs parents, etc.

Un espace de noms définit la portée visible d'un identifiant. Un identifiant peut être défini dans plusieurs espaces de noms, et ses significations dans différents espaces de noms sont sans rapport les unes avec les autres. Ainsi, tout identifiant peut être défini dans un nouvel espace de noms, et ils n'entreront en conflit avec aucun identifiant existant, car les définitions existantes sont toutes dans d'autres espaces de noms.

En TypeScript, les espaces de noms sont définis à l'aide denamespacela syntaxe suivante :

namespace SomeNameSpaceName { export interface ISomeInterfaceName { } export class SomeClassName { } }

Ce qui précède définit un espace de noms SomeNameSpaceName. Si nous devons appeler les classes et interfaces de SomeNameSpaceName depuis l'extérieur, nous devons ajouter leexportmot-clé.

Pour l'appeler dans un autre espace de noms, le format de syntaxe est :

SomeNameSpaceName.SomeClassName;

Si un espace de noms se trouve dans un fichier TypeScript séparé, il doit être référencé à l'aide de la triple barre oblique ///, et le format de syntaxe est le suivant :

/// <reference path = "SomeFileName.ts" />

Les exemples suivants illustrent l'utilisation des espaces de noms, définis dans différents fichiers :

Code du fichier IShape.ts :

namespace Drawing { export interface IShape { draw(); } }

Code du fichier Circle.ts :

/// <reference path = "IShape.ts" /> namespace Drawing { export class Circle implements IShape { public draw() { console.log("Le cercle est dessiné"); } } }

Code du fichier Triangle.ts :

/// <reference path = "IShape.ts" /> namespace Drawing { export class Triangle implements IShape { public draw() { console.log("Triangle est dessiné"); } } }

Code du fichier TestShape.ts :

/// <reference path = "IShape.ts" /> /// <reference path = "Circle.ts" /> /// <reference path = "Triangle.ts" /> function drawAllShapes(shape:Drawing.IShape) { shape.draw(); } drawAllShapes(new Drawing.Circle()); drawAllShapes(new Drawing.Triangle());

Utilisez la commande tsc pour compiler le code ci-dessus :

tsc --out app.js TestShape.ts  

Obtenez le code JavaScript suivant :

JavaScript

/// <reference path = "IShape.ts" /> var Drawing; (function (Drawing) { var Circle = /** @class */ (function () { function Circle() { } Circle.prototype.draw = function () { console.log("Circle est dessiné"); }; return Circle; }()); Drawing.Circle = Circle; })(Drawing || (Drawing = {})); /// <reference path = "IShape.ts" /> var Drawing; (function (Drawing) { var Triangle = /** @class */ (function () { function Triangle() { } Triangle.prototype.draw = function () { console.log("Triangle est dessiné"); }; return Triangle; }()); Drawing.Triangle = Triangle; })(Drawing || (Drawing = {})); /// <reference path = "IShape.ts" /> /// <reference path = "Circle.ts" /> /// <reference path = "Triangle.ts" /> function drawAllShapes(shape) { shape.draw(); } drawAllShapes(new Drawing.Circle()); drawAllShapes(new Drawing.Triangle());

Utilisez la commande node pour afficher le résultat de sortie :

$ node app.js
Circle is drawn
Triangle is drawn

Espaces de noms imbriqués

Les espaces de noms prennent en charge l'imbrication, c'est-à-dire que vous pouvez définir un espace de noms à l'intérieur d'un autre espace de noms.

namespace namespace_name1 { export namespace namespace_name2 { export class class_name { } } }

L'accès aux membres se fait à l'aide d'un point.pour l'implémenter, comme dans l'exemple suivant :

Code du fichier Invoice.ts :

namespace Example { export namespace invoiceApp { export class Invoice { public calculateDiscount(price: number) { return price * .40; } } } }

Code du fichier InvoiceTest.ts :

/// <reference path = "Invoice.ts" /> var invoice = new Example.invoiceApp.Invoice(); console.log(invoice.calculateDiscount(500));

Utilisez la commande tsc pour compiler le code ci-dessus :

tsc --out app.js InvoiceTest.ts

Obtenez le code JavaScript suivant :

JavaScript

var Example; (function (Example) { var invoiceApp; (function (invoiceApp) { var Invoice = /** @class */ (function () { function Invoice() { } Invoice.prototype.calculateDiscount = function (price) { return price * .40; }; return Invoice; }()); invoiceApp.Invoice = Invoice; })(invoiceApp = Example.invoiceApp || (Example.invoiceApp = {})); })(Example || (Example = {})); /// <reference path = "Invoice.ts" /> var invoice = new Example.invoiceApp.Invoice(); console.log(invoice.calculateDiscount(500));

Utilisez la commande node pour afficher le résultat de sortie :

$ node app.js
200
Autres extensions