noTopLevelLiterals

此内容尚不支持你的语言。

JSON (and super languages)

Summary

Diagnostic Category: lint/nursery/noTopLevelLiterals
This rule doesn’t have a fix.
The default severity of this rule is information.
Sources:
- Same as json/top-level-interop

How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "nursery": {
5
        "noTopLevelLiterals": "error"
6
      }
7
    }
8
  }
9
}

Description

Require the JSON top-level value to be an array or object.

The JSON specification technically allows any JSON value (object, array, string, number, boolean, or null) to be used as the top-level element of a JSON document. However, some older JSON parsers, especially those created before RFC 7158/4627 was fully adopted, only support objects or arrays as the root element.

Additionally, some security practices (such as those preventing JSON hijacking attacks) rely on the assumption that the top-level value is an object or array. Using an object or array at the top level also provides better extensibility for your data structures over time.

Examples

Invalid

1
"just a string"

code-block.json:1:1 lint/nursery/noTopLevelLiterals ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Expected the top-level value to be an array or object.
  
  > 1 │ “just a string”
      │ ^^^^^^^^^^^^^^^
    2 │ 
  
  ℹ Some JSON parsers only support objects or arrays as the root element. Wrap your value in an array or object to ensure compatibility.
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

1
42

code-block.json:1:1 lint/nursery/noTopLevelLiterals ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Expected the top-level value to be an array or object.
  
  > 1 │ 42
      │ ^^
    2 │ 
  
  ℹ Some JSON parsers only support objects or arrays as the root element. Wrap your value in an array or object to ensure compatibility.
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

1
true

code-block.json:1:1 lint/nursery/noTopLevelLiterals ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Expected the top-level value to be an array or object.
  
  > 1 │ true
      │ ^^^^
    2 │ 
  
  ℹ Some JSON parsers only support objects or arrays as the root element. Wrap your value in an array or object to ensure compatibility.
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

1
null

code-block.json:1:1 lint/nursery/noTopLevelLiterals ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Expected the top-level value to be an array or object.
  
  > 1 │ null
      │ ^^^^
    2 │ 
  
  ℹ Some JSON parsers only support objects or arrays as the root element. Wrap your value in an array or object to ensure compatibility.
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

Valid

1
{
2
  "property": "value",
3
  "otherProperty": 123
4
}

1
["element", "anotherElement"]

1
{}

1
[]