覆盖 Typescript d.ts 文件中定义的接口属性类型

我使用一种方法，首先过滤字段，然后将它们组合起来。

参考Exclude property from type

interface A {
    x: string
}

export type B = Omit<A, 'x'> & { x: number };

对于接口：

interface A {
    x: string
}

interface B extends Omit<A, 'x'> {
  x: number
}

---

 type ModifiedType = Modify<OriginalType, {
  a: number;
  b: number;
}>
 
interface ModifiedInterface extends Modify<OriginalType, {
  a: number;
  b: number;
}> {}

受 ZSkycat's extends Omit 解决方案的启发，我想出了这个：

type Modify = Omit & R; // 在 typescript@3.5 之前 type Modify = Pick> & R

例子：

interface OriginalInterface {
  a: string;
  b: boolean;
  c: number;
}

type ModifiedType  = Modify<OriginalInterface , {
  a: number;
  b: number;
}>

// ModifiedType = { a: number; b: number; c: number; }

一步一步来：

type R0 = Omit<OriginalType, 'a' | 'b'>        // { c: number; }
type R1 = R0 & {a: number, b: number }         // { a: number; b: number; c: number; }

type T0 = Exclude<'a' | 'b' | 'c' , 'a' | 'b'> // 'c'
type T1 = Pick<OriginalType, T0>               // { c: number; }
type T2 = T1 & {a: number, b: number }         // { a: number; b: number; c: number; }

TypeScript Utility Types

v2.0 深度修改

interface Original {
  a: {
    b: string
    d: {
      e: string // <- will be changed
    }
  }
  f: number
}

interface Overrides {
  a: {
    d: {
      e: number
      f: number // <- new key
    }
  }
  b: {         // <- new key
    c: number
  }
}

type ModifiedType = ModifyDeep<Original, Overrides>
interface ModifiedInterface extends ModifyDeep<Original, Overrides> {}

// ModifiedType =
{
  a: {
    b: string
    d: {
      e: number
      f: number
    }
  }
  b: {
    c: number
  }
  f: number
}

找到 ModifyDeep below。

---

您不能更改现有属性的类型。

您可以添加一个属性：

interface A {
    newProperty: any;
}

但是改变一种现有的类型：

interface A {
    property: any;
}

导致错误：

后续的变量声明必须具有相同的类型。变量“property”必须是“number”类型，但这里有“any”类型

您当然可以拥有自己的界面来扩展现有界面。在这种情况下，您可以仅将类型覆盖为兼容类型，例如：

interface A {
    x: string | number;
}

interface B extends A {
    x: number;
}

顺便说一句，您可能应该避免使用 Object 作为类型，而是使用类型 any。

在 docs for the any type 中它指出：

any 类型是使用现有 JavaScript 的一种强大方式，允许您在编译期间逐渐选择加入和退出类型检查。您可能希望 Object 扮演类似的角色，就像它在其他语言中所做的那样。但是 Object 类型的变量只允许您为它们分配任何值 - 您不能对它们调用任意方法，即使是实际存在的方法：

let notSure: any = 4;
notSure.ifItExists(); // okay, ifItExists might exist at runtime
notSure.toFixed(); // okay, toFixed exists (but the compiler doesn't check)

let prettySure: Object = 4;
prettySure.toFixed(); // Error: Property 'toFixed' doesn't exist on type 'Object'.

---

像我这样懒惰的人的简短回答：

type Overrided = Omit<YourInterface, 'overrideField'> & { overrideField: <type> }; 

interface Overrided extends Omit<YourInterface, 'overrideField'> {
  overrideField: <type>
}

---

稍微扩展@zSkycat 的答案，您可以创建一个接受两种对象类型并返回合并类型的泛型，其中第二个的成员覆盖第一个的成员。

type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>
type Merge<M, N> = Omit<M, Extract<keyof M, keyof N>> & N;

interface A {
    name: string;
    color?: string;
}

