型別扮演表達式 ( Type Casting Expressions )

常常我們在做型別確認的時候，會要寫一個 function 或是宣告變數來確認
// @flow
function fn(num: number) {
    // ...
}
​
fn(123);
fn('123'); // 錯誤!
​
// 或是
const num: number = 123;
const num2: string = 123; // 錯誤!
用久了確實是有點麻煩。這還只是基礎型別呢！如果哪天要使用自定義的型別那真是惡夢阿~
我們的痛苦 Flow 是知道的， Flow 支援 型別扮演表達式 ( Type Casting Expressions ) 來解決這個問題。
語法
Type Casting Expression 的語法是在小括號內 ( )  使用 value加上冒號 : 在接上 Type 完成一個表達式。
(value: Type)
小括號是必要的哦！避免跟其他表達式混淆。
它可以應用在各種場景：
// 這裡只是表達式的範例
// 實際寫上去是會報錯的哦~ 因為我們並沒有 Type, value, prop 等變數的定義
let val = (value: Type);
let obj = { prop: (value: Type) };
let arr = ([(value: Type), (value: Type)]: Array<Type>);
在表達式中，還可以放入其他邏輯表達式。
(2 + 2: number)
當我們用 babel 編譯過後，它只會留下 value 的部分而已。
// @flow
(value: Type)
value
( 這段雖然 IDE 會報錯，但是 babel 還是可以轉的哦，自己試試看吧！  )
型別扮演 & 型別轉換
其實這個 Type Casting Expressions 的中文名我也想了很久，到底是要用型別扮演，還是轉換會比較好 ( 開始後悔年輕沒有好好上體育老師的國文課了... )
因為以下的語法是通的哦
// @flow
let value = 42;
​
(value: 42); // ok!
(value: number); // ok!
(value: 43); // 錯誤!
第 4 行我們問他說，value 可不可以是 42 他說可以。
第 5 行我們問他說，value 可不可以是 number 他也說可以。
第 6 行我們問他說，value 可不可以是 43 他說不行。
所以我的解讀是，它作為扮演來解釋會比較精準一點。
回傳值
當我們使用 Type Casting Expression 回傳時，在 Flow 中它會回傳它的型態，什麼意思呢？
看下面的範例吧
let value = 42;
​
(value: 42); // ok
(value: number); // ok
​
let newValue = (value: number);
​
(newValue: 42); // 錯誤!
(newValue: number); // ok
以我們直覺上來說，newValue 等於 value，所以當我們問它 (newValue: 42) 的時候應該要說"是"才對 ( 實際上他也是 42 沒錯 )，但是 Flow 硬生生的就給它報錯了。
為什麼呢？因為在 Flow 中 Type Casting Expression 的回傳的型別資訊是冒號後面的型別，而不是值得型別 ( 儘管實際上在 JavaScript 當中是值 )，所以在範例中，他只知道 newValue 是 number 而不知道它是 42。
透過 any 轉換型別
在剛才的演示中，我們有發現 Type Casting 這個動作只能在扮演相同的型別，是不可以扮演成不同的型別的。
但是有一個型別它可以扮演所有型別，那就是 any，在很多情況下我們會避免使用 any，畢竟使用了 any，就等於失去了型別判斷的意義，容易造成無法預期的錯誤。
不好的使用場景
一樣拿官方的範例來做為演示
let value = 42;
​
(value: number);// ok
(value: string); // 錯誤
​
let newValue = ((value: any) string);
​
(newValue: number); // 錯誤
(newValue: string); // ok
在一開始，我們問說 (value: string) 的時候 Flow 跟我們說不可以，他不是 string
後來我們先問說 (value: any)，Flow 說可以，他是 any，現在 Flow 已經把 (value: any) 當成 any 來看待了，
我們後面又接著問 ((value: any): string) ，Flow 說可以，any 可以是 string。
因此我們在最後兩行 (newValue: number) 的時候錯了，反倒是 (newValue: string) 的時候正確。可是實際上的 newValue 值卻是數字 42，而非字串。
當然，這樣的轉換型別是不建議的，用得不好就像上例這樣，Flow 都被自己搞到給出錯誤的提示，但是如果 any 型別使用得當，在某些真的需要使用型別轉換的場景則又顯得格外的實用。
好的使用場景
官方給了我們一個非常實用的用例。
用例場景是當我們要 clone 物件的時候，我們可能會先寫出像這樣的一段
// @flow
function cloneObject(obj) {
    const clone = {};
    
    Object.keys(obj).forEach((key) => {
        clone[key] = obj[key]
    })
    
    return clone;
}
​
// --- 測試 ---
​
type Person = {
    name: string,
    age: number,
};
​
const person001: Person = {
    name: 'Wayne',
    age: 26,
};
​
(cloneObject(person001): Object); // ok
(cloneObject(person001): Person); // 錯誤
這是很簡單的 clone 物件 function，他可以回傳一個 Object 型態，但是卻沒有辦法做到回傳收到的 Person 型態。
( Object 型態源自於 const clone = {}; 的預設型別 )
如果我們想要讓它能如預期回傳收到的 Person 型態就可以用到剛才的 any 型態了。
// @flow
function cloneObject(obj) {
    const clone = {};
    
    Object.keys(obj).forEach((key) => {
        clone[key] = obj[key]
    })
    
    return ((clone: any): typeof obj); // <<
}
​
// --- 測試 ---
​
type Person = {
    name: string,
    age: number,
};
​
const person001: Person = {
    name: 'Wayne',
    age: 26,
};
​
(cloneObject(person001): Object); // ok
(cloneObject(person001): Person); // ok
我們只有動到 return 那行，先將 clone 物件轉換為 any 型態，現在它可以扮演任何型別了，再用 typeof 取出 obj 的型別，將 clone 轉過去，就大功告成了！還不錯吧？
TODO: 剩下的晚點寫~

型別總覽 ( Type Annotations ) - Previous

Utility Types

Next - 型別總覽 ( Type Annotations )

模組化 ( Module Types )

Last modified 1yr ago

Copy link

On this page

語法

型別扮演 & 型別轉換

回傳值

透過 any 轉換型別

不好的使用場景

好的使用場景

TODO: 剩下的晚點寫~