const ExcelJS = require('exceljs');

要使用 ES5 編譯代碼，請使用 dist/es5 路徑。

const ExcelJS = require('exceljs/dist/es5');

**注意：**ES5 版本對許多 polyfill 都具有隱式依賴，而 exceljs 不再明確添加。
您需要在依賴項中添加 core-js 和 regenerator-runtime，并在導入 exceljs 之前在代碼中包含以下引用：

// exceljs 所需的 polyfills
require('core-js/modules/es.promise');
require('core-js/modules/es.string.includes');
require('core-js/modules/es.object.assign');
require('core-js/modules/es.object.keys');
require('core-js/modules/es.symbol');
require('core-js/modules/es.symbol.async-iterator');
require('regenerator-runtime/runtime');const ExcelJS = require('exceljs/dist/es5');

對于 IE 11，您還需要一個 polyfill 以支持 unicode regex 模式。 例如，

const rewritePattern = require('regexpu-core');
const {generateRegexpuOptions} = require('@babel/helper-create-regexp-features-plugin/lib/util');const {RegExp} = global;
try {new RegExp('a', 'u');
} catch (err) {global.RegExp = function(pattern, flags) {if (flags && flags.includes('u')) {return new RegExp(rewritePattern(pattern, flags, generateRegexpuOptions({flags, pattern})));}return new RegExp(pattern, flags);};global.RegExp.prototype = RegExp.prototype;
}

ExcelJS 在 dist/ 文件夾內發布了兩個支持瀏覽器的包：

一個是隱式依賴 core-js polyfills 的…

<script src="https://cdnjs.cloudflare.com/ajax/libs/babel-polyfill/6.26.0/polyfill.js"></script>
<script src="exceljs.js"></script>

另一個則沒有…

<script src="--your-project's-pollyfills-here--"></script>
<script src="exceljs.bare.js"></script>

const workbook = new ExcelJS.Workbook();

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date(1985, 8, 30);
workbook.modified = new Date();
workbook.lastPrinted = new Date(2016, 9, 27);

// 將工作簿日期設置為 1904 年日期系統
workbook.properties.date1904 = true;

// 在加載時強制工作簿計算屬性
workbook.calcProperties.fullCalcOnLoad = true;

工作簿視圖控制在查看工作簿時 Excel 將打開多少個單獨的窗口。

workbook.views = [{x: 0, y: 0, width: 10000, height: 20000,firstSheet: 0, activeTab: 1, visibility: 'visible'}
]

const sheet = workbook.addWorksheet('My Sheet');

使用 addWorksheet 函數的第二個參數來指定工作表的選項。

示例：

// 創建帶有紅色標簽顏色的工作表
const sheet = workbook.addWorksheet('My Sheet', {properties:{tabColor:{argb:'FFC0000'}}});// 創建一個隱藏了網格線的工作表
const sheet = workbook.addWorksheet('My Sheet', {views: [{showGridLines: false}]});// 創建一個第一行和列凍結的工作表
const sheet = workbook.addWorksheet('My Sheet', {views:[{xSplit: 1, ySplit:1}]});// 使用A4設置的頁面設置設置創建新工作表 - 橫向
const worksheet =  workbook.addWorksheet('My Sheet', {pageSetup:{paperSize: 9, orientation:'landscape'}
});// 創建一個具有頁眉頁腳的工作表
const sheet = workbook.addWorksheet('My Sheet', {headerFooter:{firstHeader: "Hello Exceljs", firstFooter: "Hello World"}
});// 創建一個凍結了第一行和第一列的工作表
const sheet = workbook.addWorksheet('My Sheet', {views:[{state: 'frozen', xSplit: 1, ySplit:1}]});

使用工作表的 id 從工作簿中刪除工作表。

示例：

// 創建工作表
const sheet = workbook.addWorksheet('My Sheet');// 使用工作表 id 刪除工作表
workbook.removeWorksheet(sheet.id)

// 遍歷所有工作表
// 注意： workbook.worksheets.forEach 仍然是可以正常運行的， 但是以下的方式更好
workbook.eachSheet(function(worksheet, sheetId) {// ...
});// 按 name 提取工作表
const worksheet = workbook.getWorksheet('My Sheet');// 按 id 提取工作表
const worksheet = workbook.getWorksheet(1);

// 使工作表可見
worksheet.state = 'visible';// 隱藏工作表
worksheet.state = 'hidden';// 從“隱藏/取消隱藏”對話框中隱藏工作表
worksheet.state = 'veryHidden';

工作表支持屬性存儲，以允許控制工作表的某些功能。

// 創建具有屬性的新工作表
const worksheet = workbook.addWorksheet('sheet', {properties:{tabColor:{argb:'FF00FF00'}}});// 創建一個具有屬性的可寫的新工作表
const worksheetWriter = workbookWriter.addWorksheet('sheet', {properties:{outlineLevelCol:1}});// 之后調整屬性（工作表讀寫器不支持該操作）
worksheet.properties.outlineLevelCol = 2;
worksheet.properties.defaultRowHeight = 15;

支持的屬性

一些新的尺寸屬性已添加到工作表中…

所有可能影響工作表打印的屬性都保存在工作表上的 pageSetup 對象中。

// 使用 A4 橫向的頁面設置創建新工作表
const worksheet =  workbook.addWorksheet('sheet', {pageSetup:{paperSize: 9, orientation:'landscape'}
});// 使用適合頁面的pageSetup設置創建一個新的工作表編寫器
const worksheetWriter = workbookWriter.addWorksheet('sheet', {pageSetup:{fitToPage: true, fitToHeight: 5, fitToWidth: 7}
});// 之后調整頁面設置配置
worksheet.pageSetup.margins = {left: 0.7, right: 0.7,top: 0.75, bottom: 0.75,header: 0.3, footer: 0.3
};// 設置工作表的打印區域
worksheet.pageSetup.printArea = 'A1:G20';// 通過使用 `&&` 分隔打印區域來設置多個打印區域
worksheet.pageSetup.printArea = 'A1:G10&&A11:G20';// 在每個打印頁面上重復特定的行
worksheet.pageSetup.printTitlesRow = '1:3';// 在每個打印頁面上重復特定列
worksheet.pageSetup.printTitlesColumn = 'A:C';

支持的頁面設置配置項

示例紙張尺寸

這是添加頁眉和頁腳的方法。
添加的內容主要是文本，例如時間，簡介，文件信息等，您可以設置文本的樣式。
此外，您可以為首頁和偶數頁設置不同的文本。

注意：目前不支持圖片。

