<details>
  <summary><b>Доступность CDN</b> (нажмите, чтобы показать)</summary>

|    CDN     | URL                                        |
|-----------:|:-------------------------------------------|
|    `unpkg` | <https://unpkg.com/xlsx/>                  |
| `jsDelivr` | <https://jsdelivr.com/package/npm/xlsx>    |
|    `CDNjs` | <https://cdnjs.com/libraries/xlsx>         |

Например, `unpkg` предоставляет последнюю версию по адресу:```html
<script src="https://unpkg.com/xlsx/dist/xlsx.full.min.js"></script>

**Модули ECMAScript**

Сборка модуля ECMAScript сохраняется в `xlsx.mjs` и может быть напрямую добавлена на страницу с помощью тега `script` с атрибутом `type=module`:```html
<script type="module">
import { read, writeFileXLSX } from "./xlsx.mjs";

/* load the codepage support library for extended support with older formats  */
import { set_cptable } from "./xlsx.mjs";
import * as cptable from './dist/cpexcel.full.mjs';
set_cptable(cptable);
</script>

**Deno**

`xlsx.mjs` можно импортировать в Deno.  Он доступен на `unpkg`:```ts
// @deno-types="https://unpkg.com/xlsx/types/index.d.ts"
import * as XLSX from 'https://unpkg.com/xlsx/xlsx.mjs';

/* load the codepage support library for extended support with older formats  */
import * as cptable from 'https://unpkg.com/xlsx/dist/cpexcel.full.mjs';
XLSX.set_cptable(cptable);

По умолчанию модуль поддерживает `require`:```js
var XLSX = require("xlsx");

**Photoshop и InDesign**

`dist/xlsx.extendscript.js` — это сборка ExtendScript для Photoshop и InDesign, которая включена в пакет `npm`. На неё можно напрямую ссылаться с помощью директивы `#include`:```extendscript
#include "xlsx.extendscript.js"

Эта библиотека пытается упростить шаги 2 и 4 с помощью функций для извлечения полезных
данных из файлов электронных таблиц (`read` / `readFile`) и генерации новых файлов
электронных таблиц из данных (`write` / `writeFile`). Дополнительные служебные функции, такие как
`table_to_book`, работают с другими распространенными источниками данных, такими как HTML-таблицы.

Эта документация и различные демонстрационные проекты охватывают ряд распространенных сценариев
и подходов для шагов 1 и 5.

Служебные функции помогают с шагом 3.

["Получение и извлечение данных"](#acquiring-and-extracting-data) описывает
решения для типичных сценариев импорта данных.

["Упаковка и выпуск данных"](#packaging-and-releasing-data) описывает
решения для типичных сценариев экспорта данных.

["Обработка данных"](#packaging-and-releasing-data) описывает решения для
типичных сценариев обработки и манипуляции рабочими книгами.

["Служебные функции"](#utility-functions) подробно описывает служебные функции для
преобразования массивов JSON и других распространенных структур JS в объекты листов.

### Дзен SheetJS

_Обработка данных должна вписываться в любой рабочий процесс_

Библиотека не навязывает отдельный жизненный цикл. Она отлично вписывается в веб-сайты
и приложения, созданные с использованием любого фреймворка. Обычные объекты данных JS хорошо взаимодействуют с
Web Workers и будущими API.

_JavaScript — мощный язык для обработки данных_

["Общий формат электронных таблиц"](#common-spreadsheet-format) представляет собой простое объектное
представление основных понятий рабочей книги. Различные функции в
библиотеке предоставляют низкоуровневые инструменты для работы с объектом.

Для удобной обработки на JS существуют служебные функции для преобразования частей
листа в массив массивов и обратно. Следующий пример объединяет мощные
методы массивов JS с библиотекой сетевых запросов для загрузки данных, выбора
нужной информации и создания файла рабочей книги:

<details>
  <summary><b>Получить данные из конечной точки JSON и создать рабочую книгу</b> (нажмите, чтобы показать)</summary>

Цель — создать книгу XLSB с именами и датами рождения президентов США.

**Получение данных**

_Сырые данные_

<https://theunitedstates.io/congress-legislators/executive.json> содержит нужные
данные. Например, Джон Адамс:```js
{
  "id": { /* (data omitted) */ },
  "name": {
    "first": "John",          // <-- first name
    "last": "Adams"           // <-- last name
  },
  "bio": {
    "birthday": "1735-10-19", // <-- birthday
    "gender": "M"
  },
  "terms": [
    { "type": "viceprez", /* (other fields omitted) */ },
    { "type": "viceprez", /* (other fields omitted) */ },
    { "type": "prez", /* (other fields omitted) */ } // <-- look for "prez"
  ]
}

