_Filtering for Presidents_

데이터셋에는 대통령이었던 적이 없는 부통령 Aaron Burr가 포함되어 있습니다!

`Array#filter`는 원하는 행만 포함된 새 배열을 생성합니다. 대통령은
`type`이 `"prez"`로 설정된 임기를 최소 한 번 이상 수행했습니다. 특정 행에
`"prez"` 임기가 하나 이상 있는지 확인하려면, `Array#some`이라는 또 다른 네이티브 JS 함수를 사용합니다.
전체 필터는 다음과 같습니다:```js
const prez = raw_data.filter(row => row.terms.some(term => term.type === "prez"));

결과는 중첩이 없는 "단순한" 객체들의 배열입니다:```js
[
  { name: "George Washington", birthday: "1732-02-22" },
  { name: "John Adams", birthday: "1735-10-19" },
  // ... one row per President
]

`XLSX.utils.book_new`은 새 통합 문서를 만들고 `XLSX.utils.book_append_sheet`는 워크시트를 통합 문서에 추가합니다. 새 워크시트의 이름은 "Dates"가 됩니다:```js
const workbook = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(workbook, worksheet, "Dates");

_열 너비 수정_

일부 이름은 기본 열 너비보다 깁니다.  열 너비는
[`"!cols"` 워크시트 속성 설정](#row-and-column-properties)으로 지정합니다.

다음 줄은 A 열의 너비를 약 10자로 설정합니다:```js
worksheet["!cols"] = [ { wch: 10 } ]; // set column A width to 10 characters

참고: 시작 지점이 파일이나 HTML 테이블인 경우, `XLSX.utils.sheet_to_json`은 JS 객체 배열을 생성합니다.

**패키지 및 릴리스 데이터**

`XLSX.writeFile`은 스프레드시트 파일을 생성하고 시스템에 쓰기를 시도합니다.
브라우저에서는 사용자에게 파일 다운로드를 요청하는 프롬프트를 표시하려고 합니다.  NodeJS에서는 로컬 디렉터리에 씁니다.```js
XLSX.writeFile(workbook, "Presidents.xlsx");

웹 브라우저에서 사용하려면, 스니펫이 `snippet.js`에 저장되어 있다고 가정할 때, `axios` 및 `xlsx` 독립 실행형 빌드를 포함하려면 script 태그를 사용해야 합니다:```html
<script src="https://unpkg.com/xlsx/dist/xlsx.full.min.js"></script>
<script src="https://unpkg.com/axios/dist/axios.min.js"></script>
<script src="snippet.js"></script>

Node ESM에서는 `readFile` 헬퍼가 활성화되지 않습니다. 대신 `fs.readFileSync`
를 사용하여 파일 데이터를 `Buffer`로 읽은 후 `XLSX.read`와 함께 사용해야 합니다:```js
import { readFileSync } from "fs";
import { read } from "xlsx/xlsx.mjs";

const buf = readFileSync("test.xlsx");
/* buf is a Buffer */
const workbook = read(buf);

파일을 읽는 애플리케이션은 `--allow-read` 플래그를 지정하여 호출해야 합니다.
[`deno` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/deno/)에 더 많은 예제가 있습니다.

</details>

<details>
  <summary><b>웹 페이지에서 사용자가 제출한 파일("드래그 앤 드롭")</b> (클릭하여 표시)</summary>

Chrome 76+를 대상으로 하는 최신 웹사이트의 경우 `File#arrayBuffer`가 권장됩니다:```js
// XLSX is a global from the standalone script

async function handleDropAsync(e) {
  e.stopPropagation(); e.preventDefault();
  const f = e.dataTransfer.files[0];
  /* f is a File */
  const data = await f.arrayBuffer();
  /* data is an ArrayBuffer */
  const workbook = XLSX.read(data);

  /* DO SOMETHING WITH workbook HERE */
}
drop_dom_element.addEventListener("drop", handleDropAsync, false);