// 創建一個帶有頁眉和頁腳的工作表
var sheet = workbook.addWorksheet('My Sheet', {headerFooter:{firstHeader: "Hello Exceljs", firstFooter: "Hello World"}
});// 創建一個帶有頁眉和頁腳可寫的工作表
var worksheetWriter = workbookWriter.addWorksheet('sheet', {headerFooter:{firstHeader: "Hello Exceljs", firstFooter: "Hello World"}
});
// 代碼中出現的&開頭字符對應變量，相關信息可查閱下文的變量表
// 設置頁腳(默認居中),結果：“第 2 頁，共 16 頁”
worksheet.headerFooter.oddFooter = "第 &P 頁，共 &N 頁";// 將頁腳（默認居中）設置為粗體，結果是：“第2頁，共16頁”
worksheet.headerFooter.oddFooter = "Page &P of &N";// 將左頁腳設置為 18px 并以斜體顯示。 結果：“第2頁，共16頁”
worksheet.headerFooter.oddFooter = "&LPage &P of &N";// 將中間標題設置為灰色Aril，結果為：“ 52 exceljs”
worksheet.headerFooter.oddHeader = "&C&KCCCCCC&\"Aril\"52 exceljs";// 設置頁腳的左，中和右文本。 結果：頁腳左側為“ Exceljs”。 頁腳中心的“ demo.xlsx”。 頁腳右側的“第2頁”
worksheet.headerFooter.oddFooter = "&Lexceljs&C&F&RPage &P";// 在首頁添加不同的頁眉和頁腳
worksheet.headerFooter.differentFirst = true;
worksheet.headerFooter.firstHeader = "Hello Exceljs";
worksheet.headerFooter.firstFooter = "Hello World"

支持的 headerFooter 設置

腳本命令

現在，工作表支持視圖列表，這些視圖控制Excel如何顯示工作表：

• frozen - 頂部和左側的許多行和列被凍結在適當的位置。 僅右下部分會滾動
• split - 該視圖分為4個部分，每個部分可半獨立滾動。

每個視圖還支持各種屬性：

凍結視圖支持以下額外屬性：

worksheet.views = [{state: 'frozen', xSplit: 2, ySplit: 3, topLeftCell: 'G10', activeCell: 'A1'}
];

拆分視圖支持以下額外屬性：

worksheet.views = [{state: 'split', xSplit: 2000, ySplit: 3000, topLeftCell: 'G10', activeCell: 'A1'}
];

可以對工作表應用自動篩選器。

worksheet.autoFilter = 'A1:C1';

盡管范圍字符串是 autoFilter 的標準形式，但工作表還將支持以下值：

// 將自動篩選器設置為從 A1 到 C1
worksheet.autoFilter = {from: 'A1',to: 'C1',
}// 將自動篩選器設置為從第3行第1列的單元格到第5行第12列的單元格
worksheet.autoFilter = {from: {row: 3,column: 1},to: {row: 5,column: 12}
}// 將自動篩選器設置為從D3到第7行第5列中的單元格
worksheet.autoFilter = {from: 'D3',to: {row: 7,column: 5}
}

// 添加列標題并定義列鍵和寬度
// 注意：這些列結構僅是構建工作簿的方便之處，除了列寬之外，它們不會完全保留。
worksheet.columns = [{ header: 'Id', key: 'id', width: 10 },{ header: 'Name', key: 'name', width: 32 },{ header: 'D.O.B.', key: 'DOB', width: 10, outlineLevel: 1 }
];// 通過鍵，字母和基于1的列號訪問單個列
const idCol = worksheet.getColumn('id');
const nameCol = worksheet.getColumn('B');
const dobCol = worksheet.getColumn(3);// 設置列屬性// 注意：將覆蓋 C1 單元格值
dobCol.header = 'Date of Birth';// 注意：這將覆蓋 C1:C2 單元格值
dobCol.header = ['Date of Birth', 'A.K.A. D.O.B.'];// 從現在開始，此列將以 “dob” 而不是 “DOB” 建立索引
dobCol.key = 'dob';dobCol.width = 15;// 如果需要，隱藏列
dobCol.hidden = true;// 為列設置大綱級別
worksheet.getColumn(4).outlineLevel = 0;
worksheet.getColumn(5).outlineLevel = 1;// 列支持一個只讀字段，以指示基于 `OutlineLevel` 的折疊狀態
expect(worksheet.getColumn(4).collapsed).to.equal(false);
expect(worksheet.getColumn(5).collapsed).to.equal(true);// 遍歷此列中的所有當前單元格
dobCol.eachCell(function(cell, rowNumber) {// ...
});// 遍歷此列中的所有當前單元格，包括空單元格
dobCol.eachCell({ includeEmpty: true }, function(cell, rowNumber) {// ...
});// 添加一列新值
worksheet.getColumn(6).values = [1,2,3,4,5];// 添加稀疏列值
worksheet.getColumn(7).values = [,,2,3,,5,,7,,,,11];// 剪切一列或多列（右邊的列向左移動）
// 如果定義了列屬性，則會相應地對其進行切割或移動
// 已知問題：如果拼接導致任何合并的單元格移動，結果可能是不可預測的
worksheet.spliceColumns(3,2);// 刪除一列，再插入兩列。
// 注意：第4列及以上的列將右移1列。
// 另外：如果工作表中的行數多于列插入項中的值，則行將仍然被插入，就好像值存在一樣。
const newCol3Values = [1,2,3,4,5];
const newCol4Values = ['one', 'two', 'three', 'four', 'five'];
worksheet.spliceColumns(3, 1, newCol3Values, newCol4Values);

