DIV CSS 佈局教程網

JavaScript 匯出 Excel 的三種實作與記憶體陷阱
編輯:關於JavaScript     

把網頁上的表格匯出成 Excel,是企業內部系統的高頻需求。下面整理三種做法,並特別說明使用 ActiveX 時最容易踩到的記憶體與權限問題。

頁面結構

先準備一個待匯出的表格與三顆按鈕:

<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>WEB 頁面匯出為 EXCEL 文檔的方法</title>
</head>
<body>
<table id="tableExcel" width="100%" border="1" cellspacing="0" cellpadding="0">
  <tr>
    <td colspan="5" align="center">WEB 頁面匯出為 EXCEL 文檔的方法</td>
  </tr>
  <tr>
    <td>列標題1</td><td>列標題2</td><td>列標題3</td>
    <td>列標題4</td><td>列標題5</td>
  </tr>
  <tr>
    <td>aaa</td><td>bbb</td><td>ccc</td><td>ddd</td><td>eee</td>
  </tr>
</table>

<input type="button" onclick="javascript:method1('tableExcel');" value="第一種方法匯入到 EXCEL">
<input type="button" onclick="javascript:method2('tableExcel');" value="第二種方法匯入到 EXCEL">
<input type="button" onclick="javascript:getXlsFromTbl('tableExcel', null);" value="第三種方法匯入到 EXCEL">
</body>
</html>

方法一:整個表格複製貼上

利用 TextRange 選取表格內容後執行複製,再貼進 Excel:

function method1(tableid) {
  var curTbl = document.getElementById(tableid);
  var oXL = new ActiveXObject("Excel.Application"); // 建立 AX 物件 excel
  var oWB = oXL.Workbooks.Add();                    // 取得 workbook 物件
  var oSheet = oWB.ActiveSheet;                     // 使用目前作用中的 sheet

  var sel = document.body.createTextRange();
  sel.moveToElementText(curTbl);  // 把表格內容移進 TextRange
  sel.select();                   // 全選
  sel.execCommand("Copy");        // 複製
  oSheet.Paste();                 // 貼上到 Excel
  oXL.Visible = true;             // 讓 Excel 可見
}

優點是保留原本的格式與合併情形;缺點是依賴剪貼簿,不適合自動化作業。

方法二:逐格讀寫

function method2(tableid) {
  var curTbl = document.getElementById(tableid);
  var oXL = new ActiveXObject("Excel.Application");
  var oWB = oXL.Workbooks.Add();
  var oSheet = oWB.ActiveSheet;

  var Lenr = curTbl.rows.length;      // 取得表格行數
  for (var i = 0; i < Lenr; i++) {
    var Lenc = curTbl.rows(i).cells.length; // 取得該行的欄數
    for (var j = 0; j < Lenc; j++) {
      oSheet.Cells(i + 1, j + 1).value = curTbl.rows(i).cells(j).innerText;
    }
  }
  oXL.Visible = true;
}

這種做法資料乾淨、可控性高,但完全失去原始格式。

方法三:組出字串後另存為 CSV

不啟動 Excel,而是把表格內容組成分隔字串,透過隱藏視窗觸發「另存新檔」:

function getXlsFromTbl(inTblId, inWindow) {
  try {
    var curStr = "";
    if (inTblId != null && inTblId != "" && inTblId != "null") {
      curStr = getTblData(inTblId, inWindow);
    }
    if (curStr == null) {
      alert("你要匯出的表不存在!");
      return;
    }
    doFileExport(getExcelFileName(), curStr);
  } catch (e) {
    alert("匯出發生異常: " + e.name + "->" + e.description);
  }
}

function getTblData(inTbl, inWindow) {
  var rows = 0;
  var tblDocument = document;
  if (!!inWindow && inWindow != "") {
    if (!document.all(inWindow)) return null;
    tblDocument = window[inWindow].document;
  }

  var curTbl = tblDocument.getElementById(inTbl);
  if (curTbl == null) {
    alert(inTbl + "不存在!");
    return null;
  }

  var outStr = "";
  for (var j = 0; j < curTbl.rows.length; j++) {
    for (var i = 0; i < curTbl.rows[j].cells.length; i++) {
      if (i == 0 && rows > 0) { outStr += "&nbsp; "; rows -= 1; }
      outStr += curTbl.rows[j].cells[i].innerText + " ";

      if (curTbl.rows[j].cells[i].colSpan > 1) {
        for (var k = 0; k < curTbl.rows[j].cells[i].colSpan - 1; k++) {
          outStr += "&nbsp; ";
        }
      }
      if (i == 0 && rows == 0 && curTbl.rows[j].cells[i].rowSpan > 1) {
        rows = curTbl.rows[j].cells[i].rowSpan - 1;
      }
    }
    outStr += " ";
  }
  return outStr;
}

function getExcelFileName() {
  var d = new Date();
  function pad(n) { return ("0" + n).slice(-2); }
  var name = "export_" + d.getFullYear()
    + pad(d.getMonth() + 1) + pad(d.getDate()) + "_"
    + pad(d.getHours()) + pad(d.getMinutes()) + pad(d.getSeconds())
    + ".csv";
  return name;
}

function doFileExport(inName, inStr) {
  var xlsWin;
  if (!!document.all("glbHideFrm")) {
    xlsWin = glbHideFrm;
  } else {
    var width = 6, height = 4;
    var openPara = "left=" + (window.screen.width / 2 - width / 2)
      + ",top=" + (window.screen.height / 2 - height / 2)
      + ",scrollbars=no,width=" + width + ",height=" + height;
    xlsWin = window.open("", "_blank", openPara);
  }
  xlsWin.document.write(inStr);
  xlsWin.document.close();
  xlsWin.document.execCommand('Saveas', true, inName);
  xlsWin.close();
}

Excel 行程關不掉的問題

使用 ActiveX 操作 Excel 時,最惱人的莫過於「關閉視窗後,工作管理員裡還留著 EXCEL.EXE」。基礎範例如下:

<script>
var strSaveLocation = 'file:///E:/1.xls';

function createXLS() {
  var excel = new ActiveXObject("Excel.Application");
  var wk = excel.Workbooks.Add();
  wk.SaveAs(strSaveLocation);
  wk.Saved = true;
  excel.Quit();
}

function writeXLS() {
  var excel = new ActiveXObject("Excel.Application");
  var wk = excel.Workbooks.Open(strSaveLocation);
  var sheet = wk.Worksheets(1);
  sheet.Cells(1, 1).Value = '測試字串';
  wk.SaveAs(strSaveLocation);
  wk.Saved = true;
  excel.Quit();
}
</script>

<body>
  <button onclick="createXLS()">建立</button>
  <button onclick="writeXLS()">重寫</button>
</body>

操作本機檔案時,頂多殘留一些記憶體垃圾。但如果 strSaveLocation 指向遠端 URL,情況就嚴重了:本機會保留一份檔案存取權限憑證,而且同一時間只允許一個實例開啟並儲存該文件。反覆點擊「重寫」,就會開始出現異常。這類問題在 SharePoint 這類操作共用文件的專案中是實際會遇到的,不是學術討論。

先理解 JavaScript 物件的「失效」

要解決它,得先分清兩件事:

  • 物件在其所屬的上下文環境之外,即會失效
  • 全域物件在沒有被引用時,即會失效
function testObject() {
  var _obj1 = new Object();
}
function testObject2() {
  var _obj2 = new Object();
  return _obj2;
}

testObject();          // 範例 1:函數退出即失效

testObject2();         // 範例 2:回傳值沒被承接,立即失效

var obj3 = testObject2();
obj3 = null;           // 範例 3:設為 null 後失效

var obj4 = testObject2();
var arr = [obj4];
arr = [];              // 範例 4:陣列清空後才失效

但關鍵在於:「失效」不等於「釋放」。JavaScript 執行環境沒有任何方式確切告訴你物件何時被回收,這取決於記憶體回收機制,策略與 .NET 類似。

而 Excel 那個 EXCEL.EXE 行程的所有者身分,只有在「ActiveX 物件實例被釋放」之後才會消失。檔案鎖與作業系統權限憑證都是與行程綁定的。所以物件只是失效、沒有釋放,其他行程存取檔案與權限憑據時就會出問題。

這不是 JavaScript 或 COM 的 bug,而是作業系統、IE 與 JavaScript 三者之間複雜關係的結果。

解法一:主動呼叫垃圾回收

微軟在 JScript 中提供了 CollectGarbage()(簡稱 GC),用來清理目前 IE 中失效的物件實例,也就是主動觸發解構:

function writeXLS() {
  // (略)

  excel.Quit();                        // 1. 請求 Excel 行程結束
  excel = null;                        // 2. 清除引用,使物件失效
  setTimeout(CollectGarbage, 1);       // 3. 離開上下文後再回收
}

三行的分工:

  1. excel.Quit() 請求行程中止,但由於 JS 環境仍持有實例,行程不會真的結束;
  2. 設為 null 清除引用,讓物件「失效」;
  3. 用 setTimeout 延後一個 tick 呼叫 GC,確保它發生在 writeXLS() 執行完之後。這樣物件才同时满足「沒有引用」與「已離開上下文」兩個條件。

在使用了 ActiveX 物件的 JS 環境中,主動呼叫 GC 相當有效。常見的 ActiveX 物件包含 XML、VML、OWC(Office Web Component)、Flash,甚至 JS 中的 VBArray。由於 Ajax 架構大量使用 XMLHTTP 且不切換頁面,在適當時候呼叫 GC 能改善效能與使用者體驗。

解法二:切換頁面(更徹底)

即使呼叫了 GC,Excel 問題也不會完全消失,因為 IE 仍快取了權限憑據。而更新頁面權限憑據的唯一方式,是切換到新頁面。因此在實務專案中,最終採用的做法是:

function writeXLS() {
  // (略)

  excel.Quit();
  excel = null;

  // 解決 IE 呼叫 Excel 的已知問題
  // MSDN 提供的方法:setTimeout(CollectGarbage, 1);
  // 但由於無法清除頁面的受信任狀態,
  // SaveAs() 等方法在下次呼叫時仍會失效,
  // 因此改用重新載入。
  location.reload();
}

最後補充一個冷知識:當 IE 視窗被最小化時,IE 會主動呼叫一次 CollectGarbage()。這就是為什麼 IE 視窗最小化回來之後,記憶體占用往往會明顯下降。

現代的建議做法

上面這整套依賴 ActiveX 的方案,只在 IE 且本機已安裝 Office 的環境下有效,安全性設定也經常把 new ActiveXObject 擋掉。今天更合理的選擇是:

  • 輕量場景:前端用 SheetJS(xlsx)直接產生檔案,完全不走 ActiveX
  • 正式場景:由後端輸出報表,前端觸發下載(Content-Disposition: attachment)
  • 簡單表格:組出 CSV 字串搭配 Blob 與 URL.createObjectURL 下載,程式碼量極少

但理解 ActiveX 時代的記憶體與憑證問題仍有價值——它讓你明白「物件不存在」與「資源已釋放」是兩件不同的事,這個觀念在任何語言環境都適用。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved