+ )
+}
+```
+
+:::
+
+## Array Output
+
+
+
+
+```js
+var arr = XLSX.utils.sheet_to_json(ws, opts);
+
+var aoa = XLSX.utils.sheet_to_json(ws, {header: 1, ...other_opts});
+```
+
+
+
+
+:::caution
+
+TypeScript types are purely informational. They are not included at run time
+and do not influence the behavior of the `sheet_to_json` function.
+
+**`sheet_to_json` does not perform field validation!**
+
+:::
+
+The main type signature treats each row as `any`:
+
+```ts
+const data: any[] = XLSX.utils.sheet_to_json(ws, opts);
+```
+
+The `any[][]` overload is designed for use with `header: 1` (array of arrays):
+
+```ts
+const aoa: any[][] = XLSX.utils.sheet_to_json(ws, { header: 1, ...other_opts });
+```
+
+An interface can be passed as a generic parameter. `sheet_to_json` will still
+return an array of plain objects (the types do not affect runtime behavior):
+
+```ts
+interface President {
+ Name: string;
+ Index: number;
+}
+
+const data: President[] = XLSX.utils.sheet_to_json(ws);
+```
+
+
+
+
+`XLSX.utils.sheet_to_json` generates an array of JS objects. The function takes
+an options argument:
+
+| Option Name | Default | Description |
+| :---------- | :------: | :-------------------------------------------------- |
+|`raw` | `true` | Use raw values (true) or formatted strings (false) |
+|`range` | ** | Override Range (see table below) |
+|`header` | | Control output format (see table below) |
+|`dateNF` | FMT 14 | Use specified date format in string output |
+|`defval` | | Use specified value in place of null or undefined |
+|`blankrows` | ** | Include blank lines in the output ** |
+
+- `raw` only affects cells which have a format code (`.z`) field or a formatted
+ text (`.w`) field.
+- If `header` is specified, the first row is considered a data row; if `header`
+ is not specified, the first row is the header row and not considered data.
+- When `header` is not specified, the conversion will automatically disambiguate
+ header entries by affixing `_` and a count starting at `1`. For example, if
+ three columns have header `foo` the output fields are `foo`, `foo_1`, `foo_2`
+- `null` values are returned when `raw` is true but are skipped when false.
+- If `defval` is not specified, null and undefined values are skipped normally.
+ If specified, all null and undefined points will be filled with `defval`
+- When `header` is `1`, the default is to generate blank rows. `blankrows` must
+ be set to `false` to skip blank rows.
+- When `header` is not `1`, the default is to skip blank rows. `blankrows` must
+ be true to generate blank rows
+
+`range` is expected to be one of:
+
+| `range` | Description |
+| :--------------- | :-------------------------------------------------------- |
+| (number) | Use worksheet range but set starting row to the value |
+| (string) | Use specified range (A1-Style bounded range string) |
+| (default) | Use worksheet range (`ws['!ref']`) |
+
+`header` is expected to be one of:
+
+| `header` | Description |
+| :--------------- | :-------------------------------------------------------- |
+| `1` | Generate an array of arrays |
+| `"A"` | Row object keys are literal column labels |
+| array of strings | Use specified strings as keys in row objects |
+| (default) | Read and disambiguate first row as keys |
+
+- If header is not `1`, the row object will contain the non-enumerable property
+ `__rowNum__` that represents the row of the sheet corresponding to the entry.
+- If header is an array, the keys will not be disambiguated. This can lead to
+ unexpected results if the array values are not unique!
+
+For the example worksheet:
+
+```jsx live
+function SheetJSToJSON() {
+ /* original data */
+ var ws = XLSX.utils.aoa_to_sheet([
+ ["S", "h", "e", "e", "t", "J", "S"],
+ [ 1, 2, , , 5, 6, 7],
+ [ 2, 3, , , 6, 7, 8],
+ [ 3, 4, , , 7, 8, 9],
+ [ 4, 5, 6, 7, 8, 9, 0]
+ ]);
+
+ /* display JS objects with some whitespace */
+ const aoo = o => o.map(r => " " + JSON.stringify(r).replace(/,"/g, ', "').replace(/:/g, ": ").replace(/"([A-Za-z_]\w*)":/g, '$1:')).join("\n");
+ const aoa = o => o.map(r => " " + JSON.stringify(r).replace(/,/g, ', ').replace(/null/g, "")).join("\n");
+
+ return (
+ Worksheet (as HTML)
+
+ XLSX.utils.sheet_to_json(ws, {'{'} header: 1 {'}'}) [array of arrays]
+ [
{aoa(XLSX.utils.sheet_to_json(ws, { header: 1 }))}
]
+ XLSX.utils.sheet_to_json(ws) [objects with header disambiguation]
+ [
{aoo(XLSX.utils.sheet_to_json(ws))}
]
+ XLSX.utils.sheet_to_json(ws, {'{'} header: "A" {'}'}) [column names as keys]
+ [
{aoo(XLSX.utils.sheet_to_json(ws, { header: "A" }))}
]
+ XLSX.utils.sheet_to_json(ws, {'{'} header: ["A","E","I","O","U","6","9"] {'}'})
+ [
{aoo(XLSX.utils.sheet_to_json(ws, { header: ["A","E","I","O","U","6","9"] }))}
]
+
);
+}
+```
diff --git a/docz/docs/08-api/07-utilities/05-html.md b/docz/docs/08-api/07-utilities/05-html.md
index 44ac7fd2..46329672 100644
--- a/docz/docs/08-api/07-utilities/05-html.md
+++ b/docz/docs/08-api/07-utilities/05-html.md
@@ -19,6 +19,8 @@ HTML format and HTML table utilities.
## HTML Table Output
+**Display worksheet data in a HTML table**
+
```js
var html = XLSX.utils.sheet_to_html(ws, opts);
```
diff --git a/docz/docs/08-api/07-utilities/index.md b/docz/docs/08-api/07-utilities/index.md
index ca517bc4..bc6e749c 100644
--- a/docz/docs/08-api/07-utilities/index.md
+++ b/docz/docs/08-api/07-utilities/index.md
@@ -4,25 +4,57 @@ title: Utility Functions
pagination_prev: api/write-options
---
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
+The utility functions in this section fall into two categories:
-The `sheet_to_*` functions accept a worksheet and an optional options object.
+**Data Packaging**
-The `*_to_sheet` functions accept a data object and an optional options object.
+The "Input" functions create SheetJS data structures (worksheets or workbooks)
+from rows of data or other common JS data representations
-The `sheet_add_*` functions accept worksheet, data, and optional options.
+These functions are paired with `write` or `writeFile` to create exports. For
+example, the following diagram shows the steps to export an HTML TABLE to XLSX:
-The examples are based on the following worksheet:
+```mermaid
+flowchart LR
+ html{{HTML\nTABLE}}
+ ws(SheetJS\nWorksheet)
+ wb(SheetJS\nWorkbook)
+ file[(workbook\nfile)]
+ html --> |table_to_sheet\n\n| ws
+ ws --> |book_new\nbook_append_sheet| wb
+ wb --> |writeFile\n\n| file
+```
-
-S | h | e | e | t | J | S |
-1 | 2 | | | 5 | 6 | 7 |
-2 | 3 | | | 6 | 7 | 8 |
-3 | 4 | | | 7 | 8 | 9 |
-4 | 5 | 6 | 7 | 8 | 9 | 0 |
-
+**Data Extraction**
+The "Output" functions extract data from worksheets to friendlier structures.
+
+These functions are paired with `read` or `readFile` to process data from files.
+The following diagram shows the steps to generate an HTML TABLE from a URL:
+
+```mermaid
+flowchart LR
+ url[(Remote\nFile)]
+ ab[(Data\nArrayBuffer)]
+ wb(SheetJS\nWorkbook)
+ ws(SheetJS\nWorksheet)
+ html{{HTML\nTABLE}}
+ url --> |fetch\n\n| ab
+ ab --> |read\n\n| wb
+ wb --> |wb.Sheets\nselect sheet| ws
+ ws --> |sheet_to_html\nfirst worksheet| html
+```
+
+
+## Array Output
+
+**Generate rows of data from a worksheet**
+
+```js
+var arr = XLSX.utils.sheet_to_json(ws, opts);
+```
+
+[**This functions is described in a dedicated page**](/docs/api/utilities/array#array-of-objects-input)
## Array of Arrays Input
@@ -32,80 +64,13 @@ The examples are based on the following worksheet:
var ws = XLSX.utils.aoa_to_sheet(aoa, opts);
```
-`XLSX.utils.aoa_to_sheet` takes an array of arrays of JS values and returns a
-worksheet resembling the input data. Values are interpreted as follows:
-
-- Numbers, Booleans and Strings are stored as the corresponding types.
-- Date objects are stored as Date cells or date codes (see `cellDates` option)
-- Array holes and explicit `undefined` values are skipped.
-- `null` values may be stubbed (see `sheetStubs` and `nullError` options)
-- Cell objects are used as-is.
-
-The function takes an options argument:
-
-| Option Name | Default | Description |
-| :---------- | :-----: | :--------------------------------------------------- |
-|`dateNF` | FMT 14 | Use specified date format in string output |
-|`cellDates` | false | Store dates as type `d` (default is `n`) |
-|`sheetStubs` | false | Create cell objects of type `z` for `null` values |
-|`nullError` | false | If true, emit `#NULL!` error cells for `null` values |
-
-The example worksheet can be generated with:
-
-```js
-var ws = XLSX.utils.aoa_to_sheet([
- ["S", "h", "e", "e", "t", "J", "S"],
- [ 1, 2, , , 5, 6, 7],
- [ 2, 3, , , 6, 7, 8],
- [ 3, 4, , , 7, 8, 9],
- [ 4, 5, 6, 7, 8, 9, 0]
-]);
-```
-
**Add data from an array of arrays to an existing worksheet**
```js
XLSX.utils.sheet_add_aoa(ws, aoa, opts);
```
-`XLSX.utils.sheet_add_aoa` takes an array of arrays of JS values and updates an
-existing worksheet object. It follows the same process as `aoa_to_sheet` and
-accepts an options argument:
-
-| Option Name | Default | Description |
-| :---------- | :-----: | :--------------------------------------------------- |
-|`dateNF` | FMT 14 | Use specified date format in string output |
-|`cellDates` | false | Store dates as type `d` (default is `n`) |
-|`sheetStubs` | false | Create cell objects of type `z` for `null` values |
-|`nullError` | false | If true, emit `#NULL!` error cells for `null` values |
-|`origin` | | Use specified cell as starting point (see below) |
-
-`origin` is expected to be one of:
-
-| `origin` | Description |
-| :--------------- | :-------------------------------------------------------- |
-| (cell object) | Use specified cell (cell object) |
-| (string) | Use specified cell (A1-Style cell) |
-| (number >= 0) | Start from the first column at specified row (0-indexed) |
-| -1 | Append to bottom of worksheet starting on first column |
-| (default) | Start from cell `A1` |
-
-
-The example worksheet can be built up in the order `A1:G1, A2:B4, E2:G4, A5:G5`:
-
-```js
-/* Initial row */
-var ws = XLSX.utils.aoa_to_sheet([ "SheetJS".split("") ]);
-
-/* Write data starting at A2 */
-XLSX.utils.sheet_add_aoa(ws, [[1,2], [2,3], [3,4]], {origin: "A2"});
-
-/* Write data starting at E2 */
-XLSX.utils.sheet_add_aoa(ws, [[5,6,7], [6,7,8], [7,8,9]], {origin:{r:1, c:4}});
-
-/* Append row */
-XLSX.utils.sheet_add_aoa(ws, [[4,5,6,7,8,9,0]], {origin: -1});
-```
+[**These functions are described in a dedicated page**](/docs/api/utilities/array#array-of-arrays-input)
## Array of Objects Input
@@ -115,312 +80,63 @@ XLSX.utils.sheet_add_aoa(ws, [[4,5,6,7,8,9,0]], {origin: -1});
var ws = XLSX.utils.json_to_sheet(aoo, opts);
```
-`XLSX.utils.json_to_sheet` takes an array of objects and returns a worksheet
-with automatically-generated "headers" based on the keys of the objects. The
-default column order is determined by the first appearance of the field using
-`Object.keys`. The function accepts an options argument:
-
-| Option Name | Default | Description |
-| :---------- | :-----: | :--------------------------------------------------- |
-|`header` | | Use specified field order (default `Object.keys`) ** |
-|`dateNF` | FMT 14 | Use specified date format in string output |
-|`cellDates` | false | Store dates as type `d` (default is `n`) |
-|`skipHeader` | false | If true, do not include header row in output |
-|`nullError` | false | If true, emit `#NULL!` error cells for `null` values |
-
-:::caution
-
-All fields from each row will be written! `header` hints at a particular order
-but is not exclusive. To remove fields from the export, filter the data source.
-
-Some data sources have special options to filter properties. For example,
-MongoDB will add the `_id` field when finding data from a collection:
-
-```js
-const aoo_with_id = await coll.find({}).toArray();
-const ws = XLSX.utils.json_to_sheet(aoo_with_id); // includes _id column
-```
-
-This can be filtered out through the `projection` property:
-
-```js
-const aoo = await coll.find({}, {projection:{_id:0}}).toArray(); // no _id !
-const ws = XLSX.utils.json_to_sheet(aoo);
-```
-
-If a data source does not provide a filter option, it can be filtered manually:
-
-```js
-const aoo = data.map(obj => Object.fromEntries(Object.entries(obj).filter(r => headers.indexOf(r[0]) > -1)));
-```
-
-:::
-
-- If `header` is an array, missing keys will be added in order of first use.
-- Cell types are deduced from the type of each value. For example, a `Date`
- object will generate a Date cell, while a string will generate a Text cell.
-- Null values will be skipped by default. If `nullError` is true, an error cell
- corresponding to `#NULL!` will be written to the worksheet.
-
-The example sheet cannot be reproduced using plain objects since JS object keys
-must be unique. After replacing the second `e` and `S` with `e_1` and `S_1`:
-
-```js
-var ws = XLSX.utils.json_to_sheet([
- { S:1, h:2, t:5, J:6, S_1:7 },
- { S:2, h:3, t:6, J:7, S_1:8 },
- { S:3, h:4, t:7, J:8, S_1:9 },
- { S:4, h:5, e:6, e_1:7, t:8, J:9, S_1:0 },
-], {header:["S","h","e","e_1","t","J","S_1"]});
-```
-
-Alternatively, a different set of unique headers can be used with `skipHeader`:
-
-```js
-var ws = XLSX.utils.json_to_sheet([
- { A: "S", B: "h", C: "e", D: "e", E: "t", F: "J", G: "S" },
- { A: 1, B: 2, E: 5, F: 6, G: 7 },
- { A: 2, B: 3, E: 6, F: 7, G: 8 },
- { A: 3, B: 4, E: 7, F: 8, G: 9 },
- { A: 4, B: 5, C: 6, D: 7, E: 8, F: 9, G: 0 },
-], {header:["A","B","C","D","E","F","G"], skipHeader:true});
-```
-
**Add data from an array of objects to an existing worksheet**
```js
XLSX.utils.sheet_add_json(ws, aoo, opts);
```
-`XLSX.utils.sheet_add_json` takes an array of objects and updates an existing
-worksheet object. It follows the same process as `json_to_sheet` and accepts
-an options argument:
-
-| Option Name | Default | Description |
-| :---------- | :-----: | :--------------------------------------------------- |
-|`header` | | Use specified column order (default `Object.keys`) |
-|`dateNF` | FMT 14 | Use specified date format in string output |
-|`cellDates` | false | Store dates as type `d` (default is `n`) |
-|`skipHeader` | false | If true, do not include header row in output |
-|`nullError` | false | If true, emit `#NULL!` error cells for `null` values |
-|`origin` | | Use specified cell as starting point (see below) |
-
-`origin` is expected to be one of:
-
-| `origin` | Description |
-| :--------------- | :-------------------------------------------------------- |
-| (cell object) | Use specified cell (cell object) |
-| (string) | Use specified cell (A1-Style cell) |
-| (number >= 0) | Start from the first column at specified row (0-indexed) |
-| -1 | Append to bottom of worksheet starting on first column |
-| (default) | Start from cell `A1` |
-
-
-This example worksheet can be built up in the order `A1:G1, A2:B4, E2:G4, A5:G5`:
-
-```js
-/* Initial row */
-var ws = XLSX.utils.json_to_sheet([
- { A: "S", B: "h", C: "e", D: "e", E: "t", F: "J", G: "S" }
-], {header: ["A", "B", "C", "D", "E", "F", "G"], skipHeader: true});
-
-/* Write data starting at A2 */
-XLSX.utils.sheet_add_json(ws, [
- { A: 1, B: 2 }, { A: 2, B: 3 }, { A: 3, B: 4 }
-], {skipHeader: true, origin: "A2"});
-
-/* Write data starting at E2 */
-XLSX.utils.sheet_add_json(ws, [
- { A: 5, B: 6, C: 7 }, { A: 6, B: 7, C: 8 }, { A: 7, B: 8, C: 9 }
-], {skipHeader: true, origin: { r: 1, c: 4 }, header: [ "A", "B", "C" ]});
-
-/* Append row */
-XLSX.utils.sheet_add_json(ws, [
- { A: 4, B: 5, C: 6, D: 7, E: 8, F: 9, G: 0 }
-], {header: ["A", "B", "C", "D", "E", "F", "G"], skipHeader: true, origin: -1});
-```
-
-:::note
-
-If the `header` option is an array, `sheet_add_json` and `sheet_to_json` will
-append missing elements.
-
-This design enables consistent header order across calls:
-
-```jsx live
-function SheetJSHeaderOrder() {
- /* Use shared header */
- const header = [];
- const ws1 = XLSX.utils.json_to_sheet([ {C: 2, D: 3}, ], {header});
- XLSX.utils.sheet_add_json(ws1, [ {D: 1, C: 4}, ], {header, origin: -1, skipHeader: true});
-
- /* only use header in first call */
- const ws2 = XLSX.utils.json_to_sheet([ {C: 2, D: 3}, ], {header:[]});
- XLSX.utils.sheet_add_json(ws2, [ {D: 1, C: 4}, ], {origin: -1, skipHeader: true});
-
- return (
- Objects
- {"\n[\n { C: 2, D: 3 },\n { D: 1, C: 4 } // different key order\n]\n"}
- Worksheet when same `header` array is passed to `sheet_add_json`
-
-
New contents of `header`
- {JSON.stringify(header)}
-
-
Worksheet when no `header` property is passed to `sheet_add_json`
-
- )
-}
-```
-
-:::
+[**These functions are described in a dedicated page**](/docs/api/utilities/array#array-of-objects-input)
## HTML Table Input
-[**This has been moved to a separate page**](/docs/api/utilities/html#html-table-input)
+**Create a worksheet or workbook from a TABLE element**
-### Value Override
+```js
+var ws = XLSX.utils.table_to_sheet(elt, opts);
+var wb = XLSX.utils.table_to_book(elt, opts);
+```
-[**This has been moved to a separate page**](/docs/api/utilities/html#value-override)
+**Add data from a TABLE element to an existing worksheet**
-## Delimiter-Separated Output
+```js
+XLSX.utils.sheet_add_dom(ws, elt, opts);
+```
-[**This has been moved to a separate page**](/docs/api/utilities/csv)
+[**These functions are described in a dedicated page**](/docs/api/utilities/html#html-table-input)
## HTML Output
-[**This has been moved to a separate page**](/docs/api/utilities/html#html-table-output)
-
-## Array Output
-
-
-
+**Display worksheet data in a HTML table**
```js
-var arr = XLSX.utils.sheet_to_json(ws, opts);
-
-var aoa = XLSX.utils.sheet_to_json(ws, {header: 1, ...other_opts});
+var html = XLSX.utils.sheet_to_html(ws, opts);
```
-
-
+[**This function are described in a dedicated page**](/docs/api/utilities/html#html-table-output)
-:::caution
+## Delimiter-Separated Output
-TypeScript types are purely informational. They are not included at run time
-and do not influence the behavior of the `sheet_to_json` method.
+**Generate CSV from a Worksheet**
-**`sheet_to_json` does not perform field validation!**
-
-:::
-
-The main type signature treats each row as `any`:
-
-```ts
-const data: any[] = XLSX.utils.sheet_to_json(ws, opts);
+```js
+var csv = XLSX.utils.sheet_to_csv(ws, opts);
```
-The `any[][]` overload is designed for use with `header: 1` (array of arrays):
+**Export worksheet data in "UTF-16 Text" or Tab-Separated Values (TSV)**
-```ts
-const aoa: any[][] = XLSX.utils.sheet_to_json(ws, { header: 1, ...other_opts });
+```js
+var txt = XLSX.utils.sheet_to_txt(ws, opts);
```
-An interface can be passed as a generic parameter. `sheet_to_json` will still
-return an array of plain objects (the types do not affect runtime behavior):
-
-```ts
-interface President {
- Name: string;
- Index: number;
-}
-
-const data: President[] = XLSX.utils.sheet_to_json(ws);
-```
-
-
-
-
-`XLSX.utils.sheet_to_json` generates an array of JS objects. The function takes
-an options argument:
-
-| Option Name | Default | Description |
-| :---------- | :------: | :-------------------------------------------------- |
-|`raw` | `true` | Use raw values (true) or formatted strings (false) |
-|`range` | ** | Override Range (see table below) |
-|`header` | | Control output format (see table below) |
-|`dateNF` | FMT 14 | Use specified date format in string output |
-|`defval` | | Use specified value in place of null or undefined |
-|`blankrows` | ** | Include blank lines in the output ** |
-
-- `raw` only affects cells which have a format code (`.z`) field or a formatted
- text (`.w`) field.
-- If `header` is specified, the first row is considered a data row; if `header`
- is not specified, the first row is the header row and not considered data.
-- When `header` is not specified, the conversion will automatically disambiguate
- header entries by affixing `_` and a count starting at `1`. For example, if
- three columns have header `foo` the output fields are `foo`, `foo_1`, `foo_2`
-- `null` values are returned when `raw` is true but are skipped when false.
-- If `defval` is not specified, null and undefined values are skipped normally.
- If specified, all null and undefined points will be filled with `defval`
-- When `header` is `1`, the default is to generate blank rows. `blankrows` must
- be set to `false` to skip blank rows.
-- When `header` is not `1`, the default is to skip blank rows. `blankrows` must
- be true to generate blank rows
-
-`range` is expected to be one of:
-
-| `range` | Description |
-| :--------------- | :-------------------------------------------------------- |
-| (number) | Use worksheet range but set starting row to the value |
-| (string) | Use specified range (A1-Style bounded range string) |
-| (default) | Use worksheet range (`ws['!ref']`) |
-
-`header` is expected to be one of:
-
-| `header` | Description |
-| :--------------- | :-------------------------------------------------------- |
-| `1` | Generate an array of arrays |
-| `"A"` | Row object keys are literal column labels |
-| array of strings | Use specified strings as keys in row objects |
-| (default) | Read and disambiguate first row as keys |
-
-- If header is not `1`, the row object will contain the non-enumerable property
- `__rowNum__` that represents the row of the sheet corresponding to the entry.
-- If header is an array, the keys will not be disambiguated. This can lead to
- unexpected results if the array values are not unique!
-
-For the example worksheet:
-
-```jsx live
-function SheetJSToJSON() {
- /* original data */
- var ws = XLSX.utils.aoa_to_sheet([
- ["S", "h", "e", "e", "t", "J", "S"],
- [ 1, 2, , , 5, 6, 7],
- [ 2, 3, , , 6, 7, 8],
- [ 3, 4, , , 7, 8, 9],
- [ 4, 5, 6, 7, 8, 9, 0]
- ]);
-
- /* display JS objects with some whitespace */
- const aoo = o => o.map(r => " " + JSON.stringify(r).replace(/,"/g, ', "').replace(/:/g, ": ").replace(/"([A-Za-z_]\w*)":/g, '$1:')).join("\n");
- const aoa = o => o.map(r => " " + JSON.stringify(r).replace(/,/g, ', ').replace(/null/g, "")).join("\n");
-
- return (
- Worksheet (as HTML)
-
- XLSX.utils.sheet_to_json(ws, {'{'} header: 1 {'}'}) [array of arrays]
- [
{aoa(XLSX.utils.sheet_to_json(ws, { header: 1 }))}
]
- XLSX.utils.sheet_to_json(ws) [objects with header disambiguation]
- [
{aoo(XLSX.utils.sheet_to_json(ws))}
]
- XLSX.utils.sheet_to_json(ws, {'{'} header: "A" {'}'}) [column names as keys]
- [
{aoo(XLSX.utils.sheet_to_json(ws, { header: "A" }))}
]
- XLSX.utils.sheet_to_json(ws, {'{'} header: ["A","E","I","O","U","6","9"] {'}'})
- [
{aoo(XLSX.utils.sheet_to_json(ws, { header: ["A","E","I","O","U","6","9"] }))}
]
-
);
-}
-```
+[**These functions are described in a dedicated page**](/docs/api/utilities/csv)
## Formulae Output
-[**This has been moved to a separate page**](/docs/api/utilities/formulae)
\ No newline at end of file
+**Extract all formulae from a worksheet**
+
+```js
+var fmla_arr = XLSX.utils.sheet_to_formulae(ws);
+```
+
+[**This function is described in a dedicated page**](/docs/api/utilities/formulae)
\ No newline at end of file
diff --git a/docz/docs/08-api/index.md b/docz/docs/08-api/index.md
index 1aa775b1..3b53c108 100644
--- a/docz/docs/08-api/index.md
+++ b/docz/docs/08-api/index.md
@@ -53,6 +53,19 @@ _Cell and cell address manipulation:_
- `encode_cell / decode_cell` converts cell addresses.
- `encode_range / decode_range` converts cell ranges.
+**["Arrays of Data" section of "Utility Functions"](/docs/api/utilities/array)**
+
+_Importing Data:_
+
+- `aoa_to_sheet` converts an array of arrays of JS data to a worksheet.
+- `json_to_sheet` converts an array of JS objects to a worksheet.
+- `sheet_add_aoa` adds an array of arrays of JS data to an existing worksheet.
+- `sheet_add_json` adds an array of JS objects to an existing worksheet.
+
+_Exporting Data:_
+
+- `sheet_to_json` converts a worksheet object to an array of JSON objects.
+
**["HTML" section of "Utility Functions"](/docs/api/utilities/html)**
_Reading from HTML:_
@@ -85,17 +98,6 @@ _Workbook Operations:_
- `book_new` creates an empty workbook
- `book_append_sheet` adds a worksheet to a workbook
-_Importing Data:_
-
-- `aoa_to_sheet` converts an array of arrays of JS data to a worksheet.
-- `json_to_sheet` converts an array of JS objects to a worksheet.
-- `sheet_add_aoa` adds an array of arrays of JS data to an existing worksheet.
-- `sheet_add_json` adds an array of JS objects to an existing worksheet.
-
-_Exporting Data:_
-
-- `sheet_to_json` converts a worksheet object to an array of JSON objects.
-
_Miscellaneous_
- `format_cell` generates the text value for a cell (using number formats).
diff --git a/docz/docusaurus.config.js b/docz/docusaurus.config.js
index 1eb23baa..8142b3b1 100644
--- a/docz/docusaurus.config.js
+++ b/docz/docusaurus.config.js
@@ -48,6 +48,10 @@ const config = {
googleAnalytics: {
trackingID: 'UA-36810333-1',
anonymizeIP: true
+ },
+ gtag: {
+ trackingID: 'G-0TSXVXRHM6',
+ anonymizeIP: true
}
}),
],