docs.sheetjs.com/docz/docs/03-demos/17-clipboard.md

sidebar_position
17

Clipboard Data

Spreadsheet software like Excel typically support copying and pasting cells and data. This is implemented through the Clipboard ("Pasteboard" in OSX parlance).

When copying a selection of cells, Excel for Windows stores a screenshot of the selected cells as an image. It also creates and stores a number of strings and files for the various formats, including TSV, CSV, HTML, RTF, SYLK, DIF, XLSB, XLS (both '97-2004 and '95), and SpreadsheetML 2003.

Not all Clipboard APIs offer access to all clipboard types.

Browser Reading (paste)

Clipboard data can be read from a paste event, accessible from the event clipboardData property:

document.onpaste = function(e) {
  /* get TSV */
  var str = e.clipboardData.getData('text/html');
  /* parse */
  var wb = XLSX.read(str, {type: "string"});
  /* DO SOMETHING WITH wb HERE */
};

getData accepts one argument: the desired MIME type. Chrome 103 supports:

MIME type	Data format
text/plain	TSV (tab separated values)
text/html	HTML
text/rtf	RTF (rich text format)

getData returns a string compatible with the string type for XLSX.read.

Live Demo

Open a file in Excel, copy some cells, then come back to this window. Click on "RESULT" below and paste (Control+V for Windows, Command+V for Mac).

function Clipboard() {
  const [csvs, setCSVs] = React.useState([ "", "", "" ]);

  /* Set up paste handler */
  React.useEffect(async() => {
    document.onpaste = function(e) {
      /* this demo will read 3 different clipboard data types */
      var mime_arr = [ 'text/plain', 'text/html', 'text/rtf' ];
      /* get clipboard data for each type */
      var data_arr = mime_arr.map(mime => e.clipboardData.getData(mime));
      /* parse each data string into a workbook */
      var wb_arr = data_arr.map(str => XLSX.read(str, {type: "string"}));
      /* get first worksheet from each workbook */
      var ws_arr = wb_arr.map(wb => wb.Sheets[wb.SheetNames[0]]);
      /* generate CSV for each "first worksheet" */
      var result = ws_arr.map(ws => XLSX.utils.sheet_to_csv(ws));
      setCSVs(result);
    };
  }, []);

  return (
    <>
      {csvs[0] && (<pre><b>Data from clipboard TSV  (text/plain)</b><br/>{csvs[0]}</pre>)}
      {csvs[1] && (<pre><b>Data from clipboard HTML (text/html)</b><br/>{csvs[1]}</pre>)}
      {csvs[2] && (<pre><b>Data from clipboard RTF  (text/rtf)</b><br/>{csvs[2]}</pre>)}
      {csvs.every(x => !x) && <b>Copy data in Excel, click here, and paste (Control+V)</b>}
    </>
  );
}

Browser Writing (copy)

Clipboard data can be written from a copy event, accessible from the event clipboardData property:

document.oncopy = function(e) {
  /* get HTML of first worksheet in workbook */
  var str = XLSX.write(wb, {type: "string", bookType: "html"});
  /* set HTML clipboard data */
  e.clipboardData.setData('text/html', str);

  /* prevent the browser from copying the normal data */
  e.preventDefault();
};

setData accepts two arguments: MIME type and new data. Chrome 103 supports:

MIME type	Data format
text/plain	TSV (tab separated values)
text/html	HTML

Browsers do not currently support assigning to the text/rtf clipboard type.

Live Demo

This demo creates a simple workbook from the following HTML table:

SheetJS	Clipboard	Demo
bookType	RTF
source	HTML Table

Create a new file in Excel then come back to this window. Select the text below and copy (Control+C for Windows, Command+C for Mac). Go back to the excel

function Clipboard() {
  /* Set up copy handler */
  React.useEffect(async() => {
    document.oncopy = function(e) {
      /* generate workbook from table */
      var wb = XLSX.utils.table_to_book(document.getElementById("srcdata"));
      /* get HTML of first worksheet in workbook */
      var str = XLSX.write(wb, {type: "string", bookType: "html"});
      /* set HTML clipboard data */
      e.clipboardData.setData('text/html', str);
      /* prevent the browser from copying the normal data */
      e.preventDefault();
    };
  }, []);

  return (
    <b>Select this text, copy (Control+C), and paste in Excel</b>
  );
}

Electron

Electron Clipboard API supports HTML and RTF clipboards.

There are special methods for specific clipboard types:

File Type	Read Clipboard Data	Write Clipboard Data
RTF	clipboard.readRTF	clipboard.writeRTF
TSV	clipboard.readText	clipboard.writeText
HTML	clipboard.readHTML	clipboard.writeHTML

Each method operates on JS strings.

:::caution Experimental Buffer Clipboard Support

Electron additionally supports binary operations using Buffer objects. This support is considered "experimental" and is not guaranteed to work on any platform. Issues should be raised with the Electron project

On the macOS platform, some versions of Excel store a packaged file with key dyn.ah62d4qmxhk4d425try1g44pdsm11g55gsu1en5pcqzwc4y5tsz3gg3k. The package is a simple CFB file that can be parsed:

const { clipboard } = require('electron')
const XLSX = require("xlsx");
const buf = clipboard.readBuffer('dyn.ah62d4qmxhk4d425try1g44pdsm11g55gsu1en5pcqzwc4y5tsz3gg3k');
const cfb = XLSX.CFB.read(buf, {type: "buffer"});
const pkg = XLSX.CFB.find(cfb, "Package").content;
const wb = XLSX.read(pkg);

:::