返回任務地圖

把空資料與失敗分開

第 17 堂 · 第 2/3 關 · 觀念 18 分鐘+實作 42 分鐘

查看本堂完整六步
先接任務,準備開始

把空資料與失敗分開,每一步都有依據。

沒有服務時不能讓使用者選假資料;讀取失敗要保留文字並提供明確重試,不能偷偷退回靜態清單。

這關帶走:空資料與失敗文字不同,載入及無服務不送出。

步驟 3/6 · 觀念 18 分鐘

先學一招:200空陣列不等於503讀取失敗

空資料與失敗文字不同,載入及無服務不送出。

帶上你的裝備

  • 自己的service-site/frontend/inquiry.html、inquiry.js、config.js與完整styles.css
  • 隨起始包提供的API_CONTRACT.html、START_HERE.html與實際Network紀錄;不附管理密碼
  • normal/empty/error實際回應與預期表

沒有服務時不能讓使用者選假資料;讀取失敗要保留文字並提供明確重試,不能偷偷退回靜態清單。

一起拆解:同樣沒選項,原因不同

本關18分鐘觀念:3分鐘看輸入、6分鐘逐步推演、5分鐘正常與錯誤對照、4分鐘先預測再說明。

這次的輸入

先正常讀到三項,再分別切services=empty與services=error。

200 {services:[]} → 沒有可選服務
503 {error:...} → 讀取失敗,可手動重試
讀取中 → 禁用選擇與送出

這段是觀念縮圖,完整可操作檔案在本關參考成果;請依當前階段判讀,不把片段直接貼到任意位置。

一步一步推演

  1. 先在第二終端依TEST_MODES切換;第一次啟動要有TEACHING_MODE=1。
  2. 每次載入先清舊選項並禁用操作;文字欄保留,不回退假清單。
  3. 回normal後按重試,確認三項恢復,原主旨及草稿仍在。

正常應看到

空資料、失敗與載入中提示可區分;不會把上次選項當最新成功。

常見錯誤對照

503時留著可送出的舊選項,可能使人誤認服務資料正常。

先預測,再說明原因

看到200且空陣列,應重登管理員還是告知目前無服務?

跟著觀察

  1. 先讀「同樣沒選項,原因不同」的輸入,指出本關實際檔案或資料。
  2. 看到200且空陣列,應重登管理員還是告知目前無服務?
  3. 依例子逐步說明正常結果與錯誤差別,再記下自己的預測;參考結果不是已完成的實測。
GET回200且services=[],應顯示?

選一個試試看,答錯也可以再試。

這是你的實際操作確認,小測不會替你勾選。

步驟 4/6 · 實作 42 分鐘

動手挑戰:把空資料與失敗分開

空資料與失敗文字不同,載入及無服務不送出。

先準備

  • 自己的service-site/frontend/inquiry.html、inquiry.js、config.js與完整styles.css
  • 隨起始包提供的API_CONTRACT.html、START_HERE.html與實際Network紀錄;不附管理密碼
  • normal/empty/error實際回應與預期表

親手記normal/empty/error各自預期,再依契約切模式。

照這個順序開始

  1. 依契約由核准教學請求切換三種services模式。
  2. 請AI只加空資料、錯誤提示與手動重試,不改其他欄位。
  3. 填主旨再失敗重試,確認原值不清掉、恢復後讀到正確選項。

補齊服務載入狀態與重試

主要使用 Cursor 內建 AI;先附資料,再送出指令。

1.附上這些檔案與資料
  • 自己的service-site/frontend/inquiry.html、inquiry.js、config.js與完整styles.css
  • 隨起始包提供的API_CONTRACT.html、START_HERE.html與實際Network紀錄;不附管理密碼
  • normal/empty/error實際回應與預期表
2.貼到哪裡
  1. 在 Cursor 開啟自己的本關練習副本,進入內建 AI 對話;正常版與故障副本分開。
  2. 用 @ 附上本關指定檔案,核對完整路徑;補實際觀察、輸入與結果,再貼下方 Prompt。
  3. 先讀回覆與差異,只保存指定範圍;回到瀏覽器實際檢查。版本保存由自己操作,不讓 AI 代替驗收或提交。
3.預期回覆與操作
  • 請AI只加空資料、錯誤提示與手動重試,不改其他欄位。
  • 手動重試可恢復選項,文字與草稿不變。
4.自己檢查結果
  • 空資料與失敗文字不同,載入及無服務不送出。
  • 手動重試可恢復選項,文字與草稿不變。
補齊服務載入狀態與重試 Prompt(可收合)

你是協助零基礎學員的網站開發助手。我使用 Cursor 免費版編輯原生 HTML、CSS、JavaScript;必要時把你提供的內容手動貼入檔案。

情境與本次輸入:從第16堂正常service-site/frontend承接;起始包已附真實Node.js22+後端、API_CONTRACT.html與START_HERE.html,無第三方套件。後端預設127.0.0.1:8780,資料在frontend外backend/.data。GET /api/services回200 {services:[{id,name}]},空陣列與503失敗不同。config.js只放公開apiBase;請求credentials:include,來源需後端明確允許,不用no-cors。APPA、紫綠tokens與五欄草稿保留。這堂只讀服務,尚未POST詢問。

本次任務:只改善服務載入:200 services=[]顯示目前無可選服務並禁用選擇與送出;503或格式錯誤顯示失敗與重新讀取按鈕。重試重新GET,不自動不停重試、不回退硬編清單;載入中清舊選項並禁用操作,已填文字與草稿保留。保留正常id/name映射、config與五欄驗證,不接詢問POST。列normal/empty/error後恢復normal的實測與待測。

請先閱讀我附上的相關檔案或資料,資訊缺漏時精確列出需要補充的項目,不猜檔名、API 或測試結果。說明以繁體中文撰寫,指出檔案與修改位置;檢查結果區分已知、待驗與未完成。只處理學生自己的練習副本,不改現有展示網站,不要求付費訂閱。
Cursor AI 無法使用?改用 ChatGPT 備援

把上方指定的檔案內容、清單與補充資料,連同同一份 Prompt 貼入 ChatGPT 對話。只貼電腦上的路徑,無法讓它讀取你的檔案。

收到程式碼時,先核對檔名與修改位置,再手動存回自己的練習副本;若收到檢查表或補檔步驟,就逐項操作。不要把 Prompt 或程式碼框的反引號貼進 HTML/CSS。

兩邊都受限時,可先看既有參考成果、檢查差異與手動修改;未做過的 AI 生成或公開發布仍記待完成。不要貼入帳密、金鑰或真實個資。

複製只取得 Prompt 文字,檔案需自行在 Cursor 附上;本頁不會呼叫 AI 或自動完成關卡。

卡住時,APPA 給你一點線索

線索 1|先找現象與證據

先看HTTP狀態,再看陣列長度。

線索 2|再縮小修改範圍

重試只讀服務,不重設整張表單。

回到自己的作品,逐項檢查

  • 空資料與失敗文字不同,載入及無服務不送出。
  • 手動重試可恢復選項,文字與草稿不變。
  • 未實際完成的AI、發布或裝置驗收記待完成。
需要對照?看這一關的參考成果

先檢查自己的作品,再對照差異。開啟參考不會算完成。

查看前端參考畫面(完整操作請下載參考包)(另開分頁)

線上只看前端畫面;完整操作請下載。本頁不提供案件API。把參考包解壓到新的資料夾,先讀 OPEN_REFERENCE.html,再啟動隨包後端;不要覆蓋自己的作品或案件。

下載本關可啟動參考包

看參考包啟動與資料保留步驟

尚未完成可以先往下看,之後再回來補做。

保留依據與結果,再帶著作品往下走。

保留自己的修改差異與檢查結果。完成兩項操作確認再往下一關;也可以先閱讀,稍後補做。

關卡紀錄由你自行確認;本頁不會讀取 Cursor 檔案或自動驗收作品。

留下自己的檢查紀錄

這是第 17 堂共用筆記,換關卡仍會保留。未實際做過的操作寫「待完成」。

重設會清除第 17 堂六步勾選,筆記、另一堂進度與網站檔案保留。