Ordenar chaves JSON

Como usar Ordenar chaves JSON

Quando dois JSONs representam os mesmos dados com chaves em ordens diferentes, um diff textual mostra falsas diferenças onde não há nenhuma diferença semântica. Isso polui reviews de pull request, quebra comparações automáticas em testes de snapshot e dificulta auditorias. Ordenar as chaves antes de salvar elimina esse ruído e torna os diffs realmente úteis.

A ordenação é recursiva: chaves de objetos aninhados são ordenadas também, e arrays de objetos têm as chaves de cada elemento reordenadas individualmente. Arrays puros de valores como strings ou números não são reordenados, porque a posição dos itens em um array é semanticamente significativa na maioria dos casos.

Em projetos com arquivos JSON persistidos, como mocks de API, fixtures de teste e arquivos de tradução i18n, manter chaves ordenadas como convenção facilita code review e reduz conflitos de merge quando múltiplos colaboradores ou ferramentas editam o mesmo arquivo. Algumas equipes impõem isso via lint com prettier, que oferece a opção de ordenar chaves JSON automaticamente ao salvar.

Uma ressalva técnica: a especificação ECMAScript não garante ordem de chaves em objetos. Na prática, porém, todos os motores modernos como V8, SpiderMonkey e JavaScriptCore preservam a ordem de inserção para chaves de string não numéricas. Após ordenar e re-parsear, a ordem se mantém. Para comunicação machine-to-machine isso é irrelevante, mas para leitura e diff humanos faz toda a diferença.