/* DO SOMETHING WITH workbook HERE */

<https://oss.sheetjs.com/sheetjs/>는 FileReader 기법을 보여줍니다.

</details>

<details>
  <summary><b>HTML INPUT 요소가 포함된 사용자 제출 파일</b> (클릭하여 표시)</summary>

`type="file"` 속성을 가진 HTML INPUT 요소로 시작합니다:```html
<input type="file" id="input_dom_element">

더 광범위한 지원(IE10+ 포함)을 위해서는 `FileReader` 접근 방식이 권장됩니다:```js
function handleFile(e) {
  var file = e.target.files[0];
  var reader = new FileReader();
  reader.onload = function(e) {
    var data = e.target.result;
    /* reader.readAsArrayBuffer(file) -> data will be an ArrayBuffer */
    var workbook = XLSX.read(e.target.result);

    /* DO SOMETHING WITH workbook HERE */
  };
  reader.readAsArrayBuffer(file);
}
input_dom_element.addEventListener("change", handleFile, false);

더 광범위한 지원을 위해 `XMLHttpRequest` 접근 방식을 권장합니다:```js
var url = "http://oss.sheetjs.com/test_files/formula_stress_test.xlsx";

/* set up async GET request */
var req = new XMLHttpRequest();
req.open("GET", url, true);
req.responseType = "arraybuffer";

req.onload = function(e) {
  var workbook = XLSX.read(req.response);

  /* DO SOMETHING WITH workbook HERE */
};

req.send();

The [`extendscript` demo](https://github.com/weareu/xlsx/blob/HEAD/demos/extendscript/) includes a more complex example.

</details>

<details>
  <summary><b>Electron 앱의 로컬 파일</b> (클릭하여 표시)</summary>

`readFile`은(는) 렌더러 프로세스에서 사용할 수 있습니다:```js
/* From the renderer process */
var XLSX = require("xlsx");

var workbook = XLSX.readFile(path);

