TypeScript 学习笔记之 Module-蒲公英云

TypeScript 学习笔记之 Module

TS 中的 Module 的概念兼容 ES 2015 中 Module 的概念。

简介

模块中的代码属于模块本身的作用域，而不是全局作用域。也这就意味着没有明确的 export 的话，模块中的变量，函数，类等对其他模块是不见的。相对的其他模块要使用某一模块的内容需要通过 import 导入。

Export

导出一个声明：通过在声明前加 export 关键词修饰即可导出。
导出语句：也可以像 import 语句的逆形式一样，通过类似如下的语句导出：

export { User };
export { User as BaseMember };
从其他模块中导出: export { User as BaseMember } from "./users" }
从其他模块中导出全部： export * from ".users"

Import

从模块中导入单个导出： import { User} from "./users"
导出时重命名 : import { User as BaseMember} from "./users"
从模块中导入全部到一个变量名中:import * as users from "./users"
单纯的导入模块以执行模块: import "./my-module.js"

Default exports

每一个模块都有一个可选的默认导出. 在 export 后面加 default 关键字。
default 导出也支持导出字面量。如: export default "123";

`export =` 和 `import = require()`

在 CommonJS 和 AMD 模块系统中都一个 exports 的变量，用来包装一个模块的所有导出。为了兼容这些模块系统。 TS 也支持 export = 的语法来导出模块的单个对象。但是注意 export = 必须和 import module = require("module") 搭配使用。

导入其他的 JS 库

在 TS 的术语中把没有定义实现的声明称之为 ambient 。这些声明一般定义在 .d.ts 文件中。你可以把他们理解成 c/c++ 中的头文件。

Ambient Modules

例如有一个名为 node.d.ts 的文件。
然后便可以将下面一样来导入：

/// <reference path="node.d.ts"/>
import * as URL from "url";
let myUrl = URL.parse("http://demo.com");

TS 也提供了不提供模块的具体的声明文，来导入 JS 库的支持。
即提供一种简写的方式：
如下 declarations.d.ts

declare module "hot-new-module";

这样模块中所有的导入的类型都将是 any 类型。
import x, {y} from "hot-new-module";

Guidance for structuring modules

导出层级不要太深。从模块中导出一个 namespace 加增加一个层级。如果没有必要不要增加层级。
如果只导出一个单一的类或函数，使用 export default。
导出多个对象时，把他们放在最顶层。
显式的列出所有要导入的名字。
如果要导入很多的东西的时候，可以考虑使用 namespace 导入模式。
如 import * as largeModule from "./MyLargeModule.ts";
通过 re-export 来扩展。
不要在模块中使用 namespaces。

作者：一半晴天
链接：https://www.jianshu.com/p/30a8c7dc85db
來源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。