getUsedRange

await crafttechApi.getUsedRange(fileHandler, sheetName);

Описание

Возвращает информацию о полном диапазоне ячеек, в которых есть значения во всем листе.

Параметры

• fileHandler (number) — ссылка на файл; ссылку предоставляет метод openFile;
• sheetName (string) — название листа.

Возвращает

• usedRange (object) — объект с полями:
  • range — это строка с диапазоном в формате A1:B300;
  • firstIndex — это массив длиной 2, где первый элемент — номер строки первой ячейки со значением, а второй элемент — номер столбца первой ячейки со значением;
  • lastIndex — это массив длиной 2, где первый элемент — номер строки последней ячейки со значением, а второй элемент — номер столбца последней ячейки со значением.

{
   range: 'A1:B300',
   firstIndex: [1,1],
   lastIndex: [29,10]
}

Пример

const fileHandler = await crafttechApi.openFile("book.xlsx");
const range = await crafttechApi.getUsedRange(fileHandler, "Лист1");
console.log("Информация об использованных ячейках: ", range);