// redefine name to be string | number
type B = Merge<A, {
    name: string | number;
    favorite?: boolean;
}>;

let one: A = {
    name: 'asdf',
    color: 'blue'
};

// A can become B because the types are all compatible
let two: B = one;

let three: B = {
    name: 1
};

three.name = 'Bee';
three.favorite = true;
three.color = 'green';

// B cannot become A because the type of name (string | number) isn't compatible
// with A even though the value is a string
// Error: Type {...} is not assignable to type A
let four: A = three;

---

Omit 扩展接口时的属性：

interface A {
  a: number;
  b: number;
}

interface B extends Omit<A, 'a'> {
  a: boolean;
}

---

我创建了这种类型，允许我轻松覆盖嵌套接口：

type ModifyDeep<A extends AnyObject, B extends DeepPartialAny<A>> = {
  [K in keyof A]: B[K] extends never
    ? A[K]
    : B[K] extends AnyObject
      ? ModifyDeep<A[K], B[K]>
      : B[K]
} & (A extends AnyObject ? Omit<B, keyof A> : A)

/** Makes each property optional and turns each leaf property into any, allowing for type overrides by narrowing any. */
type DeepPartialAny<T> = {
  [P in keyof T]?: T[P] extends AnyObject ? DeepPartialAny<T[P]> : any
}

type AnyObject = Record<string, any>

然后你可以像这样使用它：

interface Original {
  a: {
    b: string
    d: {
      e: string // <- will be changed
    }
  }
  f: number
}

interface Overrides {
  a: {
    d: {
      e: number
      f: number // <- new key
    }
  }
  b: {         // <- new key
    c: number
  }
}

type ModifiedType = ModifyDeep<Original, Overrides>
interface ModifiedInterface extends ModifyDeep<Original, Overrides> {}

// ModifiedType =
{
  a: {
    b: string
    d: {
      e: number
      f: number
    }
  }
  b: {
    c: number
  }
  f: number
}

---

为了缩小属性的类型，简单的 extend 效果很好，如 Nitzan's answer：

interface A {
    x: string | number;
}

interface B extends A {
    x: number;
}

要扩大或通常覆盖类型，您可以执行 Zskycat's solution：

interface A {
    x: string
}

export type B = Omit<A, 'x'> & { x: number };

但是，如果您的接口 A 扩展了一个通用接口，那么在使用 Omit 时您将失去 A 剩余属性的自定义类型。

例如

interface A extends Record<string | number, number | string | boolean> {
    x: string;
    y: boolean;
}

export type B = Omit<A, 'x'> & { x: number };

let b: B = { x: 2, y: "hi" }; // no error on b.y! 

原因是，Omit 在内部只遍历 Exclude<keyof A, 'x'> 键，在我们的例子中这将是通用的 string | number。因此，B 将变为 {x: number; } 并接受任何类型为 number | string | boolean 的额外属性。

为了解决这个问题，我想出了一个不同的 OverrideProps 实用程序类型，如下所示：

type OverrideProps<M, N> = { [P in keyof M]: P extends keyof N ? N[P] : M[P] };

例子：

type OverrideProps<M, N> = { [P in keyof M]: P extends keyof N ? N[P] : M[P] };

interface A extends Record<string | number, number | string | boolean> {
    x: string;
    y: boolean;
}

export type B = OverrideProps<A, { x: number }>;

let b: B = { x: 2, y: "hi" }; // error: b.y should be boolean!

---

有趣的是，我花了一天时间调查解决同一案件的可能性。我发现不可能这样做：

// a.ts - module
export interface A {
    x: string | any;
}

// b.ts - module
import {A} from './a';

type SomeOtherType = {
  coolStuff: number
}

interface B extends A {
    x: SomeOtherType;
}

原因 模块可能不知道应用程序中的所有可用类型。从任何地方移植所有内容并编写这样的代码是非常无聊的。

export interface A {
    x: A | B | C | D ... Million Types Later
}

您必须稍后定义类型才能使自动完成功能正常工作。

