Excel-zu-JSON-Konverter

Moderne .xlsx-Arbeitsmappen sind SpreadsheetML-Dateien, definiert durch ECMA-376 / ISO/IEC 29500 (der Office-Open-XML-Standard): Die .xlsx-Erweiterung ist ein ZIP-Container, dessen Einträge XML-Dokumente unter xl/worksheets/sheetN.xml sind, wobei Zeichenfolgen in einer gemeinsamen Zeichentabelle xl/sharedStrings.xml gespeichert und Zellentypen durch das t-Attribut deklariert werden (s = SharedString, n = Number, b = Boolean, str = Inline-String, d = Date im ISO 8601-Format). Die Seite liest die hochgeladene Datei mit FileReader.readAsArrayBuffer und übergibt das ArrayBuffer an SheetJS (xlsx). XLSX.read(buffer, {type: 'array'}) gibt ein Workbook-Objekt zurück, dessen SheetNames-Array den Blattauswahl steuert, und XLSX.utils.sheet_to_json(sheet, options) durchläuft das Zellengitter, um entweder ein Array-of-Objects (mit der Header-Zeile als Schlüssel) oder ein Array-of-Arrays bei header: 1 zu erzeugen. Das veraltete .xls ist das binäre BIFF8-Format (Excel 97–2003), das SheetJS ebenfalls über den gleichen read()-Einstiegspunkt dekodiert, jedoch mit type: 'binary' für FileReader.readAsBinaryString oder 'array' beim Lesen als Bytes. Zelldatums-Werte werden in beiden Formaten als Seriennummern gespeichert (Tage seit der 1900-Epoche in Excel, mit dem historischen 1900-02-29-Schaltjahresbug, der Daten vor 1900-03-01 um einen Tag verschiebt, oder Tage seit 1904-01-01, wenn die Arbeitsmappe das Date1904-Flag unter Excel für Mac gesetzt hat). Die Umrechnung in ein JavaScript-Date ist (Seriennr. - 25569) * 86400 * 1000 Millisekunden nach dem Unix-Epoch für das 1900-System, sofern der Schaltjahresbug berücksichtigt ist. Formeln stehen im f-Attribut, und SheetJS meldet ihr letztes zwischengespeichertes Ergebnis in v; wenn die Arbeitsmappe von einem Werkzeug gespeichert wurde, das nicht neu berechnet hat (z. B. einige skriptgestützte Exporte), kann v fehlen oder veraltet sein. Wenn die erste Zeile als Header verwendet wird, erzwingen doppelte oder leere Header-Zellen, dass SheetJS Schlüssel entweder überspringt oder automatisch umbenennt (z. B. __EMPTY, __EMPTY_1), was nachgelagerte JSON-Verträge bricht. Verbundene Zellbereiche (deklariert in worksheet/mergeCells) legen den Wert nur am Anker links oben frei und geben undefined in den nachfolgenden Zellen der Zusammenführung aus, sodass eine verbundene Titelzeile einen gefüllten Datensatz gefolgt von N - 1 leeren Datensätzen erzeugt. Bei Arbeitsmappen über einigen Megabyte kann der synchrone XLSX.read()-Pfad den UI-Thread blockieren; die Streaming-Alternative besteht darin, die Analyse in einen Web Worker zu verlagern, damit der Hauptthread responsiv bleibt.

• .xlsx ist ein ZIP-Container aus XML (ECMA-376 / ISO/IEC 29500); .xls ist das binäre BIFF8-Format; SheetJS XLSX.read(buffer, {type: 'array'}) behandelt beides über FileReader.readAsArrayBuffer.
• sheet_to_json-Optionen: header: 1 gibt Array-of-Arrays zurück; header: 'A' verwendet Tabellenspaltenbuchstaben; defval: null füllt leere Zellen mit null statt den Schlüssel zu entfernen; raw: false wendet Excel-Anzeigeformatierung an.
• Excel-Datumsserie ist Tage seit 1900-01-01 (mit dem 1900-02-29-Schaltjahresbug; für das Mac-1904-Datumsystem Tage seit 1904-01-01); JS-Date-ms = (Seriennr. - 25569) * 86400000 nach dem Unix-Epoch.
• Doppelte oder leere Header-Zellen werden zu automatisch umbenannten Schlüsseln (__EMPTY, __EMPTY_1) oder kollidieren still; validieren Sie das JSON auf diese Zeichenfolgen, bevor Sie sich auf das Schema verlassen.
• Verbundene Zellbereiche (worksheet.mergeCells) legen den Wert nur am Anker links oben frei; nachfolgende Zellen der Zusammenführung sind undefined, sodass eine verbundene Titelzeile einen Datensatz mit dem Wert und N-1 Datensätzen mit leeren Feldern ergibt.
• Formelzellen speichern den Ausdruck in f und das letzte zwischengespeicherte Ergebnis in v; Werkzeuge, die ohne Neuberechnung speichern, hinterlassen v veraltet oder fehlend, und SheetJS gibt v unverändert zurück.
• Verlagern Sie XLSX.read in einen Web Worker für Arbeitsmappen über ca. 10 MB; der synchrone Analysepfad blockiert requestAnimationFrame und kann den Tab bei großen Blättern für mehrere Sekunden einfrieren.