Partial<Type>

构造类型Type,并将它所有的属性设置为可选的。它的返回类型示意输出类型的所有子类型。

例子

interface Todo {    title: string;    description: string;}function updateTodo(todo: Todo, fieldsToUpdate: Partial<Todo>) {    return { ...todo, ...fieldsToUpdate };}const todo1 = {    title: 'organize desk',    description: 'clear clutter',};const todo2 = updateTodo(todo1, {    description: 'throw out trash',});

Readonly<Type>

构造类型Type,并将它所有的属性设置为readonly,也就是说结构出的类型的属性不能被再次赋值。

例子

interface Todo {    title: string;}const todo: Readonly<Todo> = {    title: 'Delete inactive users',};todo.title = 'Hello'; // Error: cannot reassign a readonly property

这个工具可用来示意在运行时会失败的赋值表达式(比方,当尝试给解冻对象的属性再次赋值时)。

Object.freeze

function freeze<T>(obj: T): Readonly<T>;

Record<Keys, Type>

结构一个类型,其属性名的类型为K,属性值的类型为T。这个工具可用来将某个类型的属性映射到另一个类型上。

例子

interface PageInfo {    title: string;}type Page = 'home' | 'about' | 'contact';const x: Record<Page, PageInfo> = {    about: { title: 'about' },    contact: { title: 'contact' },    home: { title: 'home' },};

Pick<Type, Keys>

从类型Type中筛选局部属性Keys来构造类型。

例子

interface Todo {    title: string;    description: string;    completed: boolean;}type TodoPreview = Pick<Todo, 'title' | 'completed'>;const todo: TodoPreview = {    title: 'Clean room',    completed: false,};

Omit<Type, Keys>

从类型Type中获取所有属性,而后从中剔除Keys属性后结构一个类型。

例子

interface Todo {    title: string;    description: string;    completed: boolean;}type TodoPreview = Omit<Todo, 'description'>;const todo: TodoPreview = {    title: 'Clean room',    completed: false,};

Exclude<Type, ExcludedUnion>

从类型Type中剔除所有能够赋值给ExcludedUnion的属性,而后结构一个类型。

例子

type T0 = Exclude<'a' | 'b' | 'c', 'a'>; // "b" | "c"type T1 = Exclude<'a' | 'b' | 'c', 'a' | 'b'>; // "c"type T2 = Exclude<string | number | (() => void), Function>; // string | number

Extract<Type, Union>

从类型Type中提取所有能够赋值给Union的类型,而后结构一个类型。

例子

type T0 = Extract<'a' | 'b' | 'c', 'a' | 'f'>; // "a"type T1 = Extract<string | number | (() => void), Function>; // () => void

NonNullable<Type>

从类型Type中剔除nullundefined,而后结构一个类型。

例子

type T0 = NonNullable<string | number | undefined>; // string | numbertype T1 = NonNullable<string[] | null | undefined>; // string[]

Parameters<Type>

由函数类型Type的参数类型来构建出一个元组类型。

例子

declare function f1(arg: { a: number; b: string }): void;type T0 = Parameters<() => string>;//    []type T1 = Parameters<(s: string) => void>;//    [s: string]type T2 = Parameters<<T>(arg: T) => T>;//    [arg: unknown]type T3 = Parameters<typeof f1>;//    [arg: { a: number; b: string; }]type T4 = Parameters<any>;//    unknown[]type T5 = Parameters<never>;//    nevertype T6 = Parameters<string>;//   never//   Type 'string' does not satisfy the constraint '(...args: any) => any'.type T7 = Parameters<Function>;//   never//   Type 'Function' does not satisfy the constraint '(...args: any) => any'.

ConstructorParameters<Type>

由构造函数类型来构建出一个元组类型或数组类型。
由构造函数类型Type的参数类型来构建出一个元组类型。(若Type不是构造函数类型,则返回never)。

例子

type T0 = ConstructorParameters<ErrorConstructor>;//    [message?: string | undefined]type T1 = ConstructorParameters<FunctionConstructor>;//    string[]type T2 = ConstructorParameters<RegExpConstructor>;//    [pattern: string | RegExp, flags?: string | undefined]type T3 = ConstructorParameters<any>;//   unknown[]type T4 = ConstructorParameters<Function>;//    never// Type 'Function' does not satisfy the constraint 'new (...args: any) => any'.

ReturnType<Type>

由函数类型Type的返回值类型构建一个新类型。

例子

type T0 = ReturnType<() => string>;  // stringtype T1 = ReturnType<(s: string) => void>;  // voidtype T2 = ReturnType<(<T>() => T)>;  // {}type T3 = ReturnType<(<T extends U, U extends number[]>() => T)>;  // number[]type T4 = ReturnType<typeof f1>;  // { a: number, b: string }type T5 = ReturnType<any>;  // anytype T6 = ReturnType<never>;  // anytype T7 = ReturnType<string>;  // Errortype T8 = ReturnType<Function>;  // Error

InstanceType<Type>

由构造函数类型Type的实例类型来构建一个新类型。

例子

class C {    x = 0;    y = 0;}type T0 = InstanceType<typeof C>; // Ctype T1 = InstanceType<any>; // anytype T2 = InstanceType<never>; // anytype T3 = InstanceType<string>; // Errortype T4 = InstanceType<Function>; // Error

Required<Type>

构建一个类型,使类型Type的所有属性为required
与此相反的是Partial

例子

interface Props {    a?: number;    b?: string;}const obj: Props = { a: 5 }; // OKconst obj2: Required<Props> = { a: 5 }; // Error: property 'b' missing

ThisParameterType<Type>

从函数类型中提取 this 参数的类型。
若函数类型不蕴含 this 参数,则返回 unknown 类型。

例子

function toHex(this: Number) {    return this.toString(16);}function numberToString(n: ThisParameterType<typeof toHex>) {    return toHex.apply(n);}

OmitThisParameter<Type>

Type类型中剔除 this 参数。
若未声明 this 参数,则后果类型为 Type
否则,由Type类型来构建一个不带this参数的类型。
泛型会被疏忽,并且只有最初的重载签名会被采纳。

例子

function toHex(this: Number) {    return this.toString(16);}const fiveToHex: OmitThisParameter<typeof toHex> = toHex.bind(5);console.log(fiveToHex());

ThisType<Type>

这个工具不会返回一个转换后的类型。
它作为上下文的this类型的一个标记。
留神,若想应用此类型,必须启用--noImplicitThis

例子

// Compile with --noImplicitThistype ObjectDescriptor<D, M> = {    data?: D;    methods?: M & ThisType<D & M>; // Type of 'this' in methods is D & M};function makeObject<D, M>(desc: ObjectDescriptor<D, M>): D & M {    let data: object = desc.data || {};    let methods: object = desc.methods || {};    return { ...data, ...methods } as D & M;}let obj = makeObject({    data: { x: 0, y: 0 },    methods: {        moveBy(dx: number, dy: number) {            this.x += dx; // Strongly typed this            this.y += dy; // Strongly typed this        },    },});obj.x = 10;obj.y = 20;obj.moveBy(5, 5);

下面例子中,makeObject参数里的methods对象具备一个上下文类型ThisType<D & M>,因而methods对象的办法里this的类型为{ x: number, y: number } & { moveBy(dx: number, dy: number): number }

lib.d.ts里,ThisType<T>标识接口是个简略的空接口申明。除了在被辨认为对象字面量的上下文类型之外,这个接口与个别的空接口没有什么不同。