所以你可以作弊一点：

// a.ts - module
export interface A {
    x: string;
}

在不需要覆盖时，默认保留 some 类型，允许自动完成工作。

然后

// b.ts - module
import {A} from './a';

type SomeOtherType = {
  coolStuff: number
}

// @ts-ignore
interface B extends A {
    x: SomeOtherType;
}

在此处使用 @ts-ignore 标志禁用愚蠢的异常，告诉我们我们做错了什么。有趣的是，一切都按预期进行。

就我而言，我正在缩小类型 x 的范围，它允许我执行更严格的代码。例如，您有 100 个属性的列表，然后将其减少到 10 个，以避免出现愚蠢的情况

---

日期：19/3/2021。我认为最新的 typescript(4.1.2) 版本支持 d.ts 文件中的 interface 覆盖。

// in test.d.ts

interface A {
  a: string
}

export interface B extends A {
  a: number
}

// in any ts file
import { B } from 'test.d.ts'

// this will work
const test: B = { a: 3 }

// this will not work
const test1: B = { a: "3" }

---

如果其他人需要通用实用程序类型来执行此操作，我想出了以下解决方案：

/**
 * Returns object T, but with T[K] overridden to type U.
 * @example
 * type MyObject = { a: number, b: string }
 * OverrideProperty<MyObject, "a", string> // returns { a: string, b: string }
 */
export type OverrideProperty<T, K extends keyof T, U> = Omit<T, K> & { [P in keyof Pick<T, K>]: U };

我需要这个，因为在我的情况下，覆盖的关键是泛型本身。

如果您没有准备好 Omit，请参阅 Exclude property from type。

---

如果您只想修改现有属性的类型而不删除它，那么 & 就足够了：

// Style that accepts both number and percent(string)
type BoxStyle = {
  height?: string | number,
  width?: string | number,
  padding?: string | number,
  borderRadius?: string | number,
}

// These are both valid
const box1: BoxStyle = {height: '20%', width: '20%', padding: 0, borderRadius: 5}
const box2: BoxStyle = {height: 85, width: 85, padding: 0, borderRadius: 5}

// Override height and width to be only numbers
type BoxStyleNumeric = BoxStyle & {
  height?: number,
  width?: number,
}

// This is still valid
const box3: BoxStyleNumeric = {height: 85, width: 85, padding: 0, borderRadius: 5}

// This is not valid anymore
const box4: BoxStyleNumeric = {height: '20%', width: '20%', padding: 0, borderRadius: 5}

---

注意：不确定在编写较旧的答案时我在此答案中使用的语法是否可用，但我认为这是解决此问题中提到的示例的更好方法。

我遇到了一些与此主题相关的问题（覆盖接口属性），这就是我处理它的方式：

首先创建一个通用接口，其中包含您想要使用的可能类型。

您甚至可以为通用参数选择一个 default 值，如 <T extends number | SOME_OBJECT = number> 中所示

type SOME_OBJECT = { foo: "bar" }

interface INTERFACE_A <T extends number | SOME_OBJECT = number> {
  property: T;
}

然后，您可以通过将值传递给泛型参数（或省略它并使用默认值）来基于该协定创建新类型：

type A_NUMBER = INTERFACE_A;                   // USES THE default = number TYPE. SAME AS INTERFACE_A<number>
type A_SOME_OBJECT = INTERFACE_A<SOME_OBJECT>  // MAKES { property: SOME_OBJECT }

这是结果：

const aNumber: A_NUMBER = {
    property: 111  // THIS EXPECTS A NUMBER
}

const anObject: A_SOME_OBJECT = {
    property: {   // THIS EXPECTS SOME_OBJECT
        foo: "bar"
    }
}

Typescript playground

---

扩展 Qwerty's 修改实用程序类型解决方案以将 R 的键限制为 T 中的键，并添加 IntelliSense

export type Modify<T, R extends Partial<Record<keyof T, any>>> = Omit<T, keyof R> & R;

---