|
|
<!--
|
|
|
CO_OP_TRANSLATOR_METADATA:
|
|
|
{
|
|
|
"original_hash": "4fa20c513e367e9cdd401bf49ae16e33",
|
|
|
"translation_date": "2025-08-26T00:42:12+00:00",
|
|
|
"source_file": "7-bank-project/4-state-management/README.md",
|
|
|
"language_code": "mo"
|
|
|
}
|
|
|
-->
|
|
|
# 建立銀行應用程式第4部分：狀態管理的概念
|
|
|
|
|
|
## 課前測驗
|
|
|
|
|
|
[課前測驗](https://ff-quizzes.netlify.app/web/quiz/47)
|
|
|
|
|
|
### 簡介
|
|
|
|
|
|
隨著網頁應用程式的規模增長，管理所有數據流變得越來越具有挑戰性。哪段程式碼獲取了數據？哪個頁面使用了它？它需要在何時何地更新？這些問題很容易導致程式碼變得混亂且難以維護。特別是當你需要在應用程式的不同頁面之間共享數據時，例如用戶數據。*狀態管理* 的概念一直存在於各類程式中，但隨著網頁應用程式的複雜性不斷增加，這已成為開發過程中的一個關鍵點。
|
|
|
|
|
|
在這最後一部分，我們將重新審視我們建立的應用程式，重新思考如何管理狀態，以支持在任何時候刷新瀏覽器，並在用戶會話之間持續保存數據。
|
|
|
|
|
|
### 先決條件
|
|
|
|
|
|
你需要完成網頁應用程式的[數據獲取](../3-data/README.md)部分。你還需要安裝 [Node.js](https://nodejs.org) 並在本地運行 [伺服器 API](../api/README.md)，以便管理帳戶數據。
|
|
|
|
|
|
你可以通過在終端執行以下命令來測試伺服器是否正常運行：
|
|
|
|
|
|
```sh
|
|
|
curl http://localhost:5000/api
|
|
|
# -> should return "Bank API v1.0.0" as a result
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 重新思考狀態管理
|
|
|
|
|
|
在[上一課](../3-data/README.md)中，我們在應用程式中引入了一個基本的狀態概念，即全域變數 `account`，它包含當前登錄用戶的銀行數據。然而，我們目前的實現存在一些缺陷。嘗試在儀表板頁面刷新瀏覽器。會發生什麼？
|
|
|
|
|
|
目前的程式碼有三個問題：
|
|
|
|
|
|
- 狀態未被持久化，刷新瀏覽器會將你帶回登錄頁面。
|
|
|
- 有多個函數修改狀態。隨著應用程式的增長，這可能使得跟蹤更改變得困難，並且很容易忘記更新某些部分。
|
|
|
- 狀態未被清理，因此當你點擊 *登出* 時，即使你已經在登錄頁面，帳戶數據仍然存在。
|
|
|
|
|
|
我們可以逐一更新程式碼來解決這些問題，但這會導致程式碼重複，並使應用程式變得更加複雜且難以維護。或者，我們可以花幾分鐘重新思考我們的策略。
|
|
|
|
|
|
> 我們真正想解決的問題是什麼？
|
|
|
|
|
|
[狀態管理](https://en.wikipedia.org/wiki/State_management) 的核心在於找到一個好的方法來解決以下兩個特定問題：
|
|
|
|
|
|
- 如何讓應用程式中的數據流變得易於理解？
|
|
|
- 如何確保狀態數據始終與用戶界面保持同步（反之亦然）？
|
|
|
|
|
|
一旦解決了這些問題，你可能面臨的其他問題要麼已經被解決，要麼變得更容易解決。有許多可能的方法來解決這些問題，但我們將採用一種常見的解決方案，即**集中化數據及其更改方式**。數據流將如下圖所示：
|
|
|
|
|
|
|
|
|
|
|
|
> 我們在這裡不會涵蓋數據自動觸發視圖更新的部分，因為這涉及到更高級的[反應式編程](https://en.wikipedia.org/wiki/Reactive_programming)概念。如果你有興趣深入研究，這是一個很好的後續主題。
|
|
|
|
|
|
✅ 現在有許多不同方法的狀態管理庫，[Redux](https://redux.js.org) 是一個流行的選擇。了解其使用的概念和模式通常是一個很好的方式，可以幫助你了解在大型網頁應用程式中可能面臨的問題以及如何解決它們。
|
|
|
|
|
|
### 任務
|
|
|
|
|
|
我們將從一些重構開始。替換 `account` 的聲明：
|
|
|
|
|
|
```js
|
|
|
let account = null;
|
|
|
```
|
|
|
|
|
|
改為：
|
|
|
|
|
|
```js
|
|
|
let state = {
|
|
|
account: null
|
|
|
};
|
|
|
```
|
|
|
|
|
|
這樣做的目的是將我們應用程式的所有數據集中到一個單一的狀態物件中。目前狀態中只有 `account`，所以變化不大，但這為未來的擴展奠定了基礎。
|
|
|
|
|
|
我們還需要更新使用它的函數。在 `register()` 和 `login()` 函數中，將 `account = ...` 替換為 `state.account = ...`;
|
|
|
|
|
|
在 `updateDashboard()` 函數的開頭，添加以下程式碼：
|
|
|
|
|
|
```js
|
|
|
const account = state.account;
|
|
|
```
|
|
|
|
|
|
這次重構本身並沒有帶來太多改進，但目的是為接下來的更改奠定基礎。
|
|
|
|
|
|
## 跟蹤數據更改
|
|
|
|
|
|
現在我們已經設置了 `state` 物件來存儲數據，下一步是集中更新。目標是讓跟蹤任何更改及其發生時間變得更容易。
|
|
|
|
|
|
為了避免對 `state` 物件進行更改，將其視為[*不可變*](https://en.wikipedia.org/wiki/Immutable_object)是一個好習慣，這意味著它完全不能被修改。這也意味著如果你想更改其中的任何內容，必須創建一個新的狀態物件。這樣做可以防止潛在的[副作用](https://en.wikipedia.org/wiki/Side_effect_(computer_science))，並為應用程式的新功能（如實現撤銷/重做）打開可能性，同時也使調試更容易。例如，你可以記錄對狀態所做的每次更改，並保留更改的歷史記錄，以便了解錯誤的來源。
|
|
|
|
|
|
在 JavaScript 中，你可以使用 [`Object.freeze()`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze) 創建物件的不可變版本。如果你嘗試更改不可變物件，將會引發異常。
|
|
|
|
|
|
✅ 你知道 *淺不可變* 和 *深不可變* 物件之間的區別嗎？你可以在[這裡](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze#What_is_shallow_freeze)閱讀相關內容。
|
|
|
|
|
|
### 任務
|
|
|
|
|
|
讓我們創建一個新的 `updateState()` 函數：
|
|
|
|
|
|
```js
|
|
|
function updateState(property, newData) {
|
|
|
state = Object.freeze({
|
|
|
...state,
|
|
|
[property]: newData
|
|
|
});
|
|
|
}
|
|
|
```
|
|
|
|
|
|
在這個函數中，我們創建了一個新的狀態物件，並使用[*展開運算符 (`...`)*](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Spread_syntax#Spread_in_object_literals)從前一個狀態中複製數據。然後，我們使用[方括號表示法](https://developer.mozilla.org/docs/Web/JavaScript/Guide/Working_with_Objects#Objects_and_properties) `[property]` 覆蓋狀態物件的特定屬性，最後使用 `Object.freeze()` 鎖定物件以防止修改。目前狀態中只存儲了 `account` 屬性，但通過這種方法，你可以在狀態中添加任意多的屬性。
|
|
|
|
|
|
我們還需要更新 `state` 的初始化，以確保初始狀態也是不可變的：
|
|
|
|
|
|
```js
|
|
|
let state = Object.freeze({
|
|
|
account: null
|
|
|
});
|
|
|
```
|
|
|
|
|
|
接下來，更新 `register` 函數，將 `state.account = result;` 替換為：
|
|
|
|
|
|
```js
|
|
|
updateState('account', result);
|
|
|
```
|
|
|
|
|
|
對 `login` 函數執行相同操作，將 `state.account = data;` 替換為：
|
|
|
|
|
|
```js
|
|
|
updateState('account', data);
|
|
|
```
|
|
|
|
|
|
現在，我們可以順便修復用戶點擊 *登出* 時帳戶數據未被清除的問題。
|
|
|
|
|
|
創建一個新函數 `logout()`：
|
|
|
|
|
|
```js
|
|
|
function logout() {
|
|
|
updateState('account', null);
|
|
|
navigate('/login');
|
|
|
}
|
|
|
```
|
|
|
|
|
|
在 `updateDashboard()` 中，將重定向 `return navigate('/login');` 替換為 `return logout();`
|
|
|
|
|
|
嘗試註冊一個新帳戶，登出並重新登錄，檢查一切是否仍然正常運作。
|
|
|
|
|
|
> 提示：你可以在 `updateState()` 的底部添加 `console.log(state)`，然後打開瀏覽器的開發工具中的控制台，查看所有狀態更改。
|
|
|
|
|
|
## 持久化狀態
|
|
|
|
|
|
大多數網頁應用程式需要持久化數據才能正常運作。所有關鍵數據通常存儲在數據庫中，並通過伺服器 API 訪問，例如我們的用戶帳戶數據。但有時，將一些數據存儲在瀏覽器中運行的客戶端應用程式中也是有意義的，這樣可以提升用戶體驗或改善加載性能。
|
|
|
|
|
|
當你想在瀏覽器中持久化數據時，有幾個重要問題需要考慮：
|
|
|
|
|
|
- *數據是否敏感？* 你應該避免在客戶端存儲任何敏感數據，例如用戶密碼。
|
|
|
- *你需要保存這些數據多久？* 你是只打算在當前會話中訪問這些數據，還是希望它們永久保存？
|
|
|
|
|
|
根據你的需求，有多種方式可以在網頁應用程式中存儲信息。例如，你可以使用 URL 存儲搜索查詢，並使其可在用戶之間共享。你還可以使用 [HTTP cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies) 存儲需要與伺服器共享的數據，例如[身份驗證](https://en.wikipedia.org/wiki/Authentication)信息。
|
|
|
|
|
|
另一個選擇是使用瀏覽器的數據存儲 API，其中有兩個特別有趣：
|
|
|
|
|
|
- [`localStorage`](https://developer.mozilla.org/docs/Web/API/Window/localStorage)：一種[鍵值存儲](https://en.wikipedia.org/wiki/Key%E2%80%93value_database)，允許在不同會話之間持久化特定於當前網站的數據。存儲在其中的數據永不過期。
|
|
|
- [`sessionStorage`](https://developer.mozilla.org/docs/Web/API/Window/sessionStorage)：其工作方式與 `localStorage` 相同，但存儲在其中的數據會在會話結束（瀏覽器關閉時）被清除。
|
|
|
|
|
|
需要注意的是，這兩個 API 都只允許存儲[字串](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)。如果你想存儲複雜物件，需要使用 [`JSON.stringify()`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) 將其序列化為 [JSON](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/JSON) 格式。
|
|
|
|
|
|
✅ 如果你想創建一個不依賴伺服器的網頁應用程式，也可以使用 [`IndexedDB` API](https://developer.mozilla.org/docs/Web/API/IndexedDB_API) 在客戶端創建數據庫。這適用於需要存儲大量數據的高級用例，因為它的使用更為複雜。
|
|
|
|
|
|
### 任務
|
|
|
|
|
|
我們希望用戶在明確點擊 *登出* 按鈕之前保持登錄狀態，因此我們將使用 `localStorage` 存儲帳戶數據。首先，定義一個用於存儲數據的鍵。
|
|
|
|
|
|
```js
|
|
|
const storageKey = 'savedAccount';
|
|
|
```
|
|
|
|
|
|
然後在 `updateState()` 函數的末尾添加以下程式碼：
|
|
|
|
|
|
```js
|
|
|
localStorage.setItem(storageKey, JSON.stringify(state.account));
|
|
|
```
|
|
|
|
|
|
通過這樣做，用戶帳戶數據將被持久化，並且由於我們之前集中化了所有狀態更新，它始終是最新的。這正是我們之前重構的好處所在 🙂。
|
|
|
|
|
|
由於數據已保存，我們還需要在應用程式加載時恢復它。由於我們即將有更多初始化程式碼，因此最好創建一個新的 `init` 函數，將之前在 `app.js` 底部的程式碼也包括進來：
|
|
|
|
|
|
```js
|
|
|
function init() {
|
|
|
const savedAccount = localStorage.getItem(storageKey);
|
|
|
if (savedAccount) {
|
|
|
updateState('account', JSON.parse(savedAccount));
|
|
|
}
|
|
|
|
|
|
// Our previous initialization code
|
|
|
window.onpopstate = () => updateRoute();
|
|
|
updateRoute();
|
|
|
}
|
|
|
|
|
|
init();
|
|
|
```
|
|
|
|
|
|
在這裡，我們檢索保存的數據，如果有數據，則相應地更新狀態。重要的是要在更新路由*之前*執行此操作，因為在頁面更新期間可能有程式碼依賴於狀態。
|
|
|
|
|
|
我們還可以將 *儀表板* 頁設為應用程式的默認頁面，因為我們現在已經持久化了帳戶數據。如果未找到數據，儀表板會負責重定向到 *登錄* 頁。在 `updateRoute()` 中，將回退 `return navigate('/login');` 替換為 `return navigate('/dashboard');`。
|
|
|
|
|
|
現在登錄應用程式並嘗試刷新頁面。你應該仍然停留在儀表板頁面。通過這次更新，我們解決了所有初始問題...
|
|
|
|
|
|
## 刷新數據
|
|
|
|
|
|
...但我們可能也創造了一個新問題。糟糕！
|
|
|
|
|
|
使用 `test` 帳戶進入儀表板，然後在終端運行以下命令創建一個新交易：
|
|
|
|
|
|
```sh
|
|
|
curl --request POST \
|
|
|
--header "Content-Type: application/json" \
|
|
|
--data "{ \"date\": \"2020-07-24\", \"object\": \"Bought book\", \"amount\": -20 }" \
|
|
|
http://localhost:5000/api/accounts/test/transactions
|
|
|
```
|
|
|
|
|
|
現在嘗試在瀏覽器中刷新儀表板頁面。會發生什麼？你看到新交易了嗎？
|
|
|
|
|
|
由於 `localStorage` 使狀態被無限期持久化，但這也意味著在你登出應用程式並重新登錄之前，它永遠不會更新！
|
|
|
|
|
|
一種可能的解決策略是每次加載儀表板時重新加載帳戶數據，以避免數據陳舊。
|
|
|
|
|
|
### 任務
|
|
|
|
|
|
創建一個新函數 `updateAccountData`：
|
|
|
|
|
|
```js
|
|
|
async function updateAccountData() {
|
|
|
const account = state.account;
|
|
|
if (!account) {
|
|
|
return logout();
|
|
|
}
|
|
|
|
|
|
const data = await getAccount(account.user);
|
|
|
if (data.error) {
|
|
|
return logout();
|
|
|
}
|
|
|
|
|
|
updateState('account', data);
|
|
|
}
|
|
|
```
|
|
|
|
|
|
此方法檢查我們當前是否已登錄，然後從伺服器重新加載帳戶數據。
|
|
|
|
|
|
再創建另一個名為 `refresh` 的函數：
|
|
|
|
|
|
```js
|
|
|
async function refresh() {
|
|
|
await updateAccountData();
|
|
|
updateDashboard();
|
|
|
}
|
|
|
```
|
|
|
|
|
|
此函數更新帳戶數據，然後負責更新儀表板頁面的 HTML。這是我們需要在加載儀表板路由時調用的函數。使用以下程式碼更新路由定義：
|
|
|
|
|
|
```js
|
|
|
const routes = {
|
|
|
'/login': { templateId: 'login' },
|
|
|
'/dashboard': { templateId: 'dashboard', init: refresh }
|
|
|
};
|
|
|
```
|
|
|
|
|
|
現在嘗試重新加載儀表板，它應該顯示更新的帳戶數據。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 🚀 挑戰
|
|
|
|
|
|
現在我們每次加載儀表板時都會重新加載帳戶數據，你認為我們是否仍然需要持久化*所有帳戶*數據？
|
|
|
|
|
|
試著一起合作，修改 `localStorage` 中保存和加載的內容，使其僅包含應用程式正常運作所需的數據。
|
|
|
|
|
|
## 課後測驗
|
|
|
[課後測驗](https://ff-quizzes.netlify.app/web/quiz/48)
|
|
|
|
|
|
## 作業
|
|
|
|
|
|
[實作「新增交易」對話框](assignment.md)
|
|
|
|
|
|
以下是完成作業後的範例結果：
|
|
|
|
|
|
|
|
|
|
|
|
**免責聲明**：
|
|
|
本文件已使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們努力確保翻譯的準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。應以原始語言的文件作為權威來源。對於重要信息，建議使用專業人工翻譯。我們對因使用此翻譯而引起的任何誤解或誤釋不承擔責任。 |
