Convertisseur Excel vers JSON

Les classeurs .xlsx modernes sont des fichiers SpreadsheetML définis par ECMA-376 / ISO/IEC 29500 (la norme Office Open XML) : l'extension .xlsx est un conteneur ZIP dont les entrées sont des documents XML sous xl/worksheets/sheetN.xml, avec les chaînes stockées dans une table de chaînes partagées xl/sharedStrings.xml et les types de cellules déclarés par l'attribut t (s = sharedString, n = number, b = boolean, str = chaîne inline, d = date en ISO 8601). La page lit le fichier téléchargé avec FileReader.readAsArrayBuffer, puis transmet l'ArrayBuffer à SheetJS (xlsx). XLSX.read(buffer, {type: 'array'}) renvoie un objet classeur dont le tableau SheetNames pilite le sélecteur de feuille, et XLSX.utils.sheet_to_json(sheet, options) parcourt la grille de cellules pour produire soit un tableau d'objets (avec la ligne d'en-tête comme clés) soit un tableau de tableaux lorsque header: 1 est passé. Le format .xls hérité est le format binaire BIFF8 (Excel 97-2003), que SheetJS décode également via le même point d'entrée read() mais avec type: 'binary' pour FileReader.readAsBinaryString ou 'array' pour une lecture en octets. Les valeurs de date des cellules dans les deux formats sont stockées comme des numéros de série (jours depuis l'époque 1900 dans Excel, avec le bug historique d'année bissextile du 29/02/1900 qui décale les dates avant le 01/03/1900 d'un jour, ou jours depuis le 01/01/1904 lorsque le drapeau date1904 du classeur est activé sur Excel pour Mac). La conversion en objet JavaScript Date est (série - 25569) * 86400 * 1000 millisecondes après l'époque Unix pour le système 1900 une fois le bug d'année bissextile pris en compte. Les formules résident dans l'attribut f et SheetJS rapporte leur dernier résultat mis en cache dans v ; si le classeur a été sauvegardé par un outil n'ayant pas recalculé (par ex. certains exports scriptés), v peut être manquant ou obsolète. Lorsque la première ligne est utilisée comme en-têtes, des cellules d'en-tête dupliquées ou vides obligent SheetJS à ignorer ou renommer automatiquement les clés (par ex. __EMPTY, __EMPTY_1), ce qui casse les contrats JSON en aval. Les plages de cellules fusionnées (déclarées dans worksheet/mergeCells) n'exposent la valeur qu'à l'ancrage supérieur gauche et émettent undefined dans les cellules de queue fusionnées, donc une ligne de titre fusionnée produit un enregistrement peuplé suivi de N - 1 enregistrements épars. Pour les classeurs de plusieurs dizaines de mégaoctets, le chemin synchrone XLSX.read() peut bloquer le thread UI ; l'alternative en flux est de déplacer l'analyse dans un Web Worker pour que le thread principal reste réactif.

• .xlsx est un conteneur ZIP de XML (ECMA-376 / ISO/IEC 29500) ; .xls est le format binaire BIFF8 ; SheetJS XLSX.read(buffer, {type: 'array'}) gère les deux via FileReader.readAsArrayBuffer.
• Options de sheet_to_json : header: 1 renvoie un tableau de tableaux ; header: 'A' utilise les lettres de colonnes du tableur ; defval: null remplit les cellules éparses avec null au lieu de supprimer la clé ; raw: false applique le formatage d'affichage Excel.
• Le numéro de série de date Excel est le nombre de jours depuis le 01/01/1900 (avec le bug d'année bissextile du 29/02/1900 ; pour le système de dates Mac 1904, jours depuis le 01/01/1904) ; Date JS en ms = (série - 25569) * 86400000 après l'époque Unix.
• Les cellules d'en-tête dupliquées ou vides deviennent des clés renommées automatiquement (__EMPTY, __EMPTY_1) ou entrent en collision silencieusement ; validez le JSON pour ces chaînes avant de vous fier au schéma.
• Les plages de cellules fusionnées (worksheet.mergeCells) n'exposent la valeur qu'à l'ancrage supérieur gauche ; les cellules de queue de la fusion sont undefined, donc une ligne de titre fusionnée produit un enregistrement avec la valeur et N-1 enregistrements avec des champs vides.
• Les cellules de formule stockent l'expression dans f et le dernier résultat mis en cache dans v ; les outils qui sauvegardent sans recalculer laissent v obsolète ou manquant, et SheetJS renvoie v tel quel.
• Déplacez XLSX.read dans un Web Worker pour les classeurs au-delà de ~10 Mo ; le chemin d'analyse synchrone bloque requestAnimationFrame et peut geler l'onglet pendant plusieurs secondes sur les grandes feuilles.