TypeScript与JavaScript不同之处系列 ===; 命名空间, 三斜线指令

Posted 2022-03-12 刘翾

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了TypeScript与JavaScript不同之处系列 ===; 命名空间, 三斜线指令相关的知识，希望对你有一定的参考价值。

本系列目的: 列出TypeScript与javascript的不同点, 缩小文档内容, 提高学习速度. 原文档地址: https://www.tslang.cn/index.html

全系列目录

1.基础类型 https://blog.csdn.net/c_kite/article/details/85232021
2.接口 https://blog.csdn.net/c_kite/article/details/85262016
3.类 https://blog.csdn.net/c_kite/article/details/85274189
4.函数 https://blog.csdn.net/c_kite/article/details/85283691
5.泛型 https://blog.csdn.net/c_kite/article/details/85335913
6.枚举 https://blog.csdn.net/c_kite/article/details/85337336
7.类型推论, 类型兼容性 https://blog.csdn.net/c_kite/article/details/85380924
8.高级类型 https://blog.csdn.net/c_kite/article/details/85457753
9.命名空间, 三斜线指令 https://blog.csdn.net/c_kite/article/details/85524576

Symbol, 迭代器和生成器, 模块与原生js重合度太高不整理

1. 命名空间

1.1. 简单使用

解决问题; 我们需要一种手段来组织代码，以便于在记录它们类型的同时还不用担心与其它对象产生命名冲突。因此，我们把代码包裹到一个命名空间内，而不是把它们放在全局命名空间下

例子, 未使用命名空间, 定义几个简单的字符串验证器

interface StringValidator 
    isAcceptable(s: string): boolean;


let lettersRegexp = /^[A-Za-z]+$/;
let numberRegexp = /^[0-9]+$/;

class LettersOnlyValidator implements StringValidator 
    isAcceptable(s: string) 
        return lettersRegexp.test(s);
    


class ZipCodeValidator implements StringValidator 
    isAcceptable(s: string) 
        return s.length === 5 && numberRegexp.test(s);
    


let strings = ["Hello", "98052", "101"];

let validators:  [s: string]: StringValidator;  = ;
validators["ZIP code"] = new ZipCodeValidator();
validators["Letters only"] = new LettersOnlyValidator();

for (let s of strings) 
    for (let name in validators) 
        let isMatch = validators[name].isAcceptable(s);
        console.log(`'$ s ' $ isMatch ? "matches" : "does not match"  '$ name '.`);

使用关键字namespace, 用命名空间重写上面代码, 并使用关键字export暴露出功能

namespace Validation 
    export interface StringValidator 
        isAcceptable(s: string): boolean;
    

    const lettersRegexp = /^[A-Za-z]+$/;
    const numberRegexp = /^[0-9]+$/;

    export class LettersOnlyValidator implements StringValidator 
        isAcceptable(s: string) 
            return lettersRegexp.test(s);
        
    

    export class ZipCodeValidator implements StringValidator 
        isAcceptable(s: string) 
            return s.length === 5 && numberRegexp.test(s);
        
    


let strings = ["Hello", "98052", "101"];

// 由于是在命名空间之外访问，因此需要限定类型的名称，比如 Validation.StringValidator
let validators:  [s: string]: Validation.StringValidator;  = ; 
validators["ZIP code"] = new Validation.ZipCodeValidator();
validators["Letters only"] = new Validation.LettersOnlyValidator();

for (let s of strings) 
    for (let name in validators) 
        console.log(`"$ s " - $ validators[name].isAcceptable(s) ? "matches" : "does not match"  $ name `);

1.2. 分离文件

解决问题: 当应用变得越来越大时，我们需要将代码分离到不同的文件中以便于维护。

现在，我们把Validation命名空间分割成多个文件。尽管是不同的文件，它们仍是同一个命名空间，并且在使用的时候就如同它们在一个文件中定义的一样。因为不同文件之间存在依赖关系，所以我们加入了引用标签来告诉编译器文件之间的关联。我们的测试代码保持不变。

a.ts文件

namespace Validation 
    export interface StringValidator 
        isAcceptable(s: string): boolean;

b.ts文件

// 此处为三斜线指令, 文章末尾有介绍
/// <reference path="a.ts" />
namespace Validation 
    const lettersRegexp = /^[A-Za-z]+$/;
    export class LettersOnlyValidator implements StringValidator 
        isAcceptable(s: string) 
            return lettersRegexp.test(s);

c.ts文件

/// <reference path="a.ts" />
namespace Validation 
    const numberRegexp = /^[0-9]+$/;
    export class ZipCodeValidator implements StringValidator 
        isAcceptable(s: string) 
            return s.length === 5 && numberRegexp.test(s);

d.ts文件

/// <reference path="a.ts" />
/// <reference path="b.ts" />
/// <reference path="c.ts" />

let strings = ["Hello", "98052", "101"];

// Validators to use
let validators:  [s: string]: Validation.StringValidator;  = ;
validators["ZIP code"] = new Validation.ZipCodeValidator();
validators["Letters only"] = new Validation.LettersOnlyValidator();

// Show whether each string passed each validator
for (let s of strings) 
    for (let name in validators) 
        console.log(`"$ s " - $ validators[name].isAcceptable(s) ? "matches" : "does not match"  $ name `);

当涉及到多文件时，我们必须确保所有编译后的代码都被加载了。我们有两种方式。
第一种方式，把所有的输入文件编译为一个输出文件，需要使用–outFile标记：

tsc --outFile 输出文件名.js 入口文件.ts
tsc --outFile gkd.js d.ts

第二种方式，我们可以编译每一个文件（默认方式），那么每个源文件都会对应生成一个JavaScript文件。然后，在页面上通过<script>标签把所有生成的JavaScript文件按正确的顺序引进来，比如：

   <script src="a.js" type="text/javascript" />
    <script src="b.js" type="text/javascript" />
    <script src="c.js" type="text/javascript" />
    <script src="d.js" type="text/javascript" />

1.3. 别名

namespace Shapes 
  export namespace Polygons 
    export function gkd ():void 
      num++;
    
    export let num = 0;
  


import polygons = Shapes.Polygons;
let sq = polygons.num; // 等同于 "Shapes.Polygons.num"
console.log(sq); // 0

polygons.gkd();
console.log(sq); // 0

注意: 此import不同于es2015的import, es2015的import拿的是值的引用, 而这里时赋值操作!!!, 从下面编译后的代码中可见一斑

var Shapes;
(function (Shapes) 
    var Polygons;
    (function (Polygons) 
        function gkd() 
            Polygons.num++;
        
        Polygons.gkd = gkd;
        Polygons.num = 0;
    )(Polygons = Shapes.Polygons || (Shapes.Polygons = ));
)(Shapes || (Shapes = ));
var polygons = Shapes.Polygons; // 赋值操作
var sq = polygons.num;
console.log(sq);
polygons.gkd();
console.log(sq);