/**
* 動態建立表單並 POST 提交
* @param {string} url - 目標 URL
* @param {Object} params - 參數物件 { key: value, ... }
* @param {string} [target] - 目標視窗:'_blank' 新分頁, '_self' 當前, iframe name
* @param {string} [method='post'] - HTTP 方法
*/
function post(url, params, target, method) {
method = (method || 'post').toLowerCase();
target = target || '_self';
// 建立 form 元素
var form = document.createElement('form');
form.action = url;
form.method = method;
form.target = target;
form.style.display = 'none';
form.acceptCharset = 'utf-8';
// 遞迴處理參數 (支援巢狀物件、陣列)
function appendParams(obj, prefix) {
for (var key in obj) {
if (!obj.hasOwnProperty(key)) continue;
var value = obj[key];
var name = prefix ? prefix + '[' + key + ']' : key;
if (value === null || value === undefined) continue;
if (Array.isArray(value)) {
value.forEach(function(item, i) {
appendParams(item, name + '[' + i + ']');
});
} else if (typeof value === 'object') {
appendParams(value, name);
} else {
var input = document.createElement('input');
input.type = 'hidden';
input.name = name;
input.value = String(value);
form.appendChild(input);
}
}
}
appendParams(params);
// 加入防 CSRF Token (若專案有)
var csrfToken = getCsrfToken(); // 專案自行實作
if (csrfToken) {
var csrfInput = document.createElement('input');
csrfInput.type = 'hidden';
csrfInput.name = '_csrf';
csrfInput.value = csrfToken;
form.appendChild(csrfInput);
}
// 加入文檔、提交、移除
document.body.appendChild(form);
form.submit();
// 注意:submit() 後頁面會跳轉,後續代碼不會執行
// 若 target='_blank',本頁可移除 form
if (target === '_blank') {
setTimeout(function() { document.body.removeChild(form); }, 0);
}
}
// 輔助:從 Cookie/Meta 取得 CSRF Token
function getCsrfToken() {
var meta = document.querySelector('meta[name="csrf-token"]');
return meta ? meta.getAttribute('content') : null;
}
// 當前頁面 POST 跳轉
post('/report/generate', {
type: 'pdf',
dateFrom: '2024-01-01',
dateTo: '2024-01-31',
filters: { dept: 'IT', status: 'active' }
});
// 避開瀏覽器攔截彈出視窗:必須在使用者點擊事件中直接呼叫
$('#btnExport').on('click', function() {
post('/export/excel', {
reportId: 123,
columns: ['id', 'name', 'email']
}, '_blank');
});
// 後端回傳:Content-Disposition: attachment; filename="report.xlsx"
post('/api/download', { fileId: 'abc123' }, '_self');
若需包含 `` 檔案,需用 `FormData` + `fetch/XHR`,無法用動態 form.submit() (安全限制)。
async function postWithFiles(url, fields, files, target = '_self') {
var formData = new FormData();
Object.entries(fields).forEach(([k, v]) => formData.append(k, v));
files.forEach(f => formData.append('files', f));
if (target === '_blank') {
// 新分頁下載:先 POST 取得 blob,再建立 object URL
var resp = await fetch(url, { method: 'POST', body: formData });
var blob = await resp.blob();
var url = URL.createObjectURL(blob);
window.open(url, '_blank');
setTimeout(() => URL.revokeObjectURL(url), 1000);
} else {
// 當前頁導向:需後端回傳 HTML 頁面而非檔案流
// 或使用隱藏 iframe 接收回應
var iframe = document.createElement('iframe');
iframe.name = 'downloadFrame';
iframe.style.display = 'none';
document.body.appendChild(iframe);
var form = document.createElement('form');
form.action = url; form.method = 'post'; form.target = 'downloadFrame';
// 注意:FormData 無法直接用於 form.submit()
// 需後端支援 JSON 或另行處理
}
}
| 風險 | 說明 | 防護 |
|---|---|---|
| CSRF (跨站請求偽造) | 惡意網站誘導使用者提交表單 | 雙重防護:CSRF Token + SameSite Cookie |
| XSS (參數注入) | 參數未編碼直接輸出 | 後端輸出編碼、CSP 標頭 |
| 開放重導向 | url 參數可控導向惡意站點 | 白名單驗證 url、僅允許相對路徑 |
| 參數汙染 | 陣列/物件參數覆蓋內部欄位 | 後端嚴格綁定模型、忽略額外欄位 |
// 先 POST 取得 HTML,再寫入 document.open/write
async function postAndNavigate(url, data) {
const resp = await fetch(url, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(data)
});
const html = await resp.text();
document.open();
document.write(html);
document.close();
}
<form action="/report/generate" method="post" target="_blank">
<input type="hidden" name="type" value="pdf">
<input type="hidden" name="dateFrom" value="2024-01-01">
<button type="submit">匯出 PDF</button>
</form>
最簡單、最相容、最無障礙。動態參數時用 JS 修改 hidden input 值再 submit()。
<a href="/api/report/123" download="report.xlsx">下載</a>
// 需後端支援 CORS 或同源,且回傳 Content-Disposition
動態建立 Form POST 是解決「需 POST 導向」場景的經典技巧。本文提供的 post() 函式支援巢狀參數、CSRF Token、多目標視窗。現代開發中:
理解 Form 提交機制、CSRF 防護、瀏覽器彈窗攔截行為,是全端工程師必備基本功。