Aplatisseur/Désaplatisseur JSON

L'aplatissement JSON convertit les objets imbriqués en un objet à un seul niveau où les clés imbriquées sont jointes avec un séparateur (généralement un point). Exemple : {"user": {"name": "Alice", "address": {"city": "Berlin"}}} → {"user.name": "Alice", "user.address.city": "Berlin"}. Cas d'usage : aplatissement pour le stockage en colonnes de base de données (migration NoSQL vers SQL), simplification des réponses API profondément imbriquées, alimentation de pipelines d'apprentissage automatique qui attendent des données tabulaires, indexation de documents Elasticsearch, et envoi d'événements d'analyse avec des propriétés aplaties.

Les tableaux sont aplatis en utilisant leur index comme partie de la clé. Exemple : {"tags": ["js", "ts"]} → {"tags.0": "js", "tags.1": "ts"} avec séparateur par point, ou {"tags[0]": "js", "tags[1]": "ts"} avec notation entre crochets. Tableaux imbriqués : {"matrix": [[1,2],[3,4]]} → {"matrix.0.0": 1, "matrix.0.1": 2, "matrix.1.0": 3, "matrix.1.1": 4}. La reconstruction des tableaux lors du dégroupement nécessite de connaître les clés qui sont des indices numériques. Certains outils préservent la structure du tableau lors du dégroupement ; d'autres convertissent en objets.

Point (.) : le plus courant, intuitif, conflits avec les clés contenant des points. Tiret bas (_) : évite les conflits avec les points, utilisé dans certaines conventions de nommage des colonnes de base de données. Double tiret bas (__) : évite les conflits avec les tirets simples, utilisé dans les variables d'environnement Django et les valeurs des graphiques Helm. Barre oblique (/) : utilisée dans JSON Pointer (RFC 6901) — "/user/address/city". Deux-points (:) : utilisé dans certains systèmes de configuration. Meilleure pratique : choisissez un séparateur qui n'apparaît pas dans vos noms de clés existants. Évitez les points si les clés pourraient contenir des noms de paquets ou des noms de domaine.

JSON Pointer est une norme IETF (RFC 6901) pour référencer une valeur spécifique dans un document JSON. Format : /key/subkey/index. Document racine : "". Premier élément du tableau : "/0". Valeur imbriquée : "/user/address/city". Caractères spéciaux : "~0" représente "~", "~1" représente "/". Utilisé dans : JSON Patch (RFC 6902) pour les mises à jour partielles, JSON Schema $ref, références de chemin OpenAPI. Exemple : PATCH avec {"op": "replace", "path": "/user/address/city", "value": "London"} change une valeur imbriquée sans remplacer l'ensemble du document.

function flatten(obj, prefix = "", sep = ".") { return Object.entries(obj).reduce((acc, [key, val]) => { const newKey = prefix ? prefix + sep + key : key; if (val && typeof val === "object" && !Array.isArray(val)) { Object.assign(acc, flatten(val, newKey, sep)); } else if (Array.isArray(val)) { val.forEach((item, i) => { if (item && typeof item === "object") { Object.assign(acc, flatten(item, newKey + sep + i, sep)); } else { acc[newKey + sep + i] = item; } }); } else { acc[newKey] = val; } return acc; }, {}); }. Pour l'inverse (dégroupement), divisez chaque clé sur le séparateur et reconstruisez la structure imbriquée.