_Выравнивание данных_

В этом примере имя будет объединением имени и фамилии (`row.name.first + " " + row.name.last`), а день рождения — подполем `row.bio.birthday`. Используя `Array#map`, набор данных можно преобразовать одним вызовом:```js
const rows = prez.map(row => ({
  name: row.name.first + " " + row.name.last,
  birthday: row.bio.birthday
}));

**Извлечение данных**

С очищенным набором данных `XLSX.utils.json_to_sheet` генерирует лист:```js
const worksheet = XLSX.utils.json_to_sheet(rows);

**Process Data**

_Исправление заголовков_

По умолчанию `json_to_sheet` создает лист с строкой заголовков. В данном случае
заголовки берутся из ключей JS-объекта: "name" и "birthday".

Заголовки находятся в ячейках A1 и B1.  `XLSX.utils.sheet_add_aoa` может записывать текстовые значения в существующий лист, начиная с ячейки A1:```js
XLSX.utils.sheet_add_aoa(worksheet, [["Name", "Birthday"]], { origin: "A1" });

Один вызов `Array#reduce` по `rows` может вычислить максимальную ширину:```js
const max_width = rows.reduce((w, r) => Math.max(w, r.name.length), 10);
worksheet["!cols"] = [ { wch: max_width } ];

**Полный пример**```js
// Uncomment the next line for use in NodeJS:
// const XLSX = require("xlsx"), axios = require("axios");

(async() => {
  /* fetch JSON data and parse */
  const url = "https://theunitedstates.io/congress-legislators/executive.json";
  const raw_data = (await axios(url, {responseType: "json"})).data;

  /* filter for the Presidents */
  const prez = raw_data.filter(row => row.terms.some(term => term.type === "prez"));

  /* flatten objects */
  const rows = prez.map(row => ({
    name: row.name.first + " " + row.name.last,
    birthday: row.bio.birthday
  }));

  /* generate worksheet and workbook */
  const worksheet = XLSX.utils.json_to_sheet(rows);
  const workbook = XLSX.utils.book_new();
  XLSX.utils.book_append_sheet(workbook, worksheet, "Dates");

  /* fix headers */
  XLSX.utils.sheet_add_aoa(worksheet, [["Name", "Birthday"]], { origin: "A1" });

  /* calculate column width */
  const max_width = rows.reduce((w, r) => Math.max(w, r.name.length), 10);
  worksheet["!cols"] = [ { wch: max_width } ];

  /* create an XLSX file and try to save to Presidents.xlsx */
  XLSX.writeFile(workbook, "Presidents.xlsx");
})();

</details>

_Форматы файлов являются деталями реализации_

Парсер охватывает широкий спектр распространенных форматов файлов электронных таблиц, чтобы гарантировать, что файлы, «сохраненные как HTML-XLS», работают так же, как и реальные файлы XLS или XLSX.

Писатель поддерживает ряд распространенных выходных форматов для широкой совместимости с экосистемой данных.

Насколько это возможно, код обработки данных не должен беспокоиться о конкретных используемых форматах файлов.

### Демонстрации экосистемы JS

Каталог [`demos`](https://github.com/weareu/xlsx/blob/HEAD/demos/) включает примеры проектов для:

**Фреймворки и API**
- [`angularjs`](https://github.com/weareu/xlsx/blob/HEAD/demos/angular/)
- [`angular и ionic`](https://github.com/weareu/xlsx/blob/HEAD/demos/angular2/)
- [`knockout`](https://github.com/weareu/xlsx/blob/HEAD/demos/knockout/)
- [`meteor`](https://github.com/weareu/xlsx/blob/HEAD/demos/meteor/)
- [`react и react-native`](https://github.com/weareu/xlsx/blob/HEAD/demos/react/)
- [`vue 2.x и weex`](https://github.com/weareu/xlsx/blob/HEAD/demos/vue/)
- [`XMLHttpRequest и fetch`](https://github.com/weareu/xlsx/blob/HEAD/demos/xhr/)
- [`nodejs сервер`](https://github.com/weareu/xlsx/blob/HEAD/demos/server/)
- [`базы данных и хранилища ключ/значение`](https://github.com/weareu/xlsx/blob/HEAD/demos/database/)
- [`типизированные массивы и математика`](https://github.com/weareu/xlsx/blob/HEAD/demos/array/)

**Сборщики и инструменты**
- [`browserify`](https://github.com/weareu/xlsx/blob/HEAD/demos/browserify/)
- [`fusebox`](https://github.com/weareu/xlsx/blob/HEAD/demos/fusebox/)
- [`parcel`](https://github.com/weareu/xlsx/blob/HEAD/demos/parcel/)
- [`requirejs`](https://github.com/weareu/xlsx/blob/HEAD/demos/requirejs/)
- [`rollup`](https://github.com/weareu/xlsx/blob/HEAD/demos/rollup/)
- [`systemjs`](https://github.com/weareu/xlsx/blob/HEAD/demos/systemjs/)
- [`typescript`](https://github.com/weareu/xlsx/blob/HEAD/demos/typescript/)
- [`webpack 2.x`](https://github.com/weareu/xlsx/blob/HEAD/demos/webpack/)

**Платформы и интеграции**
- [`deno`](https://github.com/weareu/xlsx/blob/HEAD/demos/deno/)
- [`electron приложение`](https://github.com/weareu/xlsx/blob/HEAD/demos/electron/)
- [`nw.js приложение`](https://github.com/weareu/xlsx/blob/HEAD/demos/nwjs/)
- [`Расширения Chrome / Chromium`](https://github.com/weareu/xlsx/blob/HEAD/demos/chrome/)
- [`Скачать Google Sheet локально`](https://github.com/weareu/xlsx/blob/HEAD/demos/google-sheet/)
- [`Adobe ExtendScript`](https://github.com/weareu/xlsx/blob/HEAD/demos/extendscript/)
- [`Безголовые браузеры`](https://github.com/weareu/xlsx/blob/HEAD/demos/headless/)
- [`canvas-datagrid`](https://github.com/weareu/xlsx/blob/HEAD/demos/datagrid/)
- [`x-spreadsheet`](https://github.com/weareu/xlsx/blob/HEAD/demos/xspreadsheet/)
- [`react-data-grid`](https://github.com/weareu/xlsx/blob/HEAD/demos/react/modify/)
- [`vue3-table-light`](https://github.com/weareu/xlsx/blob/HEAD/demos/vue/modify/)
- [`Swift JSC и другие движки`](https://github.com/weareu/xlsx/blob/HEAD/demos/altjs/)
- [`функции "без сервера"`](https://github.com/weareu/xlsx/blob/HEAD/demos/function/)
- [`Internet Explorer`](https://github.com/weareu/xlsx/blob/HEAD/demos/oldie/)

Другие примеры включены в [витрину](https://github.com/weareu/xlsx/blob/HEAD/demos/showcase/).

<https://sheetjs.com/demos/modify.html> показывает полный пример чтения, изменения и записи файлов.

<https://github.com/SheetJS/sheetjs/blob/HEAD/bin/xlsx.njs> — это инструмент командной строки, включенный в установки node, который читает файлы электронных таблиц и экспортирует содержимое в различных форматах.
## Получение и извлечение данных

### Разбор книг

**API**

_Извлечение данных из байтов электронных таблиц_```js
var workbook = XLSX.read(data, opts);