// 獲取一個行對象。如果尚不存在，則將返回一個新的空對象
const row = worksheet.getRow(5);// Get multiple row objects. If it doesn't already exist, new empty ones will be returned
const rows = worksheet.getRows(5, 2); // start, length (>0, else undefined is returned)// 獲取工作表中的最后一個可編輯行（如果沒有，則為 `undefined`）
const row = worksheet.lastRow;// 設置特定的行高
row.height = 42.5;// 隱藏行
row.hidden = true;// 為行設置大綱級別
worksheet.getRow(4).outlineLevel = 0;
worksheet.getRow(5).outlineLevel = 1;// 行支持一個只讀字段，以指示基于 `OutlineLevel` 的折疊狀態
expect(worksheet.getRow(4).collapsed).to.equal(false);
expect(worksheet.getRow(5).collapsed).to.equal(true);row.getCell(1).value = 5; // A5 的值設置為5
row.getCell('name').value = 'Zeb'; // B5 的值設置為 “Zeb” - 假設第2列仍按名稱鍵入
row.getCell('C').value = new Date(); // C5 的值設置為當前時間// 獲取行并作為稀疏數組返回
// 注意：接口更改：worksheet.getRow(4) ==> worksheet.getRow(4).values
row = worksheet.getRow(4).values;
expect(row[5]).toEqual('Kyle');// 通過連續數組分配行值（其中數組元素 0 具有值）
row.values = [1,2,3];
expect(row.getCell(1).value).toEqual(1);
expect(row.getCell(2).value).toEqual(2);
expect(row.getCell(3).value).toEqual(3);// 通過稀疏數組分配行值（其中數組元素 0 為 `undefined`）
const values = []
values[5] = 7;
values[10] = 'Hello, World!';
row.values = values;
expect(row.getCell(1).value).toBeNull();
expect(row.getCell(5).value).toEqual(7);
expect(row.getCell(10).value).toEqual('Hello, World!');// 使用列鍵按對象分配行值
row.values = {id: 13,name: 'Thing 1',dob: new Date()
};// 在該行下方插入一個分頁符
row.addPageBreak();// 遍歷工作表中具有值的所有行
worksheet.eachRow(function(row, rowNumber) {console.log('Row ' + rowNumber + ' = ' + JSON.stringify(row.values));
});// 遍歷工作表中的所有行（包括空行）
worksheet.eachRow({ includeEmpty: true }, function(row, rowNumber) {console.log('Row ' + rowNumber + ' = ' + JSON.stringify(row.values));
});// 連續遍歷所有非空單元格
row.eachCell(function(cell, colNumber) {console.log('Cell ' + colNumber + ' = ' + cell.value);
});// 遍歷一行中的所有單元格（包括空單元格）
row.eachCell({ includeEmpty: true }, function(cell, colNumber) {console.log('Cell ' + colNumber + ' = ' + cell.value);
});// 提交給流一個完成的行
row.commit();// 行尺寸
const rowSize = row.cellCount;
const numValues = row.actualCellCount;

// Add a couple of Rows by key-value, after the last current row, using the column keys
worksheet.addRow({id: 1, name: 'John Doe', dob: new Date(1970,1,1)});
worksheet.addRow({id: 2, name: 'Jane Doe', dob: new Date(1965,1,7)});// Add a row by contiguous Array (assign to columns A, B & C)
worksheet.addRow([3, 'Sam', new Date()]);// Add a row by sparse Array (assign to columns A, E & I)
const rowValues = [];
rowValues[1] = 4;
rowValues[5] = 'Kyle';
rowValues[9] = new Date();
worksheet.addRow(rowValues);// Add a row with inherited style
// This new row will have same style as last row
// And return as row object
const newRow = worksheet.addRow(rowValues, 'i');// Add an array of rows
const rows = [[5,'Bob',new Date()], // row by array{id:6, name: 'Barbara', dob: new Date()}
];
// add new rows and return them as array of row objects
const newRows = worksheet.addRows(rows);// Add an array of rows with inherited style
// These new rows will have same styles as last row
// and return them as array of row objects
const newRowsStyled = worksheet.addRows(rows, 'i');

const cell = worksheet.getCell('C3');// 修改/添加單個單元格
cell.value = new Date(1968, 5, 1);// 查詢單元格的類型
expect(cell.type).toEqual(Excel.ValueType.Date);// 使用單元格的字符串值
myInput.value = cell.text;// 使用 html 安全的字符串進行渲染...
const html = '<div>' + cell.html + '</div>';

// 合并一系列單元格
worksheet.mergeCells('A4:B5');// ...合并的單元格被鏈接起來了
worksheet.getCell('B5').value = 'Hello, World!';
expect(worksheet.getCell('B5').value).toBe(worksheet.getCell('A4').value);
expect(worksheet.getCell('B5').master).toBe(worksheet.getCell('A4'));// ...合并的單元格共享相同的樣式對象
expect(worksheet.getCell('B5').style).toBe(worksheet.getCell('A4').style);
worksheet.getCell('B5').style.font = myFonts.arial;
expect(worksheet.getCell('A4').style.font).toBe(myFonts.arial);// 取消單元格合并將打破鏈接的樣式
worksheet.unMergeCells('A4');
expect(worksheet.getCell('B5').style).not.toBe(worksheet.getCell('A4').style);
expect(worksheet.getCell('B5').style.font).not.toBe(myFonts.arial);// 按左上，右下合并
worksheet.mergeCells('K10', 'M12');// 按開始行，開始列，結束行，結束列合并（相當于 K10:M12）
worksheet.mergeCells(10,11,12,13);

insertRow(pos, value, style = 'n')
insertRows(pos, values, style = 'n')// Insert a couple of Rows by key-value, shifting down rows every time
worksheet.insertRow(1, {id: 1, name: 'John Doe', dob: new Date(1970,1,1)});
worksheet.insertRow(1, {id: 2, name: 'Jane Doe', dob: new Date(1965,1,7)});// Insert a row by contiguous Array (assign to columns A, B & C)
worksheet.insertRow(1, [3, 'Sam', new Date()]);// Insert a row by sparse Array (assign to columns A, E & I)
var rowValues = [];
rowValues[1] = 4;
rowValues[5] = 'Kyle';
rowValues[9] = new Date();
// insert new row and return as row object
const insertedRow = worksheet.insertRow(1, rowValues);// Insert a row, with inherited style
// This new row will have same style as row on top of it
// And return as row object
const insertedRowInherited = worksheet.insertRow(1, rowValues, 'i');// Insert a row, keeping original style
// This new row will have same style as it was previously
// And return as row object
const insertedRowOriginal = worksheet.insertRow(1, rowValues, 'o');// Insert an array of rows, in position 1, shifting down current position 1 and later rows by 2 rows
var rows = [[5,'Bob',new Date()], // row by array{id:6, name: 'Barbara', dob: new Date()}
];
// insert new rows and return them as array of row objects
const insertedRows = worksheet.insertRows(1, rows);// Insert an array of rows, with inherited style
// These new rows will have same style as row on top of it
// And return them as array of row objects
const insertedRowsInherited = worksheet.insertRows(1, rows, 'i');// Insert an array of rows, keeping original style
// These new rows will have same style as it was previously in 'pos' position
const insertedRowsOriginal = worksheet.insertRows(1, rows, 'o');

// Cut one or more rows (rows below are shifted up)
// Known Issue: If a splice causes any merged cells to move, the results may be unpredictable
worksheet.spliceRows(4, 3);// remove one row and insert two more.
// Note: rows 4 and below will be shifted down by 1 row.
const newRow3Values = [1, 2, 3, 4, 5];
const newRow4Values = ['one', 'two', 'three', 'four', 'five'];
worksheet.spliceRows(3, 1, newRow3Values, newRow4Values);// Cut one or more cells (cells to the right are shifted left)
// Note: this operation will not affect other rows
row.splice(3, 2);// remove one cell and insert two more (cells to the right of the cut cell will be shifted right)
row.splice(4, 1, 'new value 1', 'new value 2');

