JSON 키 정렬

JSON 객체의 키를 알파벳 순으로 재정렬하며, 중첩 객체와 객체 배열로 재귀 하강할지 고를 수 있습니다. 배열 자체는 원래 순서를 유지하고 객체의 키 순서만 바뀝니다. 결정적인 diff를 만들 때(정렬한 package.json을 커밋해 리뷰어가 의미 있는 변경만 보게 할 때), 스냅샷 테스트 전에 API 픽스처를 정규화할 때, 키 순서에 엄격한 후속 도구가 기대하는 순서에 맞출 때 씁니다.

배열을 건드리지 않는 것은 빠진 기능이 아니라 올바른 동작입니다. 객체는 정의상 순서 없는 모음이라 키를 재배열해도 뜻이 달라지지 않지만, JSON 배열은 순서가 있어서 정렬하면 문서가 달라집니다. 정렬한 파일과 원본을 파싱하면 같은 값이 나오는 이유도 이것입니다. 움직이는 것은 diff이지 데이터가 아닙니다.

정렬은 키의 문자열 형태를 기준으로 하는데, 직관적인 순서와는 다릅니다. 대문자가 소문자보다 앞서므로 Name이 age 위로 갑니다. 숫자가 문자보다 앞서고, 숫자로 된 키는 문자열로 정렬되어 10이 2보다 앞에 놓입니다. 대소문자가 섞인 키를 가진 파일은 처음에 알파벳순이 아니라 뒤섞인 것처럼 보일 텐데, 같은 일을 하는 다른 도구들도 모두 이 순서를 만들어 냅니다.

JSON은 중복 키를 허용하고 파서는 마지막 것만 남기는 식으로 처리하므로, 같은 키를 두 번 담은 문서는 여기서도 다른 어디에서와 마찬가지로 값을 하나 잃습니다. 아주 큰 정수가 또 하나의 조용한 손실입니다. 안전 정수 범위를 넘는 값은 파싱하고 다시 직렬화하는 사이에 달라지며, 19자리 식별자를 문자열로 두어야 하는 이유가 이것입니다.

이 툴을 찾는 가장 흔한 이유인 package.json에 대해 한 가지 경고가 있습니다. 키 정렬 자체는 안전하지만 그 파일 안의 모든 항목이 실제로 순서에서 자유롭지는 않습니다. exports 맵은 노드의 해석기가 선언된 순서대로 대조하므로, 이것을 정렬하면 패키지가 내주는 진입점이 바뀔 수 있습니다. 최상위만 정렬하고 그 항목은 그대로 두십시오.