Метод `readFile` пытается прочитать файл электронной таблицы по указанному пути. Браузеры, как правило, не позволяют читать файлы таким образом (это считается угрозой безопасности), и попытки чтения таким способом приведут к ошибке.

Второй аргумент `opts` необязателен. В разделе ["Параметры парсинга"](#parsing-options) описаны поддерживаемые свойства и поведение.

**Примеры**

Вот несколько типичных сценариев (нажмите на каждый заголовок, чтобы увидеть код):

<details>
  <summary><b>Локальный файл на сервере NodeJS</b> (нажмите, чтобы показать)</summary>

`readFile` использует `fs.readFileSync` под капотом:```js
var XLSX = require("xlsx");

var workbook = XLSX.readFile("test.xlsx");

</details>

<details>
  <summary><b>Локальный файл в приложении Deno</b> (нажмите, чтобы показать)</summary>

`readFile` использует `Deno.readFileSync` под капотом:```js
// @deno-types="https://deno.land/x/sheetjs/types/index.d.ts"
import * as XLSX from 'https://deno.land/x/sheetjs/xlsx.mjs'

const workbook = XLSX.readFile("test.xlsx");

The `book_new` utility функция создает пустую книгу без листов.

Программы для работы с электронными таблицами обычно требуют наличия хотя бы одного листа и принудительно обеспечивают это требование в пользовательском интерфейсе. Данная библиотека обеспечивает это требование на этапе записи, выдавая ошибки, если пустая книга передается в функции записи.


**API**

_Создание листа из массива массивов значений JS_```js
var worksheet = XLSX.utils.aoa_to_sheet(aoa, opts);

["Array of Arrays Input"](#array-of-arrays-input) описывает функцию и необязательный аргумент `opts` более подробно.

_Создать рабочий лист из массива JS-объектов_```js
var worksheet = XLSX.utils.json_to_sheet(jsa, opts);

Вспомогательная функция `book_append_sheet` добавляет лист в книгу.
Третий аргумент задает желаемое имя листа. Несколько листов можно
добавить в книгу, вызывая функцию несколько раз. Если имя листа
уже используется в книге, будет вызвана ошибка.

_Добавить лист в книгу и найти уникальное имя_```js
var new_name = XLSX.utils.book_append_sheet(workbook, worksheet, name, true);

_Перечислить названия листов в порядке вкладок_```js
var wsnames = workbook.SheetNames;

Свойство `Sheets` объекта книги — это объект, ключами которого являются названия, а значениями — объекты листов. Переприсваивая свойству объекта `Sheets`, можно изменить объект листа, не нарушая остальную структуру листов.

**Примеры**

<details>
  <summary><b>Добавить новый лист в книгу</b> (нажмите, чтобы показать)</summary>

В этом примере используется [`XLSX.utils.aoa_to_sheet`](#array-of-arrays-input).```js
var ws_name = "SheetJS";

/* Create worksheet */
var ws_data = [
  [ "S", "h", "e", "e", "t", "J", "S" ],
  [  1 ,  2 ,  3 ,  4 ,  5 ]
];
var ws = XLSX.utils.aoa_to_sheet(ws_data);

/* Add the worksheet to the workbook */
XLSX.utils.book_append_sheet(wb, ws, ws_name);

_Изменить несколько значений ячеек на листе_```js
XLSX.utils.sheet_add_aoa(worksheet, aoa, opts);

["Ввод массива массивов"](#array-of-arrays-input) описывает функцию и необязательный аргумент `opts` более подробно.

**Примеры**

<details>
  <summary><b>Добавление строк на лист</b> (нажмите, чтобы показать)</summary>

Особое значение источника `-1` указывает `sheet_add_aoa` начать в столбце A строки, следующей за последней строкой в диапазоне, добавляя данные:```js
XLSX.utils.sheet_add_aoa(worksheet, [
  ["first row after data", 1],
  ["second row after data", 2]
], { origin: -1 });

Метод `write` пытается упаковать данные из рабочей книги в файл в памяти. По умолчанию создаются файлы XLSX, но это можно контролировать с помощью свойства `bookType` аргумента `opts`. В зависимости от опции `type` данные могут быть сохранены как «двоичная строка», JS-строка, `Uint8Array` или Buffer.

Второй аргумент `opts` обязателен. В разделе ["Опции записи"](#writing-options) описаны поддерживаемые свойства и поведение.

_Сгенерировать и попытаться сохранить файл_```js
XLSX.writeFile(workbook, filename, opts);

Метод `writeFile` включает в себя несколько различных функций экспорта. Это отлично подходит для удобства разработчика, но не поддается tree-shaking с помощью текущих инструментов разработчика. Когда требуются только экспорт XLSX, этот метод избегает ссылок на другие функции экспорта.

Второй аргумент `opts` является необязательным. В разделе [«Параметры записи»](#writing-options) описаны поддерживаемые свойства и поведение.

**Примеры**

<details>
  <summary><b>Локальный файл на сервере NodeJS</b> (нажмите, чтобы показать)</summary>

`writeFile` использует `fs.writeFileSync` в серверных средах:```js
var XLSX = require("xlsx");

/* output format determined by filename */
XLSX.writeFile(workbook, "out.xlsb");

</details>

<details>
  <summary><b>Локальный файл в приложении Deno</b> (нажмите, чтобы показать)</summary>

`writeFile` использует `Deno.writeFileSync` под капотом:```js
// @deno-types="https://deno.land/x/sheetjs/types/index.d.ts"
import * as XLSX from 'https://deno.land/x/sheetjs/xlsx.mjs'

XLSX.writeFile(workbook, "test.xlsx");

_Создать массив массивов значений JS из рабочего листа_```js
var aoa = XLSX.utils.sheet_to_json(worksheet, {...opts, header: 1});

Этот снимок предназначен для воспроизведения типа вывода "CSV UTF8 (`.csv`)".
["Вывод с разделителями"](#delimiter-separated-output) описывает
функцию и необязательный аргумент `opts` более подробно.

___

_Сгенерировать "Text" из одного рабочего листа_```js
var txt = XLSX.utils.sheet_to_txt(worksheet, opts);

Этот снимок генерирует массив записей, представляющих встроенные формулы.
Формулы массивов отображаются в виде `диапазон=формула`, а обычные ячейки — в виде `ячейка=формула или значение`.  Строковые литералы предваряются апострофом `'`, как в строке формул Excel.

Функция подробно описана в разделе ["Вывод формул"](#formulae-output).

## Интерфейс

`XLSX` — это глобальная переменная в браузере и экспортируемая переменная в Node.

`XLSX.version` — версия библиотеки (добавляется скриптом сборки).

`XLSX.SSF` — встроенная версия [библиотеки форматирования](https://git.io/ssf).

### Функции парсинга

`XLSX.read(data, read_opts)` пытается распарсить `data`.

`XLSX.readFile(filename, read_opts)` пытается прочитать `filename` и распарсить.

Параметры парсинга описаны в разделе [Параметры парсинга](#parsing-options).

### Функции записи

`XLSX.write(wb, write_opts)` пытается записать книгу `wb`.

`XLSX.writeFile(wb, filename, write_opts)` пытается записать `wb` в `filename`.
В браузерной среде пытается инициировать скачивание на стороне клиента.

`XLSX.writeFileAsync(wb, filename, o, cb)` пытается записать `wb` в `filename`.
Если `o` опущен, функция записи использует третий аргумент как обратный вызов.

`XLSX.stream` содержит набор потоковых функций записи.

Параметры записи описаны в разделе [Параметры записи](#writing-options).

### Утилиты

Утилиты доступны в объекте `XLSX.utils` и описаны в разделе
[Функции утилит](#utility-functions):

**Создание:**

- `book_new` создаёт пустую книгу
- `book_append_sheet` добавляет лист в книгу

**Импорт:**

- `aoa_to_sheet` преобразует массив массивов JS-данных в лист.
- `json_to_sheet` преобразует массив JS-объектов в лист.
- `table_to_sheet` преобразует DOM-элемент TABLE в лист.
- `sheet_add_aoa` добавляет массив массивов JS-данных в существующий лист.
- `sheet_add_json` добавляет массив JS-объектов в существующий лист.

**Экспорт:**

- `sheet_to_json` преобразует объект листа в массив JSON-объектов.
- `sheet_to_csv` генерирует вывод с разделителями-разделителями.
- `sheet_to_txt` генерирует текст в формате UTF16.
- `sheet_to_html` генерирует HTML-вывод.
- `sheet_to_formulae` генерирует список формул (с запасными значениями).

**Манипуляции с ячейками и адресами ячеек:**

- `format_cell` генерирует текстовое значение для ячейки (с использованием числовых форматов).
- `encode_row / decode_row` преобразует между строками с 0-индексацией и строками с 1-индексацией.
- `encode_col / decode_col` преобразует между столбцами с 0-индексацией и именами столбцов.
- `encode_cell / decode_cell` преобразует адреса ячеек.
- `encode_range / decode_range` преобразует диапазоны ячеек.

## Общий формат электронных таблиц

SheetJS соответствует Общему формату электронных таблиц (CSF):

### Общие структуры

Объекты адресов ячеек хранятся как `{c:C, r:R}`, где `C` и `R` — это номера столбца и строки с 0-индексацией соответственно. Например, адрес ячейки `B5` представлен объектом `{c:1, r:4}`.

Объекты диапазонов ячеек хранятся как `{s:S, e:E}`, где `S` — первая ячейка, а `E` — последняя ячейка в диапазоне. Диапазоны включают обе границы. Например, диапазон `A3:B7` представлен объектом `{s:{c:0, r:2}, e:{c:1, r:6}}`.
Функции утилит выполняют обход диапазона листа в порядке строк (row-major):```js
for(var R = range.s.r; R <= range.e.r; ++R) {
  for(var C = range.s.c; C <= range.e.c; ++C) {
    var cell_address = {c:C, r:R};
    /* if an A1-style address is needed, encode the address */
    var cell_ref = XLSX.utils.encode_cell(cell_address);
  }
}

#### Объект диаграммы

Диаграммы представлены как стандартные листы. Они отличаются
свойством `!type`, установленным в `"chart"`.

Базовые данные и `!ref` относятся к кэшированным данным на листе диаграммы.
Первая строка листа диаграммы является базовым заголовком.

#### Объект макроса

Макросы представлены как стандартные листы. Они отличаются
свойством `!type`, установленным в `"macro"`.

#### Объект диалогового листа

Диалоговые листы представлены как стандартные листы. Они отличаются
свойством `!type`, установленным в `"dialog"`.

### Объект рабочей книги

`workbook.SheetNames` — упорядоченный список листов в рабочей книге.

`wb.Sheets[sheetname]` возвращает объект, представляющий рабочий лист.

`wb.Props` — объект, хранящий стандартные свойства. `wb.Custprops` хранит
пользовательские свойства. Поскольку стандартные свойства XLS отличаются от
стандарта XLSX, разбор XLS сохраняет основные свойства в обоих местах.

`wb.Workbook` хранит [атрибуты уровня рабочей книги](#workbook-level-attributes).

#### Свойства файла рабочей книги

Различные форматы файлов используют разные внутренние имена для свойств файлов.
Объект `Props` рабочей книги нормализует имена:

<details>
  <summary><b>Свойства файла</b> (нажмите, чтобы показать)</summary>

| JS Name       | Excel Description              |
|:--------------|:-------------------------------|
| `Title`       | Вкладка «Сводка» «Название»    |
| `Subject`     | Вкладка «Сводка» «Тема»       |
| `Author`      | Вкладка «Сводка» «Автор»      |
| `Manager`     | Вкладка «Сводка» «Руководитель»|
| `Company`     | Вкладка «Сводка» «Организация» |
| `Category`    | Вкладка «Сводка» «Категория»   |
| `Keywords`    | Вкладка «Сводка» «Ключевые слова»|
| `Comments`    | Вкладка «Сводка» «Примечания»  |
| `LastAuthor`  | Вкладка «Статистика» «Кем сохранено»|
| `CreatedDate` | Вкладка «Статистика» «Создан»  |

</details>

Например, чтобы установить свойство названия рабочей книги:```js
if(!wb.Props) wb.Props = {};
wb.Props.Title = "Insert Title Here";

Писатели будут обрабатывать ключ `Props` объекта параметров:```js
/* force the Author to be "SheetJS" */
XLSX.write(wb, {Props:{Author:"SheetJS"}});

Утилиты, такие как `aoa_to_sheet`, принимают объекты ячеек вместо значений:```js
var worksheet = XLSX.utils.aoa_to_sheet([
  [ 1 ], // A1
  [ 2 ], // A2
  [ {t: "n", v: 3, f: "A1+A2"} ] // A3
]);

Если необходимы реальные результаты в JS, [SheetJS Pro](https://sheetjs.com/pro)
предлагает компонент для вычисления формул, позволяющий обрабатывать выражения,
обновлять значения и зависимые ячейки, а также пересчитывать целые книги.


**Формулы массива**

_Назначить формулу массива_```js
XLSX.utils.sheet_set_array_formula(worksheet, range, formula);

Для многоклеточной формулы массива каждая ячейка имеет один и тот же диапазон массива, но только первая ячейка задает формулу. Рассмотрим `D1:D3=A1:A3*B1:B3`:```js
// API function
XLSX.utils.sheet_set_array_formula(worksheet, "D1:D3", "A1:A3*B1:B3");

// ... OR raw operations
worksheet['D1'] = { t:'n', F:"D1:D3", f:"A1:A3*B1:B3" };
worksheet['D2'] = { t:'n', F:"D1:D3" };
worksheet['D3'] = { t:'n', F:"D1:D3" };

Опубликованные в 2020 году, динамические формулы массива поддерживаются в форматах файлов XLSX/XLSM и XLSB. Они представлены как обычные формулы массива, но имеют специальные метаданные ячейки, указывающие, что формуле должно быть разрешено корректировать диапазон.

Формула массива может быть помечена как динамическая путем установки свойства `D` ячейки в true. Ожидается диапазон `F`, но он может быть установлен на текущую ячейку:```js
// API function
XLSX.utils.sheet_set_array_formula(worksheet, "C1", "_xlfn.UNIQUE(A1:A3)", 1);

// ... OR raw operations
worksheet['C1'] = { t: "s", f: "_xlfn.UNIQUE(A1:A3)", F:"C1", D: 1 }; // dynamic

When reading a file, the `xlfn` option preserves the prefixes.

<details>
  <summary><b> Функции, требующие префикса `_xlfn.`</b> (нажмите, чтобы показать)</summary>

Этот список растёт с каждым новым выпуском Excel.```
ACOT
ACOTH
AGGREGATE
ARABIC
BASE
BETA.DIST
BETA.INV
BINOM.DIST
BINOM.DIST.RANGE
BINOM.INV
BITAND
BITLSHIFT
BITOR
BITRSHIFT
BITXOR
BYCOL
BYROW
CEILING.MATH
CEILING.PRECISE
CHISQ.DIST
CHISQ.DIST.RT
CHISQ.INV
CHISQ.INV.RT
CHISQ.TEST
COMBINA
CONFIDENCE.NORM
CONFIDENCE.T
COT
COTH
COVARIANCE.P
COVARIANCE.S
CSC
CSCH
DAYS
DECIMAL
ERF.PRECISE
ERFC.PRECISE
EXPON.DIST
F.DIST
F.DIST.RT
F.INV
F.INV.RT
F.TEST
FIELDVALUE
FILTERXML
FLOOR.MATH
FLOOR.PRECISE
FORMULATEXT
GAMMA
GAMMA.DIST
GAMMA.INV
GAMMALN.PRECISE
GAUSS
HYPGEOM.DIST
IFNA
IMCOSH
IMCOT
IMCSC
IMCSCH
IMSEC
IMSECH
IMSINH
IMTAN
ISFORMULA
ISOMITTED
ISOWEEKNUM
LAMBDA
LET
LOGNORM.DIST
LOGNORM.INV
MAKEARRAY
MAP
MODE.MULT
MODE.SNGL
MUNIT
NEGBINOM.DIST
NORM.DIST
NORM.INV
NORM.S.DIST
NORM.S.INV
NUMBERVALUE
PDURATION
PERCENTILE.EXC
PERCENTILE.INC
PERCENTRANK.EXC
PERCENTRANK.INC
PERMUTATIONA
PHI
POISSON.DIST
QUARTILE.EXC
QUARTILE.INC
QUERYSTRING
RANDARRAY
RANK.AVG
RANK.EQ
REDUCE
RRI
SCAN
SEC
SECH
SEQUENCE
SHEET
SHEETS
SKEW.P
SORTBY
STDEV.P
STDEV.S
T.DIST
T.DIST.2T
T.DIST.RT
T.INV
T.INV.2T
T.TEST
UNICHAR
UNICODE
UNIQUE
VAR.P
VAR.S
WEBSERVICE
WEIBULL.DIST
XLOOKUP
XOR
Z.TEST

_Свойства строк_

Массив `!rows` в каждом листе, если он присутствует, представляет собой коллекцию объектов `RowInfo`, обладающих следующими свойствами:```typescript
type RowInfo = {
  /* visibility */
  hidden?: boolean; // if true, the row is hidden

  /* row height is specified in one of the following ways: */
  hpx?:    number;  // height in screen pixels
  hpt?:    number;  // height in points

  level?:  number;  // 0-indexed outline / group level
};