duplicateRow(start, amount = 1, insert = true)const wb = new ExcelJS.Workbook();
const ws = wb.addWorksheet('duplicateTest');
ws.getCell('A1').value = 'One';
ws.getCell('A2').value = 'Two';
ws.getCell('A3').value = 'Three';
ws.getCell('A4').value = 'Four';// 該行將重復復制第一行兩次，但將替換第二行和第三行
// 如果第三個參數為 true，則它將插入2個新行，其中包含行 “One” 的值和樣式
ws.duplicateRow(1,2,false);

單個單元格（或多個單元格組）可以為它們分配名稱。名稱可用于公式和數據驗證（可能還有更多）。

// 為單元格分配（或獲取）名稱（將覆蓋該單元具有的其他任何名稱）
worksheet.getCell('A1').name = 'PI';
expect(worksheet.getCell('A1').name).to.equal('PI');// 為單元格分配（或獲取）一組名稱（單元可以具有多個名稱）
worksheet.getCell('A1').names = ['thing1', 'thing2'];
expect(worksheet.getCell('A1').names).to.have.members(['thing1', 'thing2']);// 從單元格中刪除名稱
worksheet.getCell('A1').removeName('thing1');
expect(worksheet.getCell('A1').names).to.have.members(['thing2']);

單元格可以定義哪些值有效或無效，并提示用戶以幫助指導它們。

驗證類型可以是以下之一：

對于 list 或 custom 以外的其他類型，以下運算符會影響驗證：

// 指定有效值的列表（One，Two，Three，Four）。
// Excel 將提供一個包含這些值的下拉列表。
worksheet.getCell('A1').dataValidation = {type: 'list',allowBlank: true,formulae: ['"One,Two,Three,Four"']
};// 指定范圍內的有效值列表。
// Excel 將提供一個包含這些值的下拉列表。
worksheet.getCell('A1').dataValidation = {type: 'list',allowBlank: true,formulae: ['$D$5:$F$5']
};// 指定單元格必須為非5的整數。
// 向用戶顯示適當的錯誤消息（如果他們弄錯了）
worksheet.getCell('A1').dataValidation = {type: 'whole',operator: 'notEqual',showErrorMessage: true,formulae: [5],errorStyle: 'error',errorTitle: 'Five',error: 'The value must not be Five'
};// 指定單元格必須為1.5到7之間的十進制數字。
// 添加“工具提示”以幫助指導用戶
worksheet.getCell('A1').dataValidation = {type: 'decimal',operator: 'between',allowBlank: true,showInputMessage: true,formulae: [1.5, 7],promptTitle: 'Decimal',prompt: 'The value must between 1.5 and 7'
};// 指定單元格的文本長度必須小于15
worksheet.getCell('A1').dataValidation = {type: 'textLength',operator: 'lessThan',showErrorMessage: true,allowBlank: true,formulae: [15]
};// 指定單元格必須是2016年1月1日之前的日期
worksheet.getCell('A1').dataValidation = {type: 'date',operator: 'lessThan',showErrorMessage: true,allowBlank: true,formulae: [new Date(2016,0,1)]
};

將舊樣式的注釋添加到單元格

// 純文字筆記
worksheet.getCell('A1').note = 'Hello, ExcelJS!';// 彩色格式化的筆記
ws.getCell('B1').note = {texts: [{'font': {'size': 12, 'color': {'theme': 0}, 'name': 'Calibri', 'family': 2, 'scheme': 'minor'}, 'text': 'This is '},{'font': {'italic': true, 'size': 12, 'color': {'theme': 0}, 'name': 'Calibri', 'scheme': 'minor'}, 'text': 'a'},{'font': {'size': 12, 'color': {'theme': 1}, 'name': 'Calibri', 'family': 2, 'scheme': 'minor'}, 'text': ' '},{'font': {'size': 12, 'color': {'argb': 'FFFF6600'}, 'name': 'Calibri', 'scheme': 'minor'}, 'text': 'colorful'},{'font': {'size': 12, 'color': {'theme': 1}, 'name': 'Calibri', 'family': 2, 'scheme': 'minor'}, 'text': ' text '},{'font': {'size': 12, 'color': {'argb': 'FFCCFFCC'}, 'name': 'Calibri', 'scheme': 'minor'}, 'text': 'with'},{'font': {'size': 12, 'color': {'theme': 1}, 'name': 'Calibri', 'family': 2, 'scheme': 'minor'}, 'text': ' in-cell '},{'font': {'bold': true, 'size': 12, 'color': {'theme': 1}, 'name': 'Calibri', 'family': 2, 'scheme': 'minor'}, 'text': 'format'},],margins: {insetmode: 'custom',inset: [0.25, 0.25, 0.35, 0.35]},protection: {locked: True,lockText: False},editAs: 'twoCells'
};

下表定義了單元格注釋已支持的屬性。

確定單元格批注的頁面距設置模式，自動或者自定義模式。

ws.getCell('B1').note.margins = {insetmode: 'custom',inset: [0.25, 0.25, 0.35, 0.35]
}

注意：只有當 insetmode的值設置為’custom’時，inset的設置才生效。

可以使用保護屬性來修改單元級別保護。

ws.getCell('B1').note.protection = {locked: 'False',lockText: 'False',
};

單元格注釋還可以具有屬性 ‘editAs’，該屬性將控制注釋如何錨定到單元格。
它可以具有以下值之一：

ws.getCell('B1').note.editAs = 'twoCells'

表允許表格內數據的表內操作。

要將表添加到工作表，請定義表模型并調用 addTable：

// 將表格添加到工作表
ws.addTable({name: 'MyTable',ref: 'A1',headerRow: true,totalsRow: true,style: {theme: 'TableStyleDark3',showRowStripes: true,},columns: [{name: 'Date', totalsRowLabel: 'Totals:', filterButton: true},{name: 'Amount', totalsRowFunction: 'sum', filterButton: false},],rows: [[new Date('2019-07-20'), 70.10],[new Date('2019-07-21'), 70.60],[new Date('2019-07-22'), 70.10],],
});

注意：將表格添加到工作表將通過放置表格的標題和行數據來修改工作表。
結果就是表格覆蓋的工作表上的所有數據（包括標題和所有的）都將被覆蓋。

下表定義了表格支持的屬性。

