# 模块

"内部模块"现在称做"命名空间"。 "外部模块"现在则简称为"模块"

## 1. 导出

任何声明(比如变量，函数，类，类型别名或者接口) 都能通过添加 `export` 关键字来导出

```javascript
export interface StringValidator {
    isAcceptable(s: string): boolean;
}
```

## 2. 导入

### 具有副作用的导入模块

尽管不推荐这么做，一些模块会设置一些全局状态供其它模块使用。 这些模块可能没有任何的导出或用户根本就不关注它的导出。 使用下面的方法来导入这类模块：

```javascript
import "./my-module.js";
import './index.less';
```

## 3. TypeScript 中的导入导出

当前导入(import)导入(export)的语法，并不兼容 CommonJS 中的 `exports`, 因此， TypeScript 引入了 `export =` 和 `import = require()` 的语法

使用 `export =` 导出对象，这里的对象指，类，接口,命名空间 ,函数或枚举. 如果使用 `export =`导出，必须使用`import module = require('module')` 来导入

```javascript
let numberRegexp = /^[0-9]+$/;
class ZipCodeValidator {
    isAcceptable(s: string) {
        return s.length === 5 && numberRegexp.test(s);
    }
}
export = ZipCodeValidator;  // 导出


import zip = require("./ZipCodeValidator");  // 导入
new zip().isAcceptable(str);
```

## 4. 将 TypeScript 模块转为其它模块代码

示例: `tsc --module commonjs Test.ts`

TypeScript源码:

```javascript
import m = require("mod");
export let t = m.something + 1;
```

转换为 AMD/ RequireJS

```javascript
define(["require", "exports", "./mod"], function (require, exports, mod_1) {
    exports.t = mod_1.something + 1;
});
```

转换为 CommonJS/Node

```javascript
let mod_1 = require("./mod");
exports.t = mod_1.something + 1;
```

转化为 UMD

```javascript
(function (factory) {
    if (typeof module === "object" && typeof module.exports === "object") {
        let v = factory(require, exports); if (v !== undefined) module.exports = v;
    }
    else if (typeof define === "function" && define.amd) {
        define(["require", "exports", "./mod"], factory);
    }
})(function (require, exports) {
    let mod_1 = require("./mod");
    exports.t = mod_1.something + 1;
});
```

转换为 System 模块

```javascript
System.register(["./mod"], function(exports_1) {
    let mod_1;
    let t;
    return {
        setters:[
            function (mod_1_1) {
                mod_1 = mod_1_1;
            }],
        execute: function() {
            exports_1("t", t = mod_1.something + 1);
        }
    }
});
```

转换为 es6 import

```javascript
import { something } from "./mod";
export let t = something + 1;
```

## 5. 可选的模块加载和其它高级加载场景

**外部模块**

在 Node 中大部分工作通过加载的模块实现的，我们可以使用顶级的 `export` 声明来为每个模块定义一个 `.d.ts` 文件, 也可以在一个 `.d.ts` 文件中完成。

当遇到多个模块时，我们使用与构造一个外部命名空间类似的方法，使用 `module` 关键字并将名字用引号括起来，方便之后 import。 如:

```javascript
declare module "url" {
    export interface Url {
        protocol?: string;
        hostname?: string;
        pathname?: string;
    }

    export function parse(urlStr: string, parseQueryString?, slashesDenoteHost?): Url;
}

declare module "path" {
    export function normalize(p: string): string;
    export function join(...paths: any[]): string;
    export let sep: string;
}
```

使用:

```javascript
/// <reference path="node.d.ts"/>
import * as URL from "url";
let myUrl = URL.parse("http://www.typescriptlang.org");
```

**模块声明通配符**

当加载一些非 JS 内容时，通常会使用一个前缀或者后缀来表示特殊的加载语法，这时候就要用到模块声明通配符

```javascript
declare module "*!text" {
    const content: string;
    export default content;
}
// Some do it the other way around.
declare module "json!*" {
    const value: any;
    export default value;
}
```

现在就可以加载匹配"*!text"或"json!*"的内容了。

```javascript
import fileContent from "./xyz.txt!text";
import data from "json!http://example.com/data.json";
console.log(data, fileContent);
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://yes-1-am.gitbook.io/blog/typescript-yu-fa/mo-kuai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.