_Filtering for Presidents_

データセットには、大統領になったことのない副大統領であるアーロン・バーが含まれています！

`Array#filter` は、目的の行を含む新しい配列を作成します。大統領は、`type` が `"prez"` に設定された少なくとも1期を務めました。特定の行に少なくとも1つの `"prez"` 期があるかどうかをテストするには、`Array#some` という別のネイティブJS関数があります。完全なフィルタは次のようになります：```js
const prez = raw_data.filter(row => row.terms.some(term => term.type === "prez"));

var dataset = api.list.map(function(row) {
    return {
        name: row.name.first + " " + row.name.last,
        birthday: row.bio.birthday
    };
});
``````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**

_Fixing headers_

デフォルトでは、`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" });

`rows`に対する`Array#reduce`の呼び出し一つで、最大幅を計算できます:```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>

_ファイル形式は実装の詳細です_

パーサーは、実際のXLSやXLSXファイルと同様に「HTMLとして保存されたXLS」ファイルも機能するように、一般的なスプレッドシートファイル形式の広範囲をカバーしています。

ライターは、データエコシステムとの幅広い互換性のために、多数の一般的な出力形式をサポートしています。

可能な限り、データ処理コードは関与する特定のファイル形式を気にする必要がないようにすべきです。

### JSエコシステムデモ

[`demos`ディレクトリ](https://github.com/weareu/xlsx/blob/HEAD/demos/)には以下のサンプルプロジェクトが含まれています：

**フレームワークとAPI**
- [`angularjs`](https://github.com/weareu/xlsx/blob/HEAD/demos/angular/)
- [`angular and 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 and react-native`](https://github.com/weareu/xlsx/blob/HEAD/demos/react/)
- [`vue 2.x and weex`](https://github.com/weareu/xlsx/blob/HEAD/demos/vue/)
- [`XMLHttpRequest and fetch`](https://github.com/weareu/xlsx/blob/HEAD/demos/xhr/)
- [`nodejs server`](https://github.com/weareu/xlsx/blob/HEAD/demos/server/)
- [`databases and key/value stores`](https://github.com/weareu/xlsx/blob/HEAD/demos/database/)
- [`typed arrays and math`](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 application`](https://github.com/weareu/xlsx/blob/HEAD/demos/electron/)
- [`nw.js application`](https://github.com/weareu/xlsx/blob/HEAD/demos/nwjs/)
- [`Chrome / Chromium extensions`](https://github.com/weareu/xlsx/blob/HEAD/demos/chrome/)
- [`Download a Google Sheet locally`](https://github.com/weareu/xlsx/blob/HEAD/demos/google-sheet/)
- [`Adobe ExtendScript`](https://github.com/weareu/xlsx/blob/HEAD/demos/extendscript/)
- [`Headless Browsers`](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 and other engines`](https://github.com/weareu/xlsx/blob/HEAD/demos/altjs/)
- [`"serverless" functions`](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` メソッドは、指定されたパスにあるスプレッドシートファイルの読み取りを試みます。
ブラウザは通常、この方法でのファイル読み取りを許可しません（セキュリティリスクと見なされるため）、
この方法でファイルを読み取ろうとするとエラーがスローされます。

2番目の `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");

最大限の互換性のために、`FileReader` APIを使用する必要があります：```js
function handleDrop(e) {
  e.stopPropagation(); e.preventDefault();
  var f = e.dataTransfer.files[0];
  /* f is a File */
  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(data);

    /* DO SOMETHING WITH workbook HERE */
  };
  reader.readAsArrayBuffer(f);
}
drop_dom_element.addEventListener("drop", handleDrop, false);

Chrome 76以上を対象とする現代のウェブサイトでは、`Blob#arrayBuffer` が推奨されます：```js
// XLSX is a global from the standalone script

async function handleFileAsync(e) {
  const file = e.target.files[0];
  const data = await file.arrayBuffer();
  /* data is an ArrayBuffer */
  const workbook = XLSX.read(data);

  /* DO SOMETHING WITH workbook HERE */
}
input_dom_element.addEventListener("change", handleFileAsync, false);

/* DO SOMETHING WITH workbook HERE */

[`oldie` デモ](https://github.com/weareu/xlsx/blob/HEAD/demos/oldie/) は、IE互換のフォールバックシナリオを示しています。

</details>

<details>
  <summary><b>ウェブブラウザでのファイル取得（"Ajax"）</b>（クリックして表示）</summary>

Chrome 42+を対象とする最新のウェブサイトでは、`fetch` が推奨されます。```js
// XLSX is a global from the standalone script

(async() => {
  const url = "http://oss.sheetjs.com/test_files/formula_stress_test.xlsx";
  const data = await (await fetch(url)).arrayBuffer();
  /* data is an ArrayBuffer */
  const workbook = XLSX.read(data);

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

The [`xhr` デモ](https://github.com/weareu/xlsx/blob/HEAD/demos/xhr/) には、より長い議論と追加の例が含まれています。

<http://oss.sheetjs.com/sheetjs/ajax.html> は、IE6+向けのフォールバック手法を示しています。

</details>

<details>
  <summary><b>PhotoShopまたはInDesignプラグイン内のローカルファイル</b> (クリックして表示)</summary>

`readFile`は、Photoshopおよび他のExtendScriptターゲットにおける`File`ロジックをラップします。
指定されたパスは絶対パスである必要があります。```js
#include "xlsx.extendscript.js"

/* Read test.xlsx from the Documents folder */
var workbook = XLSX.readFile(Folder.myDocuments + "/test.xlsx");

Electron APIは時間とともに変化しています。 [`electron`デモ](https://github.com/weareu/xlsx/blob/HEAD/demos/electron/)が完全な例を示し、必要なバージョン固有の設定を詳細に説明しています。

</details>

<details>
  <summary><b>React Nativeを使用したモバイルアプリでのローカルファイル</b>（クリックで表示）</summary>

[`react`デモ](https://github.com/weareu/xlsx/blob/HEAD/demos/react)にはReact Nativeアプリのサンプルが含まれています。

React Nativeはファイルシステムからファイルを読み込む方法を提供していないため、サードパーティのライブラリを使用する必要があります。以下のライブラリがテストされています：

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

`base64`エンコーディングは`base64`タイプと互換性のある文字列を返します：```js
import XLSX from "xlsx";
import { FileSystem } from "react-native-file-access";

const b64 = await FileSystem.readFile(path, "base64");
/* b64 is a base64 string */
const workbook = XLSX.read(b64, {type: "base64"});

</details>

<details>
  <summary><b>NodeJS サーバーファイルアップロード</b> (クリックして表示)</summary>

`read` は NodeJS バッファを受け入れます。  `readFile` は、[`formidable`](https://npm.im/formidable) のような HTTP POST リクエストボディパーサーによって生成されたファイルを読み取ることができます:```js
const XLSX = require("xlsx");
const http = require("http");
const formidable = require("formidable");

const server = http.createServer((req, res) => {
  const form = new formidable.IncomingForm();
  form.parse(req, (err, fields, files) => {
    /* grab the first file */
    const f = Object.entries(files)[0][1];
    const path = f.filepath;
    const workbook = XLSX.readFile(path);

    /* DO SOMETHING WITH workbook HERE */
  });
}).listen(process.env.PORT || 7262);

より広い互換性のために、サードパーティモジュールが推奨されます。

[`request`](https://npm.im/request) は、Buffersを生成するために `null` エンコーディングを必要とします:```js
var XLSX = require("xlsx");
var request = require("request");

request({url: url, encoding: null}, function(err, resp, body) {
  var workbook = XLSX.read(body);

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

</details>

<details>
  <summary><b>Electronアプリでファイルをダウンロードする</b>（クリックして表示）</summary>

メインプロセスの `net` モジュールを使用すると、外部リソースに対して HTTP/HTTPS リクエストを送信できます。
レスポンスは `Buffer.concat` を使用して手動で連結する必要があります。```js
const XLSX = require("xlsx");
const { net } = require("electron");

const req = net.request(url);
req.on("response", (res) => {
  const bufs = []; // this array will collect all of the buffers
  res.on("data", (chunk) => { bufs.push(chunk); });
  res.on("end", () => {
    const workbook = XLSX.read(Buffer.concat(bufs));

    /* DO SOMETHING WITH workbook HERE */
  });
});
req.end();

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

</details>

<details>
  <summary><b>ブラウザでのReadableStream</b>（クリックで表示）</summary>

`ReadableStream`を扱う場合、最も簡単な方法はストリームをバッファリングし、
最後に全体を処理することです：```js
// XLSX is a global from the standalone script

async function process_RS(stream) {
  /* collect data */
  const buffers = [];
  const reader = stream.getReader();
  for(;;) {
    const res = await reader.read();
    if(res.value) buffers.push(res.value);
    if(res.done) break;
  }

  /* concat */
  const out = new Uint8Array(buffers.reduce((acc, v) => acc + v.length, 0));

  let off = 0;
  for(const u8 of arr) {
    out.set(u8, off);
    off += u8.length;
  }

  return out;
}

const data = await process_RS(stream);
/* data is Uint8Array */
const workbook = XLSX.read(data);

The [`array` demo](https://github.com/weareu/xlsx/blob/HEAD/demos/array/) shows a complete example.

</details>


### HTMLテーブルの処理

**API**

_ページ内のHTML TABLEをスクレイピングしてワークシートを作成する_```js
var worksheet = XLSX.utils.table_to_sheet(dom_element, opts);

The `table_to_book` ユーティリティ関数は `table_to_sheet` と同じロジックに従います。
ワークシートを生成した後、空のワークブックを作成し、スプレッドシートを追加します。

options 引数は、`table_to_sheet` と同じオプションをサポートし、さらにワークシート名を制御する `sheet` プロパティが追加されています。このプロパティがない場合、またはオプションが指定されていない場合、デフォルトの名前 `Sheet1` が使用されます。

**例**

以下はよくあるシナリオです（各サブタイトルをクリックするとコードが表示されます）:

<details>
  <summary><b>ウェブページ内のHTML TABLE要素</b> (クリックして表示)</summary>```html
<!-- include the standalone script and shim.  this uses the UNPKG CDN -->
<script src="https://unpkg.com/xlsx/dist/shim.min.js"></script>
<script src="https://unpkg.com/xlsx/dist/xlsx.full.min.js"></script>

<!-- example table with id attribute -->
<table id="tableau">
  <tr><td>Sheet</td><td>JS</td></tr>
  <tr><td>12345</td><td>67</td></tr>
</table>

<!-- this block should appear after the table HTML and the standalone script -->
<script type="text/javascript">
  var workbook = XLSX.utils.table_to_book(document.getElementById("tableau"));

  /* DO SOMETHING WITH workbook HERE */
</script>

または、HTMLコードを抽出して解析することもできます：```js
var htmlstr = document.getElementById("tableau").outerHTML;
var workbook = XLSX.read(htmlstr, {type:"string"});

</details>

<details>
  <summary><b>ヘッドレスChromeを使用したサーバーサイドHTMLテーブル</b>（クリックして表示）</summary>

[`headless` デモ](https://github.com/weareu/xlsx/blob/HEAD/demos/headless/) には、HTMLファイルをXLSBワークブックに変換する完全なデモが含まれています。中核となるアイデアは、ページにスクリプトを追加し、ページコンテキストでテーブルを解析し、`base64` ワークブックを生成して、さらなる処理のために送り返すことです。```js
const XLSX = require("xlsx");
const { readFileSync } = require("fs"), puppeteer = require("puppeteer");

const url = `https://sheetjs.com/demos/table`;

/* get the standalone build source (node_modules/xlsx/dist/xlsx.full.min.js) */
const lib = readFileSync(require.resolve("xlsx/dist/xlsx.full.min.js"), "utf8");

(async() => {
  /* start browser and go to web page */
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto(url, {waitUntil: "networkidle2"});

  /* inject library */
  await page.addScriptTag({content: lib});

  /* this function `s5s` will be called by the script below, receiving the Base64-encoded file */
  await page.exposeFunction("s5s", async(b64) => {
    const workbook = XLSX.read(b64, {type: "base64" });

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

  /* generate XLSB file in webpage context and send back result */
  await page.addScriptTag({content: `
    /* call table_to_book on first table */
    var workbook = XLSX.utils.table_to_book(document.querySelector("TABLE"));

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

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

  /* cleanup */
  await browser.close();
})();

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

phantom.exit();

</details>

<details>
  <summary><b>ブラウザなしのNodeJS HTMLテーブル</b>（クリックして表示）</summary>

NodeJSにはDOM実装が含まれておらず、Puppeteerには大規模なChromiumビルドが必要です。[`jsdom`](https://npm.im/jsdom)は軽量な代替手段です:```js
const XLSX = require("xlsx");
const { readFileSync } = require("fs");
const { JSDOM } = require("jsdom");

/* obtain HTML string.  This example reads from test.html */
const html_str = fs.readFileSync("test.html", "utf8");
/* get first TABLE element */
const doc = new JSDOM(html_str).window.document.querySelector("table");
/* generate workbook */
const workbook = XLSX.utils.table_to_book(doc);