TypeScript：覆盖和修复包的类型定义

Question

我正在使用 React victory 库来制作图表，并且我正在使用 TypeScript。我已将 @types/victory 包添加到我的项目中，但不幸的是，它缺少一堆我需要的 key 定义。对于某些接口，它缺少几个属性，因此（使用this answer），我创建了一个自定义文件来将这些属性添加到接口。

但是，现在我有一个问题：为事件定义的接口定义了一个名为eventHandlers 的属性，但它又缺少一个重要的定义，它是如何定义的：

export interface EventPropTypeInterface<TTarget, TEventKey> {
  /* other properties */,
  eventHandlers: {
    [key: string]:
      { (event: React.SyntheticEvent<any>): EventCallbackInterface<TTarget, TEventKey> } |
      { (event: React.SyntheticEvent<any>): EventCallbackInterface<TTarget, TEventKey>[] }
  }

但是，问题是函数应该允许接受第二个参数，例如（我不确定第二个参数的类型，所以我有any）：

{ (event: React.SyntheticEvent<any>, dataPoint: any): EventCallbackInterface<TTarget, TEventKey> }

所以，我尝试将这个属性包含在我自己的定义中：

declare module "victory" {
  export interface EventPropTypeInterface<TTarget, TEventKey> {
  eventHandlers: {
    [key: string]:
      { (event: React.SyntheticEvent<any>, dataPoint: any): EventCallbackInterface<TTarget, TEventKey> } |
      { (event: React.SyntheticEvent<any>, dataPoint: any): EventCallbackInterface<TTarget, TEventKey>[] }
  }
}

但是现在，TypeScript 在抱怨@typings 目录下的index.d.ts，说eventHandlers 必须是我定义的类型。

有没有办法使用提供的类型定义文件，并以某种方式用我自己的定义“增强”它，类似于我在添加新属性时对其他接口所做的那样？

Answer 1

这可以工作。问题是类型的定义没有考虑到可扩展性。

对象字面量类型，例如{x: string}，在许多情况下都很棒，但不适用于复杂的嵌套结构。

原因是这些类型，类似于类型别名，不受制于启用可扩展性所需的声明合并。

如果eventHandlers 对象的可能值的类型被声明为interface，则只需添加额外的重载即可轻松扩展它。

以下自包含示例显示了当类型被重构为使用interface 声明eventHandlers 的值类型时，可扩展性是多么容易：

declare module "victory" {
    interface EventHandler<TTarget, TEventKey> {
        (event: React.SyntheticEvent<any>): EventCallbackInterface<TTarget, TEventKey>
        (event: React.SyntheticEvent<any>): EventCallbackInterface<TTarget, TEventKey>[]
    }

    export interface EventPropTypeInterface<TTarget, TEventKey> {
        eventHandlers: {
            [key: string]: EventHandler<TTarget, TEventKey>

        }
    }
}
declare module "victory" {
    // this interface merges with the original, declaring additional overloads of the all signature
    interface EventHandler<TTarget, TEventKey> {
        // declare overloads
        (event: React.SyntheticEvent<any>, dataPoint: any): EventCallbackInterface<TTarget, TEventKey>
        (event: React.SyntheticEvent<any>, dataPoint: any): EventCallbackInterface<TTarget, TEventKey>[]
    }
}

type EventCallbackInterface<T, U> = {}
declare namespace React {
    export type SyntheticEvent<T> = {};
}

测试：

import victory = require("victory");

declare const handlerProps: victory.EventHandler<{}, {}>;

handlerProps({}, { x: 1, y: 2 }); // works fine

Here is a link to it in action

我强烈建议您向https://github.com/DefinitelyTyped/DefinitelyTyped 提交一个拉取请求，该请求将npm:@types/victory 修改为以这种方式使用interface 以启用这种可扩展性。