useSortedKeys (JSON)

Summary

Rule available since: v1.9.0
Diagnostic Category: assist/source/useSortedKeys
Sources:
- Same as json/sort-keys

How to enable in your editor

1
{
2
  "editor.codeActionsOnSave": {
3
    "source.action.useSortedKeys.biome": "explicit",
4
    "source.fixAll.biome": "explicit"
5
  }
6
}

1
{
2
  "code_actions_on_format": {
3
    "source.action.useSortedKeys.biome": true,
4
    "source.fixAll.biome": true
5
  }
6
}

Use the source action code source.action.useSortedKeys.biome

How to configure

1
{
2
  "assist": {
3
    "actions": {
4
      "source": {
5
        "useSortedKeys": "on"
6
      }
7
    }
8
  }
9
}

Description

Sort the keys of a JSON object in natural order.

Natural order means that uppercase letters come before lowercase letters (e.g. A < a < B < b) and numbers are compared in a human way (e.g. 9 < 10).

Examples

1
{
2
    "vase": "fancy",
3
    "nested": {
4
        "omega": "bar",
5
        "alpha": "foo"
6
    }
7
}

code-block.json ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Source action diff:
  
    1 1 │   {
    2   │ - ····“vase”:·“fancy”,
    3   │ - ····“nested”:·{
      2 │ + ····“nested”:·{
    4 3 │           “omega”: “bar”,
    5 4 │           “alpha”: “foo”
    6   │ - ····}
      5 │ + ····},
      6 │ + ····“vase”:·“fancy”
    7 7 │   }
    8 8 │   
  
code-block.json ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Source action diff:
  
    2 2 │       “vase”: “fancy”,
    3 3 │       “nested”: {
    4   │ - ········“omega”:·“bar”,
    5   │ - ········“alpha”:·“foo”
      4 │ + ········“alpha”:·“foo”,
      5 │ + ········“omega”:·“bar”
    6 6 │       }
    7 7 │   }

Options

This actions accepts following options

`sortOrder`

This options supports natural and lexicographic values. Where as natural is the default.

Following will apply the natural sort order.

1
{
2
  "assist": {
3
    "actions": {
4
      "source": {
5
        "useSortedKeys": {
6
          "level": "on",
7
          "options": {
8
            "sortOrder": "natural"
9
          }
10
        }
11
      }
12
    }
13
  }
14
}

1
{
2
    "val13": 1,
3
    "val1": 1,
4
    "val2": 1,
5
    "val21": 1,
6
    "val11": 1
7
}

code-block.json ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Source action diff:
  
    1 1 │   {
    2   │ - ····“val13”:·1,
    3   │ - ····“val1”:·1,
    4   │ - ····“val2”:·1,
    5   │ - ····“val21”:·1,
    6   │ - ····“val11”:·1
      2 │ + ····“val1”:·1,
      3 │ + ····“val2”:·1,
      4 │ + ····“val11”:·1,
      5 │ + ····“val13”:·1,
      6 │ + ····“val21”:·1
    7 7 │   }
    8 8 │

Following will apply the lexicographic sort order.

1
{
2
  "assist": {
3
    "actions": {
4
      "source": {
5
        "useSortedKeys": {
6
          "level": "on",
7
          "options": {
8
            "sortOrder": "lexicographic"
9
          }
10
        }
11
      }
12
    }
13
  }
14
}

1
{
2
    "val13": 1,
3
    "val1": 1,
4
    "val2": 1,
5
    "val21": 1,
6
    "val11": 1
7
}

code-block.json ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Source action diff:
  
    1 1 │   {
    2   │ - ····“val13”:·1,
    3   │ - ····“val1”:·1,
    4   │ - ····“val2”:·1,
    5   │ - ····“val21”:·1,
    6   │ - ····“val11”:·1
      2 │ + ····“val1”:·1,
      3 │ + ····“val11”:·1,
      4 │ + ····“val13”:·1,
      5 │ + ····“val2”:·1,
      6 │ + ····“val21”:·1
    7 7 │   }
    8 8 │

`groupByNesting`

When enabled, groups object keys by their value’s nesting depth before sorting alphabetically. Simple values (primitives, single-line arrays, and single-line objects) are sorted first, followed by nested values (multi-line arrays and multi-line objects).

Default: false

1
{
2
  "assist": {
3
    "actions": {
4
      "source": {
5
        "useSortedKeys": {
6
          "level": "on",
7
          "options": {
8
            "groupByNesting": true
9
          }
10
        }
11
      }
12
    }
13
  }
14
}

1
{
2
    "name": "Sample",
3
    "details": {
4
        "description": "nested"
5
    },
6
    "id": 123
7
}

code-block.json:1:1 assist/source/useSortedKeys  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ The members are not sorted by nesting level and key.
  
  > 1 │ {
      │ ^
  > 2 │     “name”: “Sample”,
  > 3 │     “details”: {
  > 4 │         “description”: “nested”
  > 5 │     },
  > 6 │     “id”: 123
  > 7 │ }
      │ ^
    8 │ 
  
  ℹ Safe fix: Sort the members by key.
  
    1 1 │   {
    2   │ - ····“name”:·“Sample”,
      2 │ + ····“id”:·123,
      3 │ + ····“name”:·“Sample”,
    3 4 │       “details”: {
    4 5 │           “description”: “nested”
    5   │ - ····},
    6   │ - ····“id”:·123
      6 │ + ····}
    7 7 │   }
    8 8 │