寫一些小 Demo 的時候,我們通常不會特地架一套完整環境:開一個資料夾、建立幾個檔案、用編輯器寫完,然後直接雙擊 HTML 丟進瀏覽器看結果。流程很輕快,但只要 Demo 裡出現 AJAX,問題就来了。
開啟開發者工具,你會看到類似這樣的錯誤訊息:
XMLHttpRequest cannot load file:///Users/iceStone/Documents/demo/view.html. Cross origin requests are only supported for protocol schemes: http, data, chrome, chrome-extension, https, chrome-extension-resource.
原因出在瀏覽器(Webkit 核心)的安全性設計:以 file 協定開啟的頁面,不能使用 XMLHttpRequest 物件發請求。錯誤訊息本身其實已經把答案寫出來了——跨來源請求只支援 http、https、data、chrome 等協定,file 不在名單裡。
值得一提的是,並非所有瀏覽器都這樣限制,Firefox 就允許 file 協定下的 AJAX 請求。
在 Chrome 捷徑上按右鍵開啟「內容」,於「目標」欄位的最後面加上一個空格,再補上參數:
--allow-file-access-from-files
按下確定後重新啟動 Chrome 即可生效。
open -a "Google Chrome" --args --disable-web-security
這樣開起來的 Chrome 會暫時關閉同源檢查,方便本地除錯。
短期靠參數硬開是可行的,但長期而言,你的應用終究要透過 HTTP 存取,與其每次繞路,不如把環境補齊。
使用 IDE 的開發者不必操心,因為幾乎所有供 Web 開發用的 IDE 都內建了 HTTP 伺服器。偏好輕量編輯器的人(例如 Sublime Text)則需要額外安裝,這裡推薦 SublimeServer 這類靜態伺服器插件:
• 先安裝套件管理工具 Package Control
• 以 Ctrl+Shift+P(macOS 為 Command+Shift+P)開啟命令面板,執行 Package Control: Install Package
• 搜尋並安裝 SublimeServer
• 透過 Tools → SublimeServer → Start SublimeServer 啟動
• 務必以「開啟資料夾」的方式使用 Sublime,否則插件無法正常運作
• 在 HTML 檔案上按右鍵選擇 View in SublimeServer,即可用 HTTP 協定開啟
若該選項是灰色的,代表伺服器還沒啟動,回到 Tools 選單啟動即可。
常見卡點:啟動失敗多半是連接埠被占用。SublimeServer 預設使用 8080,打開設定檔換一個連接埠就好:
{
"attempts": 5,
"autorun": false, // 啟動 Sublime 時是否自動啟動伺服器
"defaultExtension": ".html",
"interval": 500,
"mimetypes": {
"": "application/octet-stream",
".c": "text/plain",
".h": "text/plain",
".py": "text/plain"
},
"port": 2016 // 連接埠號
}其他編輯器同樣有對應的插件可以達到相同效果。與其跟瀏覽器的安全機制硬碰硬,把本地服務環境建立起來,才是更省事的長久之計。