flow中文文档（六）

类型别名

当您有要在多个位置重用的复杂类型时，可以使用类型别名在Flow中对它们进行别名

// @flow
type MyObject = {
  foo: number,
  bar: boolean,
  baz: string,
};

这些类型的别名可以在任何可以使用类型的地方使用。

// @flow
type MyObject = {
  // ...
};

var val: MyObject = { /* ... */ };
function method(val: MyObject) { /* ... */ }
class Foo { constructor(val: MyObject) { /* ... */ } }

类型别名语法

使用关键字type后跟其名称，等号=和类型定义来创建类型别名。

type Alias = Type;

任何类型都可以出现在类型别名中

type NumberAlias = number;
type ObjectAlias = {
  property: string,
  method(): number,
};
type UnionAlias = 1 | 2 | 3;
type AliasAlias = ObjectAlias;

类型别名泛型

类型别名也可以有自己的泛型。

type MyObject<A, B, C> = {
  property: A,
  method(val: B): C,
};

类型别名泛型已参数化。当您使用类型别名时，您需要为每个泛型传递参数。

// @flow
type MyObject<A, B, C> = {
  foo: A,
  bar: B,
  baz: C,
};

var val: MyObject<number, boolean, string> = {
  foo: 1,
  bar: true,
  baz: 'three',
};

不透明类型别名

不透明类型别名是类型别名，不允许在定义它们的文件之外访问其基础类型。

opaque type ID = string;

与常规类型别名一样，可以在任何可以使用类型的地方使用

// @flow
opaque type ID = string;

function identity(x: ID): ID {
  return x;
}
export type {ID};

不透明类型语法

您可以选择通过添加冒号来添加子类型约束到opaque类型别名：和名称后面的类型。

opaque type Alias: SuperType = Type;

任何类型都可以显示为不透明类型别名的超类型或类型。

opaque type StringAlias = string;
opaque type ObjectAlias = {
  property: string,
  method(): number,
};
opaque type UnionAlias = 1 | 2 | 3;
opaque type AliasAlias: ObjectAlias = ObjectAlias;
opaque type VeryOpaque: AliasAlias = ObjectAlias;

当在同一文件中定义别名时，opaque类型别名的行为与常规类型别名的行为完全相同。

//@flow
opaque type NumberAlias = number;

(0: NumberAlias);

function add(x: NumberAlias, y: NumberAlias): NumberAlias {
    return x + y;
}
function toNumberAlias(x: number): NumberAlias { return x; }
function toNumber(x: NumberAlias): number { return x; }

导入opaque类型别名时，它的行为类似于名义类型，隐藏其基础类型。

exports.js

export opaque type NumberAlias = number;

imports.js

import type {NumberAlias} from './exports';

(0: NumberAlias) // Error: 0 is not a NumberAlias!

function convert(x: NumberAlias): number {
  return x; // Error: x is not a number!
}

子类型约束

将子类型约束添加到opaque类型别名时，我们允许opaque类型在定义文件之外时用作超类型。

exports.js

export opaque type ID: string = string;

imports.js

import type {ID} from './exports';

function formatID(x: ID): string {
    return "ID: " + x; // Ok! IDs are strings.
}

function toID(x: string): ID {
    return x; // Error: strings are not IDs.
}

使用子类型约束创建opaque类型别名时，类型位置中的类型必须是超类型位置中类型的子类型。

//@flow
opaque type Bad: string = number; // Error: number is not a subtype of string
opaque type Good: {x: string} = {x: string, y: number};

泛型

不透明类型的别名也可以有自己的泛型，它们的工作方式与普通类型别名中的泛型一样

// @flow
opaque type MyObject<A, B, C>: { foo: A, bar: B } = {
  foo: A,
  bar: B,
  baz: C,
};

var val: MyObject<number, boolean, string> = {
  foo: 1,
  bar: true,
  baz: 'three',
};

Library Definitions

您还可以在libdefs中声明opaque类型别名。在那里，您省略了基础类型，但仍可选择包含超类型

declare opaque type Foo;
declare opaque type PositiveNumber: number;