Espacios de nombres TypeScript

El propósito más claro de un espacio de nombres es resolver el problema de los nombres duplicados.

Supongamos una situación en la que hay dos estudiantes llamados Xiao Ming en una clase. Para distinguirlos claramente, además de usar sus nombres, tenemos que usar información adicional, como sus apellidos (Wang Xiaoming, Li Xiaoming), o los nombres de sus padres, etc.

El espacio de nombres define el ámbito de visibilidad de un identificador. Un identificador puede definirse en múltiples espacios de nombres, y su significado en diferentes espacios de nombres no está relacionado. De esta manera, se puede definir cualquier identificador en un nuevo espacio de nombres sin que entre en conflicto con los identificadores existentes, porque las definiciones existentes están todas en otros espacios de nombres.

En TypeScript, los espacios de nombres se definen connamespacey el formato de sintaxis es el siguiente:

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

Lo anterior define un espacio de nombres SomeNameSpaceName. Si necesitamos poder llamar desde el exterior a las clases e interfaces dentro de SomeNameSpaceName, debemos agregar a las clases e interfaces laexportpalabra clave.

Para llamarlo en otro espacio de nombres, el formato de sintaxis es:

SomeNameSpaceName.SomeClassName;

Si un espacio de nombres está en un archivo TypeScript separado, debe referenciarse con la triple barra ///, el formato de sintaxis es el siguiente:

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

Los siguientes ejemplos demuestran el uso de espacios de nombres, definidos en diferentes archivos:

Código del archivo IShape.ts:

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

Código del archivo Circle.ts:

/// <reference path = "IShape.ts" /> namespace Drawing { export class Circle implements IShape { public draw() { console.log("Circle is drawn"); } } }

Código del archivo Triangle.ts:

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

Código del archivo 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());

Use el comando tsc para compilar el código anterior:

tsc --out app.js TestShape.ts  

Se obtiene el siguiente código JavaScript:

JavaScript

/// <reference path = "IShape.ts" /> var Drawing; (function (Drawing) { var Circle = /** @class */ (function () { function Circle() { } Circle.prototype.draw = function () { console.log("Circle is drawn"); }; 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 is drawn"); }; 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());

Use el comando node para ver el resultado de salida:

$ node app.js
Circle is drawn
Triangle is drawn

Espacios de nombres anidados

Los espacios de nombres admiten anidamiento, es decir, puede definir un espacio de nombres dentro de otro espacio de nombres.

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

El acceso a los miembros se realiza usando el punto.para implementarlo, tal como se muestra en el siguiente ejemplo:

Código del archivo Invoice.ts:

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

Código del archivo InvoiceTest.ts:

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

Use el comando tsc para compilar el código anterior:

tsc --out app.js InvoiceTest.ts

Se obtiene el siguiente código JavaScript:

JavaScript

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

Use el comando node para ver el resultado de salida:

$ node app.js
200
Otras extensiones