iT邦幫忙

2024 iThome 鐵人賽

DAY 27
0
JavaScript

用 TypeScript 重新定義前端開發:30 天的實踐與思考系列 第 27

Day27:使用 TypeScript 進行編譯階段錯誤檢查

  • 分享至 

  • xImage
  •  

TypeScript 則是一種靜態型別語言,通過在編譯階段進行型別檢查來提前捕捉在運行時可能會遇到意外的錯誤。這可以幫助我們避免許多潛在的 bug,使得程式碼更加穩定與可維護。

一、什麼是編譯階段錯誤?

在 JavaScript 中,錯誤通常是在程式執行時才會出現,這些錯誤稱為「運行時錯誤」。而 TypeScript 會在程式碼還沒有執行之前,也就是在編譯階段,進行型別檢查和錯誤報告,這被稱為「編譯階段錯誤」。這樣可以讓我們在開發過程中盡早發現問題,並減少運行時錯誤的機會。以下是常見的編譯錯誤情形:

1. 變數型別不符

假設我們有一個簡單的變數定義:

let age: number = 18;

如果之後嘗試將 age 賦值為一個字串:

age = "eighteen"; // 錯誤:Type 'string' is not assignable to type 'number'.

TypeScript 會立即報錯,因為 age 被定義為 number 型別,而我們卻嘗試將一個 string 賦值給它。這就是一個典型的編譯階段錯誤。

2. 函數參數型別不符

另一個常見的情況是函數參數的型別檢查:

function greet(name: string) {
  console.log(`Hello, ${name}`);
}

greet("Annie");  // 正確
greet(123);      // 錯誤:Argument of type 'number' is not assignable to parameter of type 'string'.

在這裡,greet 函數只接受 string 型別的參數,因此當我傳入 123(一個 number 或非 string 型別)時,TypeScript 會在編譯階段報錯,幫助及時發現問題。

二、如何啟用編譯階段錯誤檢查?

TypeScript 的編譯階段錯誤檢查功能是內建的,只要你使用 TypeScript 進行開發,就會自動啟用這個功能。但其實也可以進一步強化檢查,讓 TypeScript 更加嚴格。

1. 啟用 strict 模式

tsconfig.json 是 TypeScript 的配置檔案,我們可以在其中啟用更嚴格的型別檢查。在專案中創建 tsconfig.json,並加入以下設定:

{
  "compilerOptions": {
    "strict": true
  }
}

strict 模式會開啟 TypeScript 中的所有嚴格檢查規則,讓型別錯誤更加明顯。這包含了 strictNullChecksstrictFunctionTypesstrictPropertyInitialization 等等檢查。

2. 編譯錯誤示範

假設我們有一個簡單的程式:

let message: string;

console.log(message); // 錯誤:Variable 'message' is used before being assigned.

由於 strict 模式下,TypeScript 會檢查變數是否已經初始化,因此這段程式碼會在編譯階段報錯,原因是 message 還沒被賦值。

三、錯誤處理機制

TypeScript 不僅僅是檢查型別是否正確,還會檢查程式邏輯中潛在的錯誤。例如,當我們處理 nullundefined 時,TypeScript 可以幫助我們避免常見的錯誤。

1. Null 和 Undefined 檢查

在 JavaScript 中,nullundefined 是常見的錯誤來源。如果沒有適當處理這些值,可能會導致程式崩潰。

function printName(name: string | null) {
  console.log(name.toUpperCase()); // 錯誤:Object is possibly 'null'.
}

在這裡,name 參數可能是 null,但因為目前沒有處理這種情況,因此 TypeScript 在編譯階段就會提醒我們這個潛在問題。解決方法是加入一個檢查:

function printName(name: string | null) {
  if (name !== null) {
    console.log(name.toUpperCase());
  }
}

現在 TypeScript 就不會報錯了!因為我們已經確保 name 在被使用之前不是 null

2. 斷言(Assertion)

有時候我們知道某個值在某些情況下肯定不會是 nullundefined,這時我們可以使用 TypeScript 的非空斷言操作符(!)來告訴編譯器「放心,這個值一定不會是 nullundefined」。

function printName(name: string | null) {
  console.log(name!.toUpperCase()); // 我們確信 name 不會是 null
}

這樣,TypeScript 就不會再進行 null 檢查,但需要謹慎使用這個特性,因為一旦斷言錯誤,可能會導致運行時錯誤

四、編譯階段錯誤的好處

TypeScript 的編譯階段錯誤檢查提供了許多好處:

  • 提早發現問題:在程式執行之前就能捕捉到型別錯誤,減少了在運行時才發現 bug 的風險。
  • 提高代碼品質:強制進行型別檢查,讓程式碼更嚴謹、可靠。
  • 改善開發體驗:TypeScript 的型別檢查可以提升編輯器的自動補全功能,幫助開發者快速發現錯誤。

五、範例總結

以下是完整的範例,展示了 TypeScript 在編譯階段檢查不同型別錯誤的過程:

// 定義一個變數並賦值
let age: number = 18;

// 變數賦值錯誤
age = "eighteen"; // 錯誤:Type 'string' is not assignable to type 'number'.

// 函數參數型別檢查
function greet(name: string) {
  console.log(`Hello, ${name}`);
}

greet("Annie");  // 正確
greet(123);      // 錯誤:Argument of type 'number' is not assignable to parameter of type 'string'.

// 處理 Null 和 Undefined
function printName(name: string | null) {
  if (name !== null) {
    console.log(name.toUpperCase());
  } else {
    console.log("Name is null");
  }
}

printName("Annie"); // 輸出:ANNIE
printName(null);  // 輸出:Name is null

上一篇
Day26:使用 TypeScript 處理第三方庫中的型別定義
下一篇
Day28:TypeScript 的實用工具與插件
系列文
用 TypeScript 重新定義前端開發:30 天的實踐與思考30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言