Ordenar JSON

Relacionats

Què és l'ordenació JSON?

Casos d'ús

• Unificar l'ordre de les claus a package.json, tsconfig.json i altres fitxers de configuració
• Ordenar dos JSON abans de comparar-los per eliminar diferències falses causades només per l'ordre
• Estabilitzar l'ordre de les claus en respostes API per a cache, hash i snapshots
• Endreçar fitxers JSON grans abans d'una code review o una auditoria de configuració
• Preparar la sortida després d'un merge o d'un repair abans de la validació següent

Com usar-ho

1. Enganxa el JSON al panell esquerre, carrega un exemple o importa un fitxer .json
2. Tria el mode d'ordenació de claus o d'arrays i ajusta la direcció i la recursivitat
3. Executa l'ordenació i revisa el resultat al panell dret
4. Copia el resultat o descarrega'l com a sorted.json

Característiques

• Dos modes: pots ordenar claus d'objecte o elements d'array
• Suport recursiu: també ajusta l'ordre dins dels objectes imbricats
• Ascendent i descendent: canvia la direcció de l'ordenació amb facilitat
• Estructura intacta: valors i tipus no es modifiquen
• Processament local: el JSON no surt del navegador
• Fàcil de continuar: el resultat es pot passar directament a JSON Diff, Repair o Format

Exemples de codi

// Ordena les claus recursivament i retorna un objecte nou
function sortKeysDeep(value) {
  if (Array.isArray(value)) return value.map(sortKeysDeep);
  if (value !== null && typeof value === 'object') {
    return Object.keys(value)
      .sort((a, b) => a.localeCompare(b))
      .reduce((acc, k) => {
        acc[k] = sortKeysDeep(value[k]);
        return acc;
      }, {});
  }
  return value;
}

const data = { zoo: { animals: ['zebra', 'elephant'] }, alpha: 1, beta: 2 };
console.log(JSON.stringify(sortKeysDeep(data), null, 2));

import json

data = {"zoo": {"animals": ["zebra", "elephant"]}, "alpha": 1, "beta": 2}

print(json.dumps(data, indent=2, sort_keys=True, ensure_ascii=False))

arr = [3, 1, 4, 1, 5]
print(sorted(arr))
print(sorted(arr, reverse=True))

# Ordena les claus recursivament
jq -S '.' data.json

# Ordena els elements d'un array
jq 'sort' data.json

# Ordena per un camp concret
jq 'sort_by(.age)' data.json

Preguntes freqients

Solució de problemes

Glossari

JSON Sort

Operació que només canvia l'ordre de claus o elements d'array sense tocar valors ni tipus.

Recursive Sort

Ordenació aplicada no sols al nivell superior, sinó també a tots els objectes imbricats.

Ascending / Descending

Ascendent vol dir A-Z o de menor a major; descendent és el contrari.

Canonical Form

Representació JSON normalitzada, útil per comparar, fer cache o calcular hash.

Git Diff Noise

Línies de diff innecessàries causades per ordre o format, no per canvis reals de dades.

localeCompare

API de JavaScript per comparar cadenes, sovint utilitzada per ordenar noms de claus.

Escenaris habituals per ordenar JSON

Quan usar sort, diff o merge

Authoritative References

• MDNArray.prototype.sort - documentació MDN
• jqManual oficial de jq - sort / sort_by
• PythonParàmetre sort_keys de Python json.dumps
• IETFEspecificació JSON (RFC 8259)