下表定義了表格中支持的屬性樣式屬性。

下表定義了每個表格列中支持的屬性。

下表列出了由列定義的 totalsRowFunction 屬性的有效值。如果使用 'custom' 以外的任何值，則無需包括關聯的公式，因為該公式將被表格插入。

有效的主題名稱遵循以下模式：

• “TableStyle[Shade][Number]”

Shades（陰影），Number（數字）可以是以下之一：

• Light, 1-21
• Medium, 1-28
• Dark, 1-11

對于無主題，請使用值 null。

注意：exceljs 尚不支持自定義表格主題。

表格支持一組操作函數，這些操作函數允許添加或刪除數據以及更改某些屬性。由于這些操作中的許多操作可能會對工作表產生副作用，因此更改必須在完成后立即提交。

表中的所有索引值均基于零，因此第一行號和第一列號為 0。

添加或刪除標題和統計

const table = ws.getTable('MyTable');// 打開標題行
table.headerRow = true;// 關閉統計行
table.totalsRow = false;// 將表更改提交到工作表中
table.commit();

重定位表

const table = ws.getTable('MyTable');// 表格左上移至 D4
table.ref = 'D4';// 將表更改提交到工作表中
table.commit();

添加和刪除行

const table = ws.getTable('MyTable');// 刪除前兩行
table.removeRows(0, 2);// 在索引 5 處插入新行
table.addRow([new Date('2019-08-05'), 5, 'Mid'], 5);// 在表格底部追加新行
table.addRow([new Date('2019-08-10'), 10, 'End']);// 將表更改提交到工作表中
table.commit();

添加和刪除列

const table = ws.getTable('MyTable');// 刪除第二列
table.removeColumns(1, 1);// 在索引 1 處插入新列（包含數據）
table.addColumn({name: 'Letter', totalsRowFunction: 'custom', totalsRowFormula: 'ROW()', totalsRowResult: 6, filterButton: true},['a', 'b', 'c', 'd'],2
);// 將表更改提交到工作表中
table.commit();

更改列屬性

const table = ws.getTable('MyTable');// 獲取第二列的列包裝器
const column = table.getColumn(1);// 設置一些屬性
column.name = 'Code';
column.filterButton = true;
column.style = {font:{bold: true, name: 'Comic Sans MS'}};
column.totalsRowLabel = 'Totals';
column.totalsRowFunction = 'custom';
column.totalsRowFormula = 'ROW()';
column.totalsRowResult = 10;// 將表更改提交到工作表中
table.commit();

單元格，行和列均支持一組豐富的樣式和格式，這些樣式和格式會影響單元格的顯示方式。

通過分配以下屬性來設置樣式：

• numFmt
• font
• alignment
• border
• fill

// 為單元格分配樣式
ws.getCell('A1').numFmt = '0.00%';// 將樣式應用于工作表列
ws.columns = [{ header: 'Id', key: 'id', width: 10 },{ header: 'Name', key: 'name', width: 32, style: { font: { name: 'Arial Black' } } },{ header: 'D.O.B.', key: 'DOB', width: 10, style: { numFmt: 'dd/mm/yyyy' } }
];// 將第3列設置為“貨幣格式”
ws.getColumn(3).numFmt = '"￡"#,##0.00;[Red]\-"￡"#,##0.00';// 將第2行設置為 Comic Sans。
ws.getRow(2).font = { name: 'Comic Sans MS', family: 4, size: 16, underline: 'double', bold: true };

將樣式應用于行或列時，它將應用于該行或列中所有當前存在的單元格。另外，創建的任何新單元格都將從其所屬的行和列繼承其初始樣式。

如果單元格的行和列都定義了特定的樣式（例如，字體），則該單元格所在行樣式比列樣式具有更高優先級。但是，如果行和列定義了不同的樣式（例如 column.numFmt 和 row.font），則單元格將繼承行的字體和列的 numFmt。

注意：以上所有屬性（numFmt（字符串）除外）都是 JS 對象結構。如果將同一樣式對象分配給多個電子表格實體，則每個實體將共享同一樣式對象。如果樣式對象后來在電子表格序列化之前被修改，則所有引用該樣式對象的實體也將被修改。此行為旨在通過減少創建的JS對象的數量來優先考慮性能。如果希望樣式對象是獨立的，則需要先對其進行克隆，然后再分配它們。同樣，默認情況下，如果電子表格實體共享相似的樣式，則從文件（或流）中讀取文檔時，它們也將引用相同的樣式對象。

// 將值顯示為“ 1 3/5”
ws.getCell('A1').value = 1.6;
ws.getCell('A1').numFmt = '# ?/?';// 顯示為“ 1.60％”
ws.getCell('B1').value = 0.016;
ws.getCell('B1').numFmt = '0.00%';

// 將單元格對齊方式設置為左上，中間居中，右下
ws.getCell('A1').alignment = { vertical: 'top', horizontal: 'left' };
ws.getCell('B1').alignment = { vertical: 'middle', horizontal: 'center' };
ws.getCell('C1').alignment = { vertical: 'bottom', horizontal: 'right' };// 將單元格設置為自動換行
ws.getCell('D1').alignment = { wrapText: true };// 將單元格縮進設置為1
ws.getCell('E1').alignment = { indent: 1 };// 將單元格文本旋轉設置為向上30deg，向下45deg和垂直文本
ws.getCell('F1').alignment = { textRotation: 30 };
ws.getCell('G1').alignment = { textRotation: -45 };
ws.getCell('H1').alignment = { textRotation: 'vertical' };

有效的對齊屬性值

// 在A1周圍設置單個細邊框
ws.getCell('A1').border = {top: {style:'thin'},left: {style:'thin'},bottom: {style:'thin'},right: {style:'thin'}
};// 在A3周圍設置雙細綠色邊框
ws.getCell('A3').border = {top: {style:'double', color: {argb:'FF00FF00'}},left: {style:'double', color: {argb:'FF00FF00'}},bottom: {style:'double', color: {argb:'FF00FF00'}},right: {style:'double', color: {argb:'FF00FF00'}}
};// 在A5中設置厚紅十字邊框
ws.getCell('A5').border = {diagonal: {up: true, down: true, style:'thick', color: {argb:'FFFF0000'}}
};

有效邊框樣式

• thin
• dotted
• dashDot
• hair
• dashDotDot
• slantDashDot
• mediumDashed
• mediumDashDotDot
• mediumDashDot
• medium
• double
• thick

