Flow對象類型(Object Types)

對象類型(Object Types)

對象類型語法

對象類型嘗試盡可能多地匹配JavaScript中的對象的語法。使用形式是:{鍵: 值}秒梅。

// @flow
var obj1: { foo: boolean } = { foo: true };
var obj2: {
  foo: number,
  bar: boolean,
  baz: string,
} = {
  foo: 1,
  bar: true,
  baz: 'three',
};

對象類型可選屬性

在JavaScript中咸这,訪問不存在的屬性評估為undefined焰枢。這是JavaScript程序中常見的錯誤來源王财,所以Flow會將這些錯誤轉(zhuǎn)化為類型錯誤忆矛。

// @flow
var obj = { foo: "bar" };
// $ExpectError
obj.bar; // Error!

添加一個可選屬性的方式是:{屬性名稱?: 類型}察蹲。

// @flow
var obj: { foo?: boolean } = {};

obj.foo = true;    // Works!
// $ExpectError
obj.foo = 'hello'; // Error!

可選屬性值可以是void或省略,但是不能是null

// @flow
function acceptsObject(value: { foo?: string }) {
  // ...
}

acceptsObject({ foo: "bar" });     // Works!
acceptsObject({ foo: undefined }); // Works!
// $ExpectError
acceptsObject({ foo: null });      // Error!
acceptsObject({});                 // Works!

對象類型推導(dǎo)

Flow有兩種不同的方式推導(dǎo)出對象字面量的類型。

密封的對象(Sealed objects)

在Flow中創(chuàng)建一個密封的對象類型的方法是創(chuàng)建一個帶有屬性的對象递览。密封的對象知道你聲明的所有屬性及其值的類型叼屠。

// @flow
var obj = {
  foo: 1,
  bar: true,
  baz: 'three'
};

var foo: number  = obj.foo; // Works!
var bar: boolean = obj.bar; // Works!
// $ExpectError
var baz: null    = obj.baz; // Error!
var bat: string  = obj.bat; // Error!

Flow不允許你為密封對象添加新的屬性。

// @flow
var obj = {
  foo: 1
};

// $ExpectError
obj.bar = true;    // Error!
// $ExpectError
obj.baz = 'three'; // Error!

未密封的對象(Unsealed objects)

在Flow中創(chuàng)建一個未密封的對象類型的方法是創(chuàng)建一個帶沒有屬性的對象绞铃。未密封的對象不知道你聲明的所有屬性及其值的類型镜雨。

// @flow
var obj = {};

obj.foo = 1;       // Works!
obj.bar = true;    // Works!
obj.baz = 'three'; // Works!

未密封的對象允許你設(shè)置屬性。

// @flow
var obj = {};
obj.foo = 42;
var num: number = obj.foo;

為未密封對象屬性重新賦值

varlet變量相似儿捧,你可以改變未密封的對象的屬性值荚坞。Flow會為你設(shè)置可能的類型。

// @flow
var obj = {};

if (Math.random()) obj.prop = true;
else obj.prop = "hello";

// $ExpectError
var val1: boolean = obj.prop; // Error!
// $ExpectError
var val2: string  = obj.prop; // Error!
var val3: boolean | string = obj.prop; // Works!

當(dāng)Flow可以確定重新分配后的屬性類型時菲盾,F(xiàn)low會為其分配確定的類型颓影。

// @flow
var obj = {};

obj.prop = true;
obj.prop = "hello";

// $ExpectError
var val1: boolean = obj.prop; // Error!
var val2: string  = obj.prop; // Works!

未密封對象上的未知屬性查找是不安全的

未密封的對象允許隨時寫入新的屬性。Flow確保讀取與寫入兼容懒鉴,但不能確保寫入發(fā)生在讀取之前(按執(zhí)行順序)诡挂。

這意味著從未被封裝的對象中讀取沒有匹配的寫入從不被檢查。這是Flow的不安全行為临谱,未來可能會有所改進(jìn)璃俗。

var obj = {};

obj.foo = 1;
obj.bar = true;

var foo: number  = obj.foo; // Works!
var bar: boolean = obj.bar; // Works!
var baz: string  = obj.baz; // Works?

確切的對象類型

在Flow中,在預(yù)期正常對象類型的情況下傳遞具有額外屬性的對象是安全的悉默。

// @flow
function method(obj: { foo: string }) {
  // ...
}

method({
  foo: "test", // Works!
  bar: 42      // Works!
});

這是一種通常被稱為“寬度子類型”的子類型城豁,因為“更寬”(即具有更多屬性)的類型是更窄類型的子類型。

有時候阻止這種行為并且只允許一組特定的屬性是必要的抄课。為此唱星,F(xiàn)low有了以下的做法:

{| foo: string, bar: number |}

與常規(guī)對象類型不同,將具有“額外”屬性的對象傳遞給確切的對象類型是無效的跟磨。

// @flow
var foo: {| foo: string |} = { foo: "Hello", bar: "World!" }; // Error!

映射類(Map類)

JavaScript新標(biāo)準(zhǔn)增加了Map類间聊。在種情況下,一個對象可能會添加一些屬性抵拘,并在整個生命周期中被檢索甸饱。而且,屬性鍵甚至可能不被靜態(tài)檢查仑濒,所以寫出類型注釋是不可能的。對于像這樣的對象偷遗,F(xiàn)low提供了一種稱為“索引器屬性”的特殊屬性墩瞳。索引器屬性允許使用與索引器鍵類型匹配的任何鍵進(jìn)行讀取和寫入。

// @flow
var o: { [string]: number } = {};
o["foo"] = 0;
o["bar"] = 1;
var foo: number = o["foo"];

索引器可以被任意命名:

// @flow
var obj: { [user_id: number]: string } = {};
obj[1] = "Julia";
obj[2] = "Camille";
obj[3] = "Justin";
obj[4] = "Mark";

當(dāng)對象類型具有索引器屬性時氏豌,即使對象在運行時某個期間沒有值喉酌,屬性訪問也被假定為具有注釋類型。

var obj: { [number]: string } = {};
obj[42].length; // No type error, but will throw at runtime

索引器屬性可以與命名屬性混合使用:

// @flow
var obj: {
  size: number,
  [id: number]: string
} = {
  size: 0
};

function add(id: number, name: string) {
  obj[id] = name;
  obj.size++;
}
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市泪电,隨后出現(xiàn)的幾起案子般妙,更是在濱河造成了極大的恐慌,老刑警劉巖相速,帶你破解...
    沈念sama閱讀 221,695評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件碟渺,死亡現(xiàn)場離奇詭異,居然都是意外死亡突诬,警方通過查閱死者的電腦和手機苫拍,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,569評論 3 399
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來旺隙,“玉大人绒极,你說我怎么就攤上這事∈呓荩” “怎么了垄提?”我有些...
    開封第一講書人閱讀 168,130評論 0 360
  • 文/不壞的土叔 我叫張陵,是天一觀的道長周拐。 經(jīng)常有香客問我铡俐,道長,這世上最難降的妖魔是什么速妖? 我笑而不...
    開封第一講書人閱讀 59,648評論 1 297
  • 正文 為了忘掉前任高蜂,我火速辦了婚禮,結(jié)果婚禮上罕容,老公的妹妹穿的比我還像新娘备恤。我一直安慰自己,他們只是感情好锦秒,可當(dāng)我...
    茶點故事閱讀 68,655評論 6 397
  • 文/花漫 我一把揭開白布露泊。 她就那樣靜靜地躺著,像睡著了一般旅择。 火紅的嫁衣襯著肌膚如雪惭笑。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,268評論 1 309
  • 那天生真,我揣著相機與錄音沉噩,去河邊找鬼。 笑死柱蟀,一個胖子當(dāng)著我的面吹牛川蒙,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播长已,決...
    沈念sama閱讀 40,835評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼畜眨,長吁一口氣:“原來是場噩夢啊……” “哼昼牛!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起康聂,我...
    開封第一講書人閱讀 39,740評論 0 276
  • 序言:老撾萬榮一對情侶失蹤贰健,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后恬汁,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體伶椿,經(jīng)...
    沈念sama閱讀 46,286評論 1 318
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,375評論 3 340
  • 正文 我和宋清朗相戀三年蕊连,在試婚紗的時候發(fā)現(xiàn)自己被綠了悬垃。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,505評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡甘苍,死狀恐怖尝蠕,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情载庭,我是刑警寧澤看彼,帶...
    沈念sama閱讀 36,185評論 5 350
  • 正文 年R本政府宣布,位于F島的核電站囚聚,受9級特大地震影響靖榕,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜顽铸,卻給世界環(huán)境...
    茶點故事閱讀 41,873評論 3 333
  • 文/蒙蒙 一茁计、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧谓松,春花似錦星压、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,357評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至优质,卻和暖如春竣贪,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背巩螃。 一陣腳步聲響...
    開封第一講書人閱讀 33,466評論 1 272
  • 我被黑心中介騙來泰國打工演怎, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人避乏。 一個月前我還...
    沈念sama閱讀 48,921評論 3 376
  • 正文 我出身青樓爷耀,卻偏偏與公主長得像,于是被迫代替她去往敵國和親淑际。 傳聞我的和親對象是個殘疾皇子畏纲,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,515評論 2 359

推薦閱讀更多精彩內(nèi)容