- [`react-native-fs`](https://npm.im/react-native-fs)

`ascii` 인코딩은 `binary` 타입과 호환되는 바이너리 문자열을 반환합니다.```js
import XLSX from "xlsx";
import { readFile } from "react-native-fs";

const bstr = await readFile(path, "ascii");
/* bstr is a binary string */
const workbook = XLSX.read(bstr, {type: "binary"});

/* DO SOMETHING WITH workbook HERE */

[`server` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/server)에는 더 고급 예제가 있습니다.

</details>

<details>
  <summary><b>NodeJS 프로세스에서 파일 다운로드</b> (클릭하여 표시)</summary>

Node 17.5 및 18.0은 fetch를 기본 지원합니다:```js
const XLSX = require("xlsx");

const data = await (await fetch(url)).arrayBuffer();
/* data is an ArrayBuffer */
const workbook = XLSX.read(data);

[`axios`](https://npm.im/axios) 브라우저와 NodeJS에서 동일한 방식으로 작동합니다:```js
const XLSX = require("xlsx");
const axios = require("axios");

(async() => {
  const res = await axios.get(url, {responseType: "arraybuffer"});
  /* res.data is a Buffer */
  const workbook = XLSX.read(res.data);

  /* DO SOMETHING WITH workbook HERE */
})();

/* DO SOMETHING WITH workbook HERE */

</details>

<details>
  <summary><b>NodeJS의 Readable Streams</b> (클릭하여 표시)</summary>

Readable Streams를 다룰 때 가장 쉬운 방법은 스트림을 버퍼링하고
마지막에 전체를 처리하는 것입니다:```js
var fs = require("fs");
var XLSX = require("xlsx");

function process_RS(stream, cb) {
  var buffers = [];
  stream.on("data", function(data) { buffers.push(data); });
  stream.on("end", function() {
    var buffer = Buffer.concat(buffers);
    var workbook = XLSX.read(buffer, {type:"buffer"});

    /* DO SOMETHING WITH workbook IN THE CALLBACK */
    cb(workbook);
  });
}

</details>

더 자세한 예제는 [포함된 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/)에서 다룹니다.

### JSON 및 JS 데이터 처리

JSON 및 JS 데이터는 일반적으로 단일 워크시트를 나타냅니다.  이 섹션에서는
워크북을 생성하기 위한 몇 가지 유틸리티 함수를 사용합니다.

_새 Workbook 만들기_```js
var workbook = XLSX.utils.book_new();

`aoa_to_sheet` 유틸리티 함수는 "배열의 배열"을 행 우선 순서로 탐색하여 워크시트 객체를 생성합니다. 다음 스니펫은 셀 `A1`이 문자열 `A1`로 설정되고, 셀 `B1`이 `B1`로 설정되는 식으로 시트를 생성합니다:```js
var worksheet = XLSX.utils.aoa_to_sheet([
  ["A1", "B1", "C1"],
  ["A2", "B2", "C2"],
  ["A3", "B3", "C3"]
]);

`json_to_sheet` 유틸리티 함수는 JS 객체 배열을 순서대로 순회하며 워크시트 객체를 생성합니다. 기본적으로 헤더 행과 배열의 객체마다 한 행씩 생성합니다. 선택적 `opts` 인수에는 열 순서와 헤더 출력을 제어하는 설정이 있습니다.

["객체 배열 입력"](#array-of-arrays-input)은 이 함수와 선택적 `opts` 인수에 대해 자세히 설명합니다.

**예제**

["SheetJS의 정수"](#the-zen-of-sheetjs)에는 "JSON 엔드포인트에서 데이터를 가져와 워크북 생성"에 대한 자세한 예제가 포함되어 있습니다.

[`x-spreadsheet`](https://github.com/myliang/x-spreadsheet)는 웹 브라우저에서 구조화된 데이터를 미리 보고 수정할 수 있는 대화형 데이터 그리드입니다. [`xspreadsheet` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/xspreadsheet)에는 x-spreadsheet 데이터 객체를 워크북으로 변환하는 `xtos` 함수가 포함된 샘플 스크립트가 있습니다. <https://oss.sheetjs.com/sheetjs/x-spreadsheet>는 라이브 데모입니다.

<details>
  <summary><b>데이터베이스 쿼리(SQL 또는 no-SQL)의 레코드</b> (클릭하여 표시)</summary>

[`database` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/database/)에는 데이터베이스 및 쿼리 결과 작업 예제가 포함되어 있습니다.

</details>


<details>
  <summary><b>TensorFlow.js를 사용한 수치 계산</b> (클릭하여 표시)</summary>

[`@tensorflow/tfjs`](https://github.com/weareu/xlsx/blob/HEAD/@tensorflow/tfjs) 및 기타 라이브러리는 데이터가 단순 배열 형태로 제공되기를 기대하며, 이는 각 열이 데이터 벡터인 워크시트에 적합합니다. 이는 대부분의 사람들이 각 행을 벡터로 사용하는 스프레드시트 사용 방식의 전치입니다.

`tfjs`에서 데이터를 가져올 때 반환된 데이터 포인트는 형식화 배열에 저장됩니다. 배열의 배열은 루프로 구성할 수 있습니다. `Array#unshift`는 변환 전에 제목 행을 앞에 추가할 수 있습니다:```js
const XLSX = require("xlsx");
const tf = require('@tensorflow/tfjs');

/* suppose xs and ys are vectors (1D tensors) -> tfarr will be a typed array */
const tfdata = tf.stack([xs, ys]).transpose();
const shape = tfdata.shape;
const tfarr = tfdata.dataSync();

/* construct the array of arrays */
const aoa = [];
for(let j = 0; j < shape[0]; ++j) {
  aoa[j] = [];
  for(let i = 0; i < shape[1]; ++i) aoa[j][i] = tfarr[j * shape[1] + i];
}
/* add headers to the top */
aoa.unshift(["x", "y"]);

/* generate worksheet */
const worksheet = XLSX.utils.aoa_to_sheet(aoa);

웹 페이지의 여러 테이블은 각각 개별 워크시트로 변환할 수 있습니다:```js
/* create new workbook */
var workbook = XLSX.utils.book_new();

/* convert table "table1" to worksheet named "Sheet1" */
var sheet1 = XLSX.utils.table_to_sheet(document.getElementById("table1"));
XLSX.utils.book_append_sheet(workbook, sheet1, "Sheet1");

/* convert table "table2" to worksheet named "Sheet2" */
var sheet2 = XLSX.utils.table_to_sheet(document.getElementById("table2"));
XLSX.utils.book_append_sheet(workbook, sheet2, "Sheet2");

/* workbook now has 2 worksheets */

</details>

<details>
  <summary><b>Chrome/Chromium 확장 프로그램</b> (표시하려면 클릭)</summary>

[`chrome` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/chrome/)는 완전한 예제를 보여주며 필요한 권한과
기타 설정을 자세히 설명합니다.

확장 프로그램에서는 콘텐츠 스크립트에서 워크북을 생성한 후
그 객체를 확장 프로그램으로 다시 전달하는 것이 권장됩니다:```js
/* in the worker script */
chrome.runtime.onMessage.addListener(function(msg, sender, cb) {
  /* pass a message like { sheetjs: true } from the extension to scrape */
  if(!msg || !msg.sheetjs) return;
  /* create a new workbook */
  var workbook = XLSX.utils.book_new();
  /* loop through each table element */
  var tables = document.getElementsByTagName("table")
  for(var i = 0; i < tables.length; ++i) {
    var worksheet = XLSX.utils.table_to_sheet(tables[i]);
    XLSX.utils.book_append_sheet(workbook, worksheet, "Table" + i);
  }
  /* pass back to the extension */
  return cb(workbook);
});

/* DO SOMETHING WITH workbook HERE */

/* generate XLSX file */
var b64 = XLSX.write(workbook, {type: "base64", bookType: "xlsb"});

/* call "s5s" hook exposed from the node process */
window.s5s(b64);

</details>

<details>
  <summary><b>Headless WebKit을 사용한 서버 측 HTML 테이블</b> (클릭하여 표시)</summary>

[`headless` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/headless/)는 HTML 파일을 XLSB 통합 문서로 변환하는 완전한
데모를 포함하며, [PhantomJS](https://phantomjs.org/)를 사용합니다. 핵심 아이디어는
페이지에 스크립트를 추가하고, 페이지 컨텍스트에서 테이블을 파싱하고, `binary`
통합 문서를 생성한 다음 추가 처리를 위해 다시 보내는 것입니다:```js
var XLSX = require('xlsx');
var page = require('webpage').create();

/* this code will be run in the page */
var code = [ "function(){",
  /* call table_to_book on first table */
  "var wb = XLSX.utils.table_to_book(document.body.getElementsByTagName('table')[0]);",

  /* generate XLSB file and return binary string */
  "return XLSX.write(wb, {type: 'binary', bookType: 'xlsb'});",
"}" ].join("");

page.open('https://sheetjs.com/demos/table', function() {
  /* Load the browser script from the UNPKG CDN */
  page.includeJs("https://unpkg.com/xlsx/dist/xlsx.full.min.js", function() {
    /* The code will return an XLSB file encoded as binary string */
    var bin = page.evaluateJavaScript(code);

    var workbook = XLSX.read(bin, {type: "binary"});
    /* DO SOMETHING WITH workbook HERE */

    phantom.exit();
  });
});

</details>

## 데이터 처리

["공통 스프레드시트 형식"](#common-spreadsheet-format)은 워크북의 핵심 개념을 단순한 객체로
표현한 것입니다.  유틸리티 함수는 객체 표현과 함께 작동하며
일반적인 사용 사례를 처리하기 위한 것입니다.

### 워크북 구조 수정

**API**

_워크북에 워크시트 추가_```js
XLSX.utils.book_append_sheet(workbook, worksheet, sheet_name);

네 번째 인수가 `true`이면 함수는 지정된
워크시트 이름으로 시작합니다.  워크북에 해당 시트 이름이 이미 있으면 새 워크시트 이름은
이름의 어간을 찾아 카운터를 증가시켜 선택합니다:```js
XLSX.utils.book_append_sheet(workbook, sheetA, "Sheet2", true); // Sheet2
XLSX.utils.book_append_sheet(workbook, sheetB, "Sheet2", true); // Sheet3
XLSX.utils.book_append_sheet(workbook, sheetC, "Sheet2", true); // Sheet4
XLSX.utils.book_append_sheet(workbook, sheetD, "Sheet2", true); // Sheet5

The `SheetNames` 속성은 workbook 객체의 워크시트 이름을 "탭 순서"대로 나열한 목록입니다. API 함수는 이 배열을 참조합니다.

_워크시트를 제자리에서 교체하기_```js
workbook.Sheets[sheet_name] = new_worksheet;

Node ESM의 경우 `writeFile` 헬퍼는 활성화되어 있지 않습니다. 대신 `fs.writeFileSync`를
사용하여 파일 데이터를 `Buffer`에 기록한 후 `XLSX.write`와 함께 사용해야 합니다:```js
import { writeFileSync } from "fs";
import { write } from "xlsx/xlsx.mjs";

const buf = write(workbook, {type: "buffer", bookType: "xlsb"});
/* buf is a Buffer */
const workbook = writeFileSync("out.xlsb", buf);

파일을 작성하는 애플리케이션은 `--allow-write` 플래그와 함께 호출되어야 합니다.  해당
[`deno` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/deno/)에 더 많은 예제가 있습니다

</details>

<details>
  <summary><b>PhotoShop 또는 InDesign 플러그인의 로컬 파일</b> (클릭하여 표시)</summary>

`writeFile`는 Photoshop 및 기타 ExtendScript 대상에서 `File` 로직을 래핑합니다.
지정된 경로는 절대 경로여야 합니다:```js
#include "xlsx.extendscript.js"

/* output format determined by filename */
XLSX.writeFile(workbook, "out.xlsx");
/* at this point, out.xlsx is a file that you can distribute */

</details>

<details>
  <summary><b>레거시 브라우저에서 파일 다운로드</b> (클릭하여 표시)</summary>

`XLSX.writeFile` 기법은 대부분의 최신 브라우저와 구형 IE에서도 작동합니다.
훨씬 오래된 브라우저의 경우 래퍼 라이브러리에서 구현한 우회 방법이 있습니다.

[`FileSaver.js`](https://github.com/eligrey/FileSaver.js/)는 `saveAs`를 구현합니다.
참고: `XLSX.writeFile`은 사용 가능한 경우 `saveAs`를 자동으로 호출합니다.```js
/* bookType can be any supported output type */
var wopts = { bookType:"xlsx", bookSST:false, type:"array" };

var wbout = XLSX.write(workbook,wopts);

/* the saveAs call downloads a file on the local machine */
saveAs(new Blob([wbout],{type:"application/octet-stream"}), "test.xlsx");

[`oldie` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/oldie/)는 IE 호환 대체 시나리오를 보여줍니다.

</details>

<details>
  <summary><b>브라우저 파일 업로드 (ajax)</b> (클릭하여 표시)</summary>

XHR을 사용하는 완전한 예제는 [XHR 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/xhr/)에 포함되어 있으며, fetch 및
래퍼 라이브러리에 대한 예제도 함께 있습니다. 이 예제는 서버가 Base64로 인코딩된
파일을 처리할 수 있다고 가정합니다 (기본 nodejs 서버는 데모를 참조하세요):```js
/* in this example, send a base64 string to the server */
var wopts = { bookType:"xlsx", bookSST:false, type:"base64" };

var wbout = XLSX.write(workbook,wopts);

var req = new XMLHttpRequest();
req.open("POST", "/upload", true);
var formdata = new FormData();
formdata.append("file", "test.xlsx"); // <-- server expects `file` to hold name
formdata.append("data", wbout); // <-- `data` holds the base64-encoded data
req.send(formdata);

참고: ["HTML 테이블 처리"](#processing-html-tables) 섹션은 "Headless WebKit"의 페이지에 있는 HTML 테이블에서 워크북을 생성하는 방법을 보여줍니다.

</details>



[포함된 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/)는 모바일 앱 및 기타 특수 배포를 다룹니다.

### 쓰기 예제

- <http://sheetjs.com/demos/table.html> HTML 테이블 내보내기
- <http://sheetjs.com/demos/writexlsx.html> 간단한 파일 생성

### 스트리밍 쓰기

스트리밍 쓰기 함수는 `XLSX.stream` 객체에서 사용할 수 있습니다.  일반 쓰기 함수와 동일한 인수를 사용하지만 NodeJS Readable Stream을 반환합니다.

- `XLSX.stream.to_csv`는 `XLSX.utils.sheet_to_csv`의 스트리밍 버전입니다.
- `XLSX.stream.to_html`는 `XLSX.utils.sheet_to_html`의 스트리밍 버전입니다.
- `XLSX.stream.to_json`는 `XLSX.utils.sheet_to_json`의 스트리밍 버전입니다.

<details>
  <summary><b>nodejs에서 CSV로 변환하고 파일로 쓰기</b> (클릭하여 표시)</summary>```js
var output_file_name = "out.csv";
var stream = XLSX.stream.to_csv(worksheet);
stream.pipe(fs.createWriteStream(output_file_name));

</details>

<details>
  <summary><b>NUMBERS 파일 내보내기</b> (클릭하여 표시)</summary>

NUMBERS 작성기에는 상당히 큰 기반이 필요합니다.  추가 `xlsx.zahl`
스크립트가 지원을 제공합니다.  `xlsx.zahl.js`는 단독 실행 및 NodeJS
사용을 위해 설계되었으며, `xlsx.zahl.mjs`는 ESM에 적합합니다.

_브라우저_```html
<meta charset="utf8">
<script src="xlsx.full.min.js"></script>
<script src="xlsx.zahl.js"></script>
<script>
var wb = XLSX.utils.book_new(); var ws = XLSX.utils.aoa_to_sheet([
  ["SheetJS", "<3","விரிதாள்"],
  [72,,"Arbeitsblätter"],
  [,62,"数据"],
  [true,false,],
]); XLSX.utils.book_append_sheet(wb, ws, "Sheet1");
XLSX.writeFile(wb, "textport.numbers", {numbers: XLSX_ZAHL, compression: true});
</script>

_Deno_```ts
import * as XLSX from './xlsx.mjs';
import XLSX_ZAHL from './dist/xlsx.zahl.mjs';

var wb = XLSX.utils.book_new(); var ws = XLSX.utils.aoa_to_sheet([
  ["SheetJS", "<3","விரிதாள்"],
  [72,,"Arbeitsblätter"],
  [,62,"数据"],
  [true,false,],
]); XLSX.utils.book_append_sheet(wb, ws, "Sheet1");
XLSX.writeFile(wb, "textports.numbers", {numbers: XLSX_ZAHL, compression: true});

/* use sheet_to_json with header: 1 to generate an array of arrays */
const data = utils.sheet_to_json(wb.Sheets[wb.SheetNames[0]], { header: 1 });

/* see react-data-grid docs to understand the shape of the expected data */
setColumns(data[0].map((r) => ({ key: r, name: r })));
setRows(data.slice(1).map((r) => r.reduce((acc, x, i) => {
  acc[data[0][i]] = x;
  return acc;
}, {})));

</details>

<details>
  <summary><b>VueJS 데이터 그리드에서 데이터 미리 보기</b> (클릭하여 표시)</summary>

[`vue3-table-lite`](https://github.com/linmasahiro/vue3-table-lite)는 간단한
VueJS 3 데이터 테이블입니다. [VueJS 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/vue/modify/)에서 소개됩니다.

</details>

<details>
  <summary><b>데이터베이스 채우기 (SQL 또는 no-SQL)</b> (클릭하여 표시)</summary>

[`database` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/database/)에는 데이터베이스 및 쿼리 결과를
다루는 예제가 포함되어 있습니다.

</details>

<details>
  <summary><b>TensorFlow.js를 사용한 수치 계산</b> (클릭하여 표시)</summary>

[`@tensorflow/tfjs`](https://github.com/weareu/xlsx/blob/HEAD/@tensorflow/tfjs) 및 기타 라이브러리는 단순한 배열의 데이터를
기대하며, 각 열이 데이터 벡터인 워크시트에 적합합니다. 이는 대부분의 사람들이
스프레드시트를 사용하는 방식(각 행이 벡터)의 전치입니다.

단일 `Array#map`으로 `sheet_to_json` 내보내기에서 개별 이름이 지정된 행을 가져올 수 있습니다:```js
const XLSX = require("xlsx");
const tf = require('@tensorflow/tfjs');

const key = "age"; // this is the field we want to pull
const ages = XLSX.utils.sheet_to_json(worksheet).map(r => r[key]);
const tf_data = tf.tensor1d(ages);

[`array` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/array/)는 완전한 예제를 보여줍니다.

</details>


### HTML 테이블 생성

**API**

_워크시트에서 HTML 테이블 생성_```js
var html = XLSX.utils.sheet_to_html(worksheet);

`fetch`와 결합하면, 워크북에서 사이트를 구축하는 것은 간단합니다:

<details>
  <summary><b>바닐라 JS + HTML로 워크북을 fetch하고 테이블 미리보기 생성하기</b> (클릭하여 표시)</summary>```html
<body>
  <style>TABLE { border-collapse: collapse; } TD { border: 1px solid; }</style>
  <div id="tavolo"></div>
  <script src="https://unpkg.com/xlsx/dist/xlsx.full.min.js"></script>
  <script type="text/javascript">
(async() => {
  /* fetch and parse workbook -- see the fetch example for details */
  const workbook = XLSX.read(await (await fetch("sheetjs.xlsx")).arrayBuffer());

  let output = [];
  /* loop through the worksheet names in order */
  workbook.SheetNames.forEach(name => {

    /* generate HTML from the corresponding worksheets */
    const worksheet = workbook.Sheets[name];
    const html = XLSX.utils.sheet_to_html(worksheet);

    /* add a header with the title name followed by the table */
    output.push(`<H3>${name}</H3>${html}`);
  });
  /* write to the DOM at the end */
  tavolo.innerHTML = output.join("\n");
})();
  </script>
</body>

[`react` 데모](https://github.com/weareu/xlsx/blob/HEAD/demos/react)에는 더 많은 React 예제가 포함되어 있습니다.

</details>

<details>
  <summary><b>VueJS fetch 워크북 및 HTML 테이블 미리보기 생성</b> (클릭하여 표시)</summary>

일반적으로 VueJS에 적합한 워크플로우를 사용하는 것이 권장되지만, `v-html` 디렉티브를 사용하여 HTML을 생성하고 VueJS에서 사용하는 것도 가능합니다:```jsx
import { read, utils } from 'xlsx';
import { reactive } from 'vue';

const S5SComponent = {
  mounted() { (async() => {
    /* fetch and parse workbook -- see the fetch example for details */
    const workbook = read(await (await fetch("sheetjs.xlsx")).arrayBuffer());
    /* loop through the worksheet names in order */
    workbook.SheetNames.forEach(name => {
      /* generate HTML from the corresponding worksheets */
      const html = utils.sheet_to_html(workbook.Sheets[name]);
      /* add to state */
      this.wb.wb.push({ name, html });
    });
  })(); },
  /* this state mantra is required for array updates to work */
  setup() { return { wb: reactive({ wb: [] }) }; },
  template: `
  <div v-for="ws in wb.wb" :key="ws.name">
    <h3>{{ ws.name }}</h3>
    <div v-html="ws.html"></div>
  </div>`
};

</details>

### 시트 객체

`!`로 시작하지 않는 각 키는 셀에 매핑됩니다(`A-1` 표기법 사용).

`sheet[address]`는 지정된 주소의 셀 객체를 반환합니다.

**특수 시트 키(`sheet[key]`로 접근 가능, 각각 `!`로 시작):**

- `sheet['!ref']`: 시트 범위를 나타내는 A-1 기반 범위입니다. 시트를 다루는
  함수는 이 매개변수를 사용하여 범위를 결정해야 합니다. 범위 밖에 할당된
  셀은 처리되지 않습니다. 특히, 시트를 수동으로 작성할 때 범위 밖의 셀은
  포함되지 않습니다

  시트를 처리하는 함수는 `!ref` 필드의 존재 여부를 확인해야 합니다.
  `!ref`가 생략되었거나 유효한 범위가 아닌 경우, 함수는 시트를 빈 것으로
  취급하거나 범위를 추측할 수 있습니다. 이 라이브러리와 함께 제공되는 표준
  유틸리티는 시트를 빈 것으로 취급합니다(예: CSV 출력은 빈 문자열입니다).

  `sheetRows` 속성이 설정된 워크시트를 읽을 때, ref 매개변수는 제한된 범위를
  사용합니다. 원래 범위는 `ws['!fullref']`에 설정됩니다.

- `sheet['!margins']`: 페이지 여백을 나타내는 객체입니다. 기본값은 Excel의
  "normal" 프리셋을 따릅니다. Excel에는 "wide" 및 "narrow" 프리셋도 있지만
  원시 측정값으로 저장됩니다. 주요 속성은 아래에 나열되어 있습니다:

<details>
  <summary><b>페이지 여백 세부 정보</b> (클릭하여 표시)</summary>

| 키       | 설명                   | "normal" | "wide" | "narrow" |
|----------|------------------------|:---------|:-------|:-------- |
| `left`   | 왼쪽 여백(인치)        | `0.7`    | `1.0`  | `0.25`   |
| `right`  | 오른쪽 여백(인치)      | `0.7`    | `1.0`  | `0.25`   |
| `top`    | 위쪽 여백(인치)        | `0.75`   | `1.0`  | `0.75`   |
| `bottom` | 아래쪽 여백(인치)      | `0.75`   | `1.0`  | `0.75`   |
| `header` | 머리글 여백(인치)      | `0.3`    | `0.5`  | `0.3`    |
| `footer` | 바닥글 여백(인치)      | `0.3`    | `0.5`  | `0.3`    |```js
/* Set worksheet sheet to "normal" */
ws["!margins"]={left:0.7, right:0.7, top:0.75,bottom:0.75,header:0.3,footer:0.3}
/* Set worksheet sheet to "wide" */
ws["!margins"]={left:1.0, right:1.0, top:1.0, bottom:1.0, header:0.5,footer:0.5}
/* Set worksheet sheet to "narrow" */
ws["!margins"]={left:0.25,right:0.25,top:0.75,bottom:0.75,header:0.3,footer:0.3}