如何將Excel檔案解析為json格式

Youth發表於2019-02-16
ExcelJSON

最近工作中遇到一個需求，大致需求就是將Excel檔案在匯入時解析為json格式轉換資料結構再傳輸給後臺。這方面的庫比較少，比較主流的是js-xlsx，官網地址為sheetjs官網，但是文件都寫得不太清楚，坑也比較多，這裡我做一個簡單的介紹與運用與避坑指南。

先介紹幾個基本概念：

workbook 物件，指的是整份 Excel 文件。我們在使用 js-xlsx 讀取 Excel 文件之後就會獲得 workbook
物件。

worksheet 物件，指的是 Excel 文件中的表。我們知道一份 Excel 文件中可以包含很多張表，而每張表對應的就是 worksheet 物件。

廢話不多說直接上這裡演示下網頁中使用

<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <title></title>
        <script src="http://oss.sheetjs.com/js-xlsx/xlsx.full.min.js"></script>
    </head>

    <body>
        <input type="file"onchange="importf(this)" />
        <div id="demo"></div>
        <script>
            /*
            FileReader共有4種讀取方法：
            1.readAsArrayBuffer(file)：將檔案讀取為ArrayBuffer。
            2.readAsBinaryString(file)：將檔案讀取為二進位制字串
            3.readAsDataURL(file)：將檔案讀取為Data URL
            4.readAsText(file, [encoding])：將檔案讀取為文字，encoding預設值為`UTF-8`
                         */
            var wb;//讀取完成的資料
            var rABS = true; //是否將檔案讀取為二進位制字串
            function importf(obj) {//匯入
                if(!obj.files) {
                    return;
                }
                var f = obj.files[0];
                console.log(f);
                var reader = new FileReader();
                reader.onload = function(e) {
                    var data = e.target.result;
                    if(rABS) {
                        wb = XLSX.read(btoa(fixdata(data)), {//手動轉化
                            type: `base64`
                        });
                    } else {
                        wb = XLSX.read(data, {
                            type: `binary`
                        });
                    }
                    //wb.SheetNames[0]是獲取Sheets中第一個Sheet的名字
                    //wb.Sheets[Sheet名]獲取第一個Sheet的資料
                    console.log(JSON.stringify(XLSX.utils.sheet_to_json(wb.Sheets[wb.SheetNames[0]])));
                };
                if(rABS) {
                    reader.readAsArrayBuffer(f);
                } else {
                    reader.readAsBinaryString(f);
                }
            }
            function fixdata(data) { //檔案流轉BinaryString
                var o = "",
                    l = 0,
                    w = 10240;
                for(; l < data.byteLength / w; ++l) 
                o += String.fromCharCode.apply(null, new Uint8Array(data.slice(l * w, l * w + w)));
                o += String.fromCharCode.apply(null, new Uint8Array(data.slice(l * w)));
                return o;
            }

            var rABS = true; // true: readAsBinaryString ; false: readAsArrayBuffer
            function handleFile(e) {
                var files = e.target.files, f = files[0];
                var reader = new FileReader();
                reader.onload = function(e) {
                    var data = e.target.result;
                    if(!rABS) data = new Uint8Array(data);
                    var workbook = XLSX.read(data, {type: rABS ? `binary` : `array`});
                };
                if(rABS) reader.readAsBinaryString(f); 
                else reader.readAsArrayBuffer(f);
            }
            input_dom_element.addEventListener(`change`, handleFile, false);

        </script>
    </body>

</html>

這裡演示下在react+antd組合下使用

import { Button, Icon } from `antd`;
const XLSX = require(`XLSX`);//必須使用CommonJs規範引入，如果使用import引入則找不到read 方法

<Button onClick={this.handle_click_send_file}>
    <input type="file" accept=".csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel"
       style={{display: `none`}}
       ref={(input) => { input ? this.file_input = input : null; }}
       onChange={this.handle_file_change}
    />
    <Icon type="upload" />匯入三級
</Button>

  handle_click_send_file = () => {
    this.file_input.click();
  }

  handle_file_change = () => {
    this.asyncReaderFile(this.file_input, XLSX).then((res) => {
      console.log(res); //在回撥函式中輸出結果
    });
  }

asyncReaderFile = (event, XLSX) => {
    const files = event.files || [];
    const file = files[0]; //獲取第一個Blob物件
    return new Promise((resolve, reject) => {
      const reader = new FileReader();
      reader.readAsBinaryString(file); //readAsBinaryString(file)：將檔案讀取為二進位制字串
      reader.onload = function(e) {
        const data = e.target.result;
        //XLSX.read獲得 workbook物件，指的是整份Excel文件,並將其解析為二進位制字串
        const wb = XLSX.read(data, {
          type: `binary`,
        });
        //wb.SheetNames[0]是獲取第一個表名
        //wb.Sheets[表名]獲取第一個表的資料
        //XLSX.utils.sheet_to_json生成一個物件陣列，JSON.stringify解析為json物件
        const json = XLSX.utils.sheet_to_json(wb.Sheets[wb.SheetNames[0]]);
        //這裡將解析出的json資料轉換下格式
        const resData = json.map((obj) => {
          let words = ``;
          for (const i in obj) {
            words += obj[i] + `/`;
          }
          return words;
        });
        resolve(resData);
      };
    });
  };

這裡主要的一個坑就是不能使用inport 引用！因為這個庫很早之前就做出來了，用的是CommonJs規範，因此不能用import方式引用；另一個需要注意的點是在瀏覽器中需要使用read方式解析出workbook物件，在Node環境中則需要使用readFile解析出workbook物件。

還有很多其他用法，具體的詳情可以看下文件npm-xlsx

相關文章