Skip to content
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待

模块:插件

例如,当你想要处理扩展另一个库的 JavaScript 代码时。

ts
import { greeter } from "super-greeter";

// 普通的 Greeter API
greeter(2);
greeter("Hello world");

// 现在我们在运行时用一个新函数扩展该对象
import "hyper-super-greeter";
greeter.hyperGreet();

"super-greeter" 的定义:

ts
/*~ 此示例展示了如何为函数提供多个重载 */
export interface GreeterFunction {
  (name: string): void
  (time: number): void
}

/*~ 此示例展示了如何导出由接口指定的函数 */
export const greeter: GreeterFunction;

我们可以像下面这样扩展现有模块:

ts
// Type definitions for [~THE LIBRARY NAME~] [~OPTIONAL VERSION NUMBER~]
// Project: [~THE PROJECT NAME~]
// Definitions by: [~YOUR NAME~] <[~A URL FOR YOU~]>

/*~ 这是模块插件模板文件。你应该将其重命名为 index.d.ts
 *~ 并将其放在与模块同名的文件夹中。
 *~ 例如,如果你正在为 "super-greeter" 编写文件,此
 *~ 文件应为 'super-greeter/index.d.ts'
 */

/*~ 在这一行,导入此模块所添加的模块 */
import { greeter } from "super-greeter";

/*~ 在这里,声明与上面导入的相同模块
 *~ 然后我们扩展现有的 greeter 函数声明
 */
export module "super-greeter" {
  export interface GreeterFunction {
    /** 甚至更好的问候! */
    hyperGreet(): void;
  }
}

这使用了声明合并

ES6 对模块插件的影响

一些插件会添加或修改现有模块的顶级导出。 虽然在 CommonJS 和其他加载器中这是合法的,但 ES6 模块被认为是不可变的,因此这种模式将无法实现。 由于 TypeScript 与加载器无关,因此对此策略没有编译时强制执行,但打算过渡到 ES6 模块加载器的开发者应该意识到这一点。