在 TypeScript 中以类型安全的方式使用静态函数从外部库扩展类

Question

我想用 static 函数扩展 rxjs5 Observable 类。我可以用纯 JavaScript 做到这一点：

var myStaticFn = function() { /* ... */ };
Observable.myStaticFn = myStaticFn;

这可行，但在 TypeScript 中我无法访问 Observable.myStaticFn，因为 myStaticFn 在类 Observable 上是未知的。

如何声明/增加 rxjs5 Module Observable 类，以便以类型安全的方式访问我的函数？

注意：作为一个起点，下面展示了如何将一个非静态函数扩展到 Observable（例如创建一个自定义的 rxjs Operator）的示例，这完全有效，但不是我想要的！

function myOperator(this: Observable<any>): Observable<any> = function(){ /*...*/ };
Observable.prototype.myOperator = myOperator;

declare module "rxjs/Observable" {
    interface Observable<T> {
        myOperator: typeof myOperator;
    }
}

上述方法有效，因为 TypeScript 的 declare 语法允许我将 Observable 视为接口，并且可以扩充/合并接口。但是 TypeScript 没有办法在接口上声明 static 函数。

从Observable 类派生也是不可行的，比如ExtendedObservable，因为我的代码的每个用户都必须在整个项目中使用ExtendedObservable 类型而不是Observable 类型，以及这个概念如果我想在 Observable 上放置不同的静态方法，也会失败，具体取决于导入的模块。

Answer 1

我发现自己在看at the implementation of the static .from() extension in the RxJS source:

import { myStaticFn as myStaticFnStatic } from "./myStaticFn";

declare module "rxjs/Observable" {
    namespace Observable {
        let myStaticFn: myStaticFnStatic;
    }
}

请注意我如何导入 myStaticFn，但将其范围限定为名称 myStaticFnStatic - 这是必需的，否则会出现编译器错误。

Answer 2

在 rx 的定义文件中，您有 Observable 类和 ObservableStatic 的定义。
如果要添加静态函数，则需要扩充ObservableStatic：

declare module "rxjs/Observable" {
    interface ObservableStatic {
        myOperator: typeof myOperator;
    }
}

Answer 3

你需要声明一个与接口同名的模块。在模块内部，您编写静态函数。这是 TypeScript 中的最佳实践。这叫做“模块合并”。

参考：Pro TypeScript pages #40 #41

请注意：自本书编写以来，Microsoft 已将术语“内部模块”更改为“命名空间”：Namespaces