Feat translate zh

[17biu (17biubiu)]

translate Utility Types to chinese

[Deleted user (ghost)]

All CLA requirements met.

[github-actions]

Thanks for the PR!

This section of the codebase is owned by Wenlu Wang (@Kingwl) - if they write a comment saying "LGTM" then it will be merged.

[github-actions]

Translation of Utility Types.md

---

title: Tool type
layout: docs
permalink: /zh/docs/handbook/utility-types.html
oneline: A type that is globally included in TypeScript

translatable: true

TypeScript provides several common types of tools that facilitate type conversion. These tool types are available globally.

Awaited<Type>

Release Version:
4.5

This type is intended to be simulated async function await or something like thatPromise on.then() Methods - Specifically, they are recursive
unfoldPromise

Example

typeA=Awaited<Promise<string>>;// ^?typeB=Awaited<Promise<Promise<number>>>;// ^?typeC=Awaited<boolean|Promise<number>>;// ^?

Partial<Type>

Release Version:
2.1

Construct a will Type All properties are set to the type of option. This tool type returns a type that represents all subsets of a given type.

Example

interfaceTodo{title: string;description: string;}functionupdateTodo(todo: Todo,fieldsToUpdate: Partial<Todo>){return{ ...todo, ...fieldsToUpdate};}consttodo1={title: "organize desk",description: "clear clutter",};consttodo2=updateTodo(todo1,{description: "throw out trash",});

Required<Type>

Release Version:
2.8

Construct a will Type All properties are set to the type of rare. It is[Partial]The reverse operation of (#partialtype).

Example

// @errors: 2741interfaceProps{a?: number;b?: string;}constobj: Props={a: 5};constobj2: Required<Props>={a: 5};

Readonly<Type>

Release Version:
2.1

Construct a will Type All properties are set to readonlyof the constructed type, which means that these properties cannot be reassigned to the constructed type.

Example

// @errors: 2540interfaceTodo{title: string;}consttodo: Readonly<Todo>={title: "Delete inactive users",};todo.title="Hello";

This utility is useful for representing assignment expressions that will fail at runtime (i.e. when attempting to reassign properties of a frozen object).

This tool is useful for expressions that indicate assignment expressions that will fail at run time (that is, when an attempt is made to reassign [frozen object] When the property of the (https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze)）

Object.freeze

functionfreeze<Type>(obj: Type): Readonly<Type>;

Record<Keys, Type>

Release Version:
2.1

Constructs an object type with a property key of Keys and a property value of Type. This tool can be used to map attributes of one type to another.

Example

interfaceCatInfo{age: number;breed: string;}typeCatName="miffy"|"boris"|"mordred";constcats: Record<CatName,CatInfo>={miffy: {age: 10,breed: "Persian"},boris: {age: 5,breed: "Maine Coon"},mordred: {age: 16,breed: "British Shorthair"},};cats.boris;// ^?

Pick<Type, Keys>

Release Version:
2.1

By from Type Select a set of properties Keys(string literal or a union of string literals) to construct a type.

Example

interfaceTodo{title: string;description: string;completed: boolean;}typeTodoPreview=Pick<Todo,"title"|"completed">;consttodo: TodoPreview={title: "Clean room",completed: false,};todo;// ^?

Omit<Type, Keys>

Release Version:
3.5

By from Type Select all properties and delete them Keys(string literals or a union of string literals) to construct the type.

Example

interfaceTodo{title: string;description: string;completed: boolean;createdAt: number;}typeTodoPreview=Omit<Todo,"description">;consttodo: TodoPreview={title: "Clean room",completed: false,createdAt: 1615544252770,};todo;// ^?typeTodoInfo=Omit<Todo,"completed"|"createdAt">;consttodoInfo: TodoInfo={title: "Pick up kids",description: "Kindergarten closes at 5pm",};todoInfo;// ^?

Exclude<UnionType, ExcludedMembers>

Release Version:
2.8

Construct a type by excluding from unionType all union members that can be assigned to ExcludedMembers.

Example

typeT0=Exclude<"a"|"b"|"c","a">;// ^?typeT1=Exclude<"a"|"b"|"c","a"|"b">;// ^?typeT2=Exclude<string|number|(()=>void),Function>;// ^?

Extract<Type, Union>

Release Version:
2.8

By from Type Extract all that can be assigned to Union A union member to construct a type.

Example

typeT0=Extract<"a"|"b"|"c","a"|"f">;// ^?typeT1=Extract<string|number|(()=>void),Function>;// ^?

NonNullable<Type>

Release Version:
2.8

By from Type Exclude null and undefined to construct a type.

Example

typeT0=NonNullable<string|number|undefined>;// ^?typeT1=NonNullable<string[]|null|undefined>;// ^?

Parameters<Type>

Release Version:
3.1

From the function type Type The tuple type is constructed using the type.

Example

// @errors: 2344declarefunctionf1(arg: {a: number;b: string}): void;typeT0=Parameters<()=>string>;// ^?typeT1=Parameters<(s: string)=>void>;// ^?typeT2=Parameters<<T>(arg: T)=>T>;// ^?typeT3=Parameters<typeoff1>;// ^?typeT4=Parameters<any>;// ^?typeT5=Parameters<never>;// ^?typeT6=Parameters<string>;// ^?typeT7=Parameters<Function>;// ^?

ConstructorParameters<Type>

Release Version:
3.1

Constructs a tuple or array type from the type of the constructor type. It generates a tuple type that contains all parameter types (if so Type If it is not a function, the type is generated never）。

Example

// @errors: 2344// @strict: falsetypeT0=ConstructorParameters<ErrorConstructor>;// ^?typeT1=ConstructorParameters<FunctionConstructor>;// ^?typeT2=ConstructorParameters<RegExpConstructor>;// ^?typeT3=ConstructorParameters<any>;// ^?typeT4=ConstructorParameters<Function>;// ^?

ReturnType<Type>

Release Version:
2.8

Construct a function by Type The type of type that is returned consists of.

Example

// @errors: 2344 2344declarefunctionf1(): {a: number;b: string};typeT0=ReturnType<()=>string>;// ^?typeT1=ReturnType<(s: string)=>void>;// ^?typeT2=ReturnType<<T>()=>T>;// ^?typeT3=ReturnType<<TextendsU,Uextendsnumber[]>()=>T>;// ^?typeT4=ReturnType<typeoff1>;// ^?typeT5=ReturnType<any>;// ^?typeT6=ReturnType<never>;// ^?typeT7=ReturnType<string>;// ^?typeT8=ReturnType<Function>;// ^?

InstanceType<Type>

Release Version:
2.8

Constructs a type that is used by Type The constructor consists of instance types in the constructor.

Example

// @errors: 2344 2344// @strict: falseclassC{x=0;y=0;}typeT0=InstanceType<typeofC>;// ^?typeT1=InstanceType<any>;// ^?typeT2=InstanceType<never>;// ^?typeT3=InstanceType<string>;// ^?typeT4=InstanceType<Function>;// ^?

ThisParameterType<Type>

Release Version:
3.3

If the function type is not this parameters, then extract the function type this Parameter or [unknown](/docs/handbook/release-notes/typescript-3-0.html# new-unknown-top-type) type.

Example

functiontoHex(this: Number){returnthis.toString(16);}functionnumberToString(n: ThisParameterType<typeoftoHex>){returntoHex.apply(n);}

OmitThisParameter<Type>

Release Version:
3.3

from Type delete this Parameter. If Type There is no explicit statement this parameters, then the result is only Type。 Otherwise, from Type Create one that does not this The new function type of the parameter. After the generic is removed, only the last overloaded signature is passed to the new function type.

Example

functiontoHex(this: Number){returnthis.toString(16);}constfiveToHex: OmitThisParameter<typeoftoHex>=toHex.bind(5);console.log(fiveToHex());

ThisType<Type>

Release Version:
2.3

This tool does not return the converted type. Instead, it is used as a context this The type of tag. Note that it must be enabled noImplicitThis flags are required to use this tool.

Example

// @noImplicitThis: falsetypeObjectDescriptor<D,M>={data?: D;methods?: M&ThisType<D&M>;// Type of 'this' in methods is D & M};functionmakeObject<D,M>(desc: ObjectDescriptor<D,M>): D&M{letdata: object=desc.data||{};letmethods: object=desc.methods||{};return{ ...data, ...methods}asD&M;}letobj=makeObject({data: {x: 0,y: 0},methods: {moveBy(dx: number,dy: number){this.x+=dx;// Strongly typed thisthis.y+=dy;// Strongly typed this},},});obj.x=10;obj.y=20;obj.moveBy(5,5);

In the example above,makeObject parameter methods The object has a containment ThisType<D & M> The context type, therefore this at methods Method is { x: number, y: number } & { moveBy(dx: number, dy: number): number }consortium. note methods How the type of the property becomes in a method this The type of inference target and source.

ThisType<T> Tag the interface just inlib.d.ts An empty interface declared in . Except for being recognized in the context type of the object literal, the interface behaves like any empty interface.

Intrinsic String Manipulation Types

Uppercase<StringType>

Lowercase<StringType>

Capitalize<StringType>

Uncapitalize<StringType>

TypeScript contains a set of types that can be used for string-type operations within the system to facilitate operations using template strings. You can Template Literal Types Find these in the documentation.

Generated by 🚫 dangerJS against 5d19278

[Xavi Lee (awxiaoxian2020)]

squash two commits seems good.