萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 動態建立 Form 表單 POST 提交:通用工具函式與安全考量

應用場景

  • 需以 POST 方式跳轉頁面 (非 AJAX),例如:導向支付頁、下載報表、列印預覽
  • 參數包含敏感資料,不宜暴露在 URL (GET 參數)
  • 參數過長超過 URL 長度限制 (IE 2083 字元)
  • 需模擬表單提交觸發伺服端驗證流程

通用 post() 工具函式

/**
 * 動態建立表單並 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' }
});

新分頁開啟 (target='_blank')

// 避開瀏覽器攔截彈出視窗:必須在使用者點擊事件中直接呼叫
$('#btnExport').on('click', function() {
  post('/export/excel', { 
    reportId: 123, 
    columns: ['id', 'name', 'email'] 
  }, '_blank');
});

檔案下載 (配合後端 Content-Disposition)

// 後端回傳:Content-Disposition: attachment; filename="report.xlsx"
post('/api/download', { fileId: 'abc123' }, '_self');

進階:支援檔案上傳的 FormData 版本

若需包含 `` 檔案,需用 `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、僅允許相對路徑
參數汙染陣列/物件參數覆蓋內部欄位後端嚴格綁定模型、忽略額外欄位

現代替代方案

1. fetch + 隱藏表單 (需導向新頁面)

// 先 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();
}

2. 原生表單提交 (無 JS 依賴)

<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()。

3. download 屬性 (純前端檔案下載)

<a href="/api/report/123" download="report.xlsx">下載</a>
// 需後端支援 CORS 或同源,且回傳 Content-Disposition

總結

動態建立 Form POST 是解決「需 POST 導向」場景的經典技巧。本文提供的 post() 函式支援巢狀參數、CSRF Token、多目標視窗。現代開發中:

理解 Form 提交機制、CSRF 防護、瀏覽器彈窗攔截行為,是全端工程師必備基本功。

copyright © 萬盛學電腦網 all rights reserved