// 用紅色深色垂直條紋填充A1
ws.getCell('A1').fill = {type: 'pattern',pattern:'darkVertical',fgColor:{argb:'FFFF0000'}
};// 在A2中填充深黃色格子和藍色背景
ws.getCell('A2').fill = {type: 'pattern',pattern:'darkTrellis',fgColor:{argb:'FFFFFF00'},bgColor:{argb:'FF0000FF'}
};// 從左到右用藍白藍漸變填充A3
ws.getCell('A3').fill = {type: 'gradient',gradient: 'angle',degree: 0,stops: [{position:0, color:{argb:'FF0000FF'}},{position:0.5, color:{argb:'FFFFFFFF'}},{position:1, color:{argb:'FF0000FF'}}]
};// 從中心開始用紅綠色漸變填充A4
ws.getCell('A4').fill = {type: 'gradient',gradient: 'path',center:{left:0.5,top:0.5},stops: [{position:0, color:{argb:'FFFF0000'}},{position:1, color:{argb:'FF00FF00'}}]
};

有效模式類型

• none
• solid
• darkGray
• mediumGray
• lightGray
• gray125
• gray0625
• darkHorizontal
• darkVertical
• darkDown
• darkUp
• darkGrid
• darkTrellis
• lightHorizontal
• lightVertical
• lightDown
• lightUp
• lightGrid
• lightTrellis

注意事項

使用上面的接口，可能會創建使用XLSX編輯器程序無法實現的漸變填充效果。例如，Excel 僅支持0、45、90 和 135 的角度梯度。類似地，stops 的順序也可能受到 UI 的限制，其中位置 [0,1] 或[0,0.5,1] 是唯一的選擇。請謹慎處理此填充，以確保目標 XLSX 查看器支持該填充。

現在，單個單元格支持RTF文本或單元格格式化。富文本值可以控制文本值內任意數量的子字符串的字體屬性。有關支持哪些字體屬性的詳細信息，請參見字體。

ws.getCell('A1').value = {'richText': [{'font': {'size': 12,'color': {'theme': 0},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': 'This is '},{'font': {'italic': true,'size': 12,'color': {'theme': 0},'name': 'Calibri','scheme': 'minor'},'text': 'a'},{'font': {'size': 12,'color': {'theme': 1},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': ' '},{'font': {'size': 12,'color': {'argb': 'FFFF6600'},'name': 'Calibri','scheme': 'minor'},'text': 'colorful'},{'font': {'size': 12,'color': {'theme': 1},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': ' text '},{'font': {'size': 12,'color': {'argb': 'FFCCFFCC'},'name': 'Calibri','scheme': 'minor'},'text': 'with'},{'font': {'size': 12,'color': {'theme': 1},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': ' in-cell '},{'font': {'bold': true,'size': 12,'color': {'theme': 1},'name': 'Calibri','family': 2,'scheme': 'minor'},'text': 'format'}]
};expect(ws.getCell('A1').text).to.equal('This is a colorful text with in-cell format');
expect(ws.getCell('A1').type).to.equal(Excel.ValueType.RichText);

可以使用保護屬性來修改單元級別保護。

ws.getCell('A1').protection = {locked: false,hidden: true,
};

支持的保護屬性

條件格式化允許工作表根據單元格值或任意公式顯示特定的樣式，圖標等。

條件格式設置規則是在工作表級別添加的，通常會覆蓋一系列單元格。

可以將多個規則應用于給定的單元格范圍，并且每個規則都將應用自己的樣式。

如果多個規則影響給定的單元格，則規則優先級值將確定如果競爭樣式沖突，則哪個規則勝出。優先級值較低的規則獲勝。如果沒有為給定規則指定優先級值，ExcelJS 將按升序分配它們。

注意：目前，僅支持條件格式設置規則的子集。具體來說，只有格式規則不需要 <extLst&gt 元素內的 XML 呈現。這意味著不支持數據集和三個特定的圖標集（3Triangles，3Stars，5Boxes）。

// 根據行和列為偶數或奇數向 A1:E7 添加一個棋盤圖案
worksheet.addConditionalFormatting({ref: 'A1:E7',rules: [{type: 'expression',formulae: ['MOD(ROW()+COLUMN(),2)=0'],style: {fill: {type: 'pattern', pattern: 'solid', bgColor: {argb: 'FF00FF00'}}},}]
})

支持的條件格式設置規則類型

Cell Is 運算符

包含文本運算符

時間段

Excel 支持大綱；行或列可以根據用戶希望查看的詳細程度展開或折疊。

大綱級別可以在列設置中定義：

worksheet.columns = [{ header: 'Id', key: 'id', width: 10 },{ header: 'Name', key: 'name', width: 32 },{ header: 'D.O.B.', key: 'DOB', width: 10, outlineLevel: 1 }
];

或直接在行或列上

worksheet.getColumn(3).outlineLevel = 1;
worksheet.getRow(3).outlineLevel = 1;

工作表大綱級別可以在工作表上設置

// 設置列大綱級別
worksheet.properties.outlineLevelCol = 1;// 設置行大綱級別
worksheet.properties.outlineLevelRow = 1;

注意：調整行或列上的大綱級別或工作表上的大綱級別將產生副作用，即還修改受屬性更改影響的所有行或列的折疊屬性。 例如。：

worksheet.properties.outlineLevelCol = 1;worksheet.getColumn(3).outlineLevel = 1;
expect(worksheet.getColumn(3).collapsed).to.be.true;worksheet.properties.outlineLevelCol = 2;
expect(worksheet.getColumn(3).collapsed).to.be.false;

大綱屬性可以在工作表上設置

worksheet.properties.outlineProperties = {summaryBelow: false,summaryRight: false,
};

將圖像添加到工作表是一個分為兩個步驟的過程。首先，通過 addImage() 函數將圖像添加到工作簿中，該函數還將返回 imageId 值。然后，使用 imageId，可以將圖像作為平鋪背景或覆蓋單元格區域添加到工作表中。

注意：從此版本開始，不支持調整或變換圖像。

Workbook.addImage 函數支持按文件名或按 Buffer 添加圖像。請注意，在兩種情況下，都必須指定擴展名。有效的擴展名包括 “jpeg”，“png”，“gif”。

// 通過文件名將圖像添加到工作簿
const imageId1 = workbook.addImage({filename: 'path/to/image.jpg',extension: 'jpeg',
});// 通過 buffer 將圖像添加到工作簿
const imageId2 = workbook.addImage({buffer: fs.readFileSync('path/to.image.png'),extension: 'png',
});// 通過 base64  將圖像添加到工作簿
const myBase64Image = "data:image/png;base64,iVBORw0KG...";
const imageId2 = workbook.addImage({base64: myBase64Image,extension: 'png',
});

使用 Workbook.addImage 中的圖像 ID，可以使用 addBackgroundImage 函數設置工作表的背景

// 設置背景
worksheet.addBackgroundImage(imageId1);

使用 Workbook.addImage 中的圖像 ID，可以將圖像嵌入工作表中以覆蓋一定范圍。從該范圍計算出的坐標將覆蓋從第一個單元格的左上角到第二個單元格的右下角。

// 在 B2:D6 上插入圖片
worksheet.addImage(imageId2, 'B2:D6');

使用結構而不是范圍字符串，可以部分覆蓋單元格。

請注意，為此使用的坐標系基于零，因此 A1 的左上角將為 {col：0，row：0}。單元格的分數可以通過使用浮點數來指定，例如 A1 的中點是 {col：0.5，row：0.5}。

// 在 B2:D6 的一部分上插入圖像
worksheet.addImage(imageId2, {tl: { col: 1.5, row: 1.5 },br: { col: 3.5, row: 5.5 }
});

單元格區域還可以具有屬性 "editAs"，該屬性將控制將圖像錨定到單元格的方式。它可以具有以下值之一：

ws.addImage(imageId, {tl: { col: 0.1125, row: 0.4 },br: { col: 2.101046875, row: 3.4 },editAs: 'oneCell'
});

您可以將圖像添加到單元格，然后以 96dpi 定義其寬度和高度（以像素為單位）。

worksheet.addImage(imageId2, {tl: { col: 0, row: 0 },ext: { width: 500, height: 200 }
});

您可以將帶有超鏈接的圖像添加到單元格，并在圖像范圍內定義超鏈接。

worksheet.addImage(imageId2, {tl: { col: 0, row: 0 },ext: { width: 500, height: 200 },hyperlinks: {hyperlink: 'http://www.somewhere.com',tooltip: 'http://www.somewhere.com'}
});

可以通過添加密碼來保護工作表免受修改。

await worksheet.protect('the-password', options);

工作表保護也可以刪除：

worksheet.unprotect();

有關如何修改單個單元格保護的詳細信息請查看 單元格保護。

注意： 當 protect() 函數返回一個 Promise 代表它是異步的，當前的實現在主線程上運行，并且在 CPU 上將使用平均大約 600 毫秒。可以通過設置 spinCount 進行調整，該值可用于使過程更快或更有彈性。

// 從文件讀取
const workbook = new Excel.Workbook();
await workbook.xlsx.readFile(filename);
// ... 使用 workbook// 從流讀取
const workbook = new Excel.Workbook();
await workbook.xlsx.read(stream);
// ... 使用 workbook// 從 buffer 加載
const workbook = new Excel.Workbook();
await workbook.xlsx.load(data);
// ... 使用 workbook

讀取 CSV 文件時支持的選項。

// 從文件讀取
const workbook = new Excel.Workbook();
const worksheet = await workbook.csv.readFile(filename);
// ... 使用 workbook 或 worksheet// 從流中讀取
const workbook = new Excel.Workbook();
const worksheet = await workbook.csv.read(stream);
// ... 使用 workbook 或 worksheet// 從帶有歐洲日期的文件中讀取
const workbook = new Excel.Workbook();
const options = {dateFormats: ['DD/MM/YYYY']
};
const worksheet = await workbook.csv.readFile(filename, options);
// ... 使用 workbook 或 worksheet// 從具有自定義值解析的文件中讀取
const workbook = new Excel.Workbook();
const options = {map(value, index) {switch(index) {case 0:// 第1列是字符串return value;case 1:// 第2列是日期return new Date(value);case 2:// 第3列是公式值的JSONreturn JSON.parse(value);default:// 其余的是數字return parseFloat(value);}},// https://c2fo.github.io/fast-csv/docs/parsing/optionsparserOptions: {delimiter: '\t',quote: false,},
};
const worksheet = await workbook.csv.readFile(filename, options);
// ... 使用 workbook 或 worksheet

CSV 解析器使用 fast-csv 讀取CSV文件。傳遞給上述寫入函數的選項中的 formatterOptions 將傳遞給 @fast-csv/format 模塊以寫入 csv 數據。 有關詳細信息，請參閱 fast-csv README.md。

使用 npm 模塊 dayjs 解析日期。如果未提供 dateFormats 數組，則使用以下 dateFormats：

• ‘YYYY-MM-DD[T]HH:mm:ss’
• ‘MM-DD-YYYY’
• ‘YYYY-MM-DD’

請參閱 dayjs CustomParseFormat 插件，以獲取有關如何構造 dateFormat 的詳細信息。

寫入 CSV 文件時支持的選項。

// 寫入文件
const workbook = createAndFillWorkbook();
await workbook.csv.writeFile(filename);// 寫入流
// 請注意，您需要提供 sheetName 或 sheetId 以正確導入到 csv
await workbook.csv.write(stream, { sheetName: 'Page name' });// 使用歐洲日期時間寫入文件
const workbook = new Excel.Workbook();
const options = {dateFormat: 'DD/MM/YYYY HH:mm:ss',dateUTC: true, // 呈現日期時使用 utc
};
await workbook.csv.writeFile(filename, options);// 使用自定義值格式寫入文件
const workbook = new Excel.Workbook();
const options = {map(value, index) {switch(index) {case 0:// 第1列是字符串return value;case 1:// 第2列是日期return dayjs(value).format('YYYY-MM-DD');case 2:// 第3列是一個公式，只寫結果return value.result;default:// 其余的是數字return value;}},// https://c2fo.github.io/fast-csv/docs/formatting/optionsformatterOptions: {delimiter: '\t',quote: false,},
};
await workbook.csv.writeFile(filename, options);// 寫入新 buffer
const buffer = await workbook.csv.writeBuffer();

CSV 解析器使用 fast-csv 編寫 CSV 文件。傳遞給上述寫入函數的選項中的 formatterOptions 將傳遞給 @fast-csv/format 模塊以寫入 csv 數據。有關詳細信息，請參閱 fast-csv README.md。

日期使用 npm 模塊 dayjs 格式化。如果未提供 dateFormat，則使用 dayjs.ISO_8601。編寫 CSV 時，您可以提供布爾值 dateUTC 為 true，以使 ExcelJS 解析日期，而無需使用 dayjs.utc() 自動轉換時區。

上面記錄的文件 I/O 需要在內存中建立整個工作簿，然后才能寫入文件。雖然方便，但是由于所需的內存量，它可能會限制文檔的大小。

流寫入器（或讀取器）在生成工作簿或工作表數據時對其進行處理，然后將其轉換為文件形式。通常，這在內存上效率要高得多，因為最終的內存占用量，甚至中間的內存占用量都比文檔版本要緊湊得多，尤其是當您考慮到行和單元格對象一旦提交就被銷毀時，尤其如此。

流式工作簿和工作表的接口幾乎與文檔版本相同，但實際存在一些細微差別：

• 將工作表添加到工作簿后，將無法將其刪除。
• 提交行后，將無法再訪問該行，因為該行將從工作表中刪除。
• 不支持 unMergeCells()。

請注意，可以在不提交任何行的情況下構建整個工作簿。提交工作簿后，所有添加的工作表（包括所有未提交的行）將自動提交。但是，在這種情況下，與文檔版本相比收效甚微。

流式 XLSX 寫入器在 ExcelJS.stream.xlsx 命名空間中可用。

構造函數采用帶有以下字段的可選 options 對象：

如果在選項中未指定 stream 或 filename，則工作簿編寫器將創建一個 StreamBuf 對象，該對象將 XLSX 工作簿的內容存儲在內存中。可以通過屬性 workbook.stream 訪問此 StreamBuf 對象，該對象可用于通過 stream.read() 直接訪問字節，或將內容通過管道傳輸到另一個流。

// 使用樣式和共享字符串構造流式 XLSX 工作簿編寫器
const options = {filename: './streamed-workbook.xlsx',useStyles: true,useSharedStrings: true
};
const workbook = new Excel.stream.xlsx.WorkbookWriter(options);

通常，流式 XLSX 寫入器的接口與上述文檔工作簿（和工作表）相同，實際上行，單元格和樣式對象是相同的。

但是有一些區別…

構造

如上所示，WorkbookWriter 通常將要求在構造函數中指定輸出流或文件。

提交數據

當工作表行準備就緒時，應將其提交，以便可以釋放行對象和內容。通常，這將在添加每一行時完成…

worksheet.addRow({id: i,name: theName,etc: someOtherDetail
}).commit();

WorksheetWriter 在添加行時不提交行的原因是允許單元格跨行合并：

worksheet.mergeCells('A1:B2');
worksheet.getCell('A1').value = 'I am merged';
worksheet.getCell('C1').value = 'I am not';
worksheet.getCell('C2').value = 'Neither am I';
worksheet.getRow(2).commit(); // now rows 1 and two are committed.

每個工作表完成后，還必須提交：

// 完成添加數據。 提交工作表
worksheet.commit();

要完成 XLSX 文檔，必須提交工作簿。 如果未提交工作簿中的任何工作表，則將在工作簿提交中自動提交它們。

// 完成 workbook.
await workbook.commit();
// ... 流已被寫入

流式 XLSX 工作簿閱讀器可以在ExcelJS.stream.xlsx命名空間中找到。

構造函數包含必需的輸入參數和可選的options參數:

const workbook = new ExcelJS.stream.xlsx.WorkbookReader('./file.xlsx');
for await (const worksheetReader of workbookReader) {for await (const row of worksheetReader) {// ...}
}

請注意，由于性能原因，worksheetReader返回一個行數組，而不是單獨返回每一行: https://github.com/nodejs/node/issues/31979

工作簿上的事件是 ‘worksheet’、‘shared-strings’ 和 ‘hyperlinks’。 工作表上的事件是 ‘row’ 和 ‘hyperlinks’.

const options = {sharedStrings: 'emit',hyperlinks: 'emit',worksheets: 'emit',
};
const workbook = new ExcelJS.stream.xlsx.WorkbookReader('./file.xlsx', options);
for await (const {eventType, value} of workbook.parse()) {switch (eventType) {case 'shared-strings':// 值是共享字符串case 'worksheet':// 值是worksheetReadercase 'hyperlinks':// 值是hyperlinksReader}
}

我們強烈建議使用異步迭代，但我們也公開了流接口以實現向后兼容性。

const options = {sharedStrings: 'emit',hyperlinks: 'emit',worksheets: 'emit',
};
const workbookReader = new ExcelJS.stream.xlsx.WorkbookReader('./file.xlsx', options);
workbookReader.read();workbookReader.on('worksheet', worksheet => {worksheet.on('row', row => {});
});workbookReader.on('shared-strings', sharedString => {// ...
});workbookReader.on('hyperlinks', hyperlinksReader => {// ...
});workbookReader.on('end', () => {// ...
});
workbookReader.on('error', (err) => {// ...
});

該庫的一部分已被隔離，并經過測試可在瀏覽器環境中使用。

由于工作簿讀寫器的流式傳輸性質，因此未包括這些內容。只能使用基于文檔的工作簿（有關詳細信息，請參見 創建工作簿）。

例如，在瀏覽器中使用 ExcelJS 的代碼可查看 github 中的 spec / browser 文件夾。

以下文件已預先捆綁在一起，并包含在 dist 文件夾中。

• exceljs.js
• exceljs.min.js

支持以下值類型。

Enum: Excel.ValueType.Null

空值表示沒有值，通常在寫入文件時將不存儲（合并的單元格除外）。可用于從單元格中刪除該值。例如：

worksheet.getCell('A1').value = null;

Enum: Excel.ValueType.Merge

合并單元格是其值綁定到另一個“主”單元格的單元格。分配給合并單元將導致修改單元格。

Enum: Excel.ValueType.Number

一個數字值。

例如：

worksheet.getCell('A1').value = 5;
worksheet.getCell('A2').value = 3.14159;

Enum: Excel.ValueType.String

一個簡單的文本字符串。

例如：

worksheet.getCell('A1').value = 'Hello, World!';

Enum: Excel.ValueType.Date

日期值，由 JavaScript Date 類型表示。

例如：

worksheet.getCell('A1').value = new Date(2017, 2, 15);

Enum: Excel.ValueType.Hyperlink

具有文本和鏈接值的 URL。

例如：

// 鏈接到網絡
worksheet.getCell('A1').value = {text: 'www.mylink.com',hyperlink: 'http://www.mylink.com',tooltip: 'www.mylink.com'
};// 內部鏈接
worksheet.getCell('A1').value = { text: 'Sheet2', hyperlink: '#\'Sheet2\'!A1' };

Enum: Excel.ValueType.Formula

一個 Excel 公式，用于即時計算值。請注意，雖然單元格類型將為“公式”，但該單元格可能具有一個有效類型值，該值將從結果值中得出。

請注意，ExcelJS 無法處理公式以生成結果，必須提供該公式。

例如：

worksheet.getCell('A3').value = { formula: 'A1+A2', result: 7 };

單元格還支持便捷的獲取器，以訪問公式和結果：

worksheet.getCell('A3').formula === 'A1+A2';
worksheet.getCell('A3').result === 7;