json/top-level-interop

The first JSON specification, RFC 4627, only allowed an object or an array at the top of a document. Later ones allow any value, but some older parsers still reject a file that's just a string, a number, true, false, or null. Turn this rule on for files that such tools have to read.

Configure#

Off by default. It needs an ESLint config that says which files are in the language:

import json from "@eslint/json";

export default [
  {
    files: ["**/*.json"],
    plugins: { json },
    language: "json/json",
    rules: { "json/top-level-interop": "error" },
  },
];

It also works with json/jsonc and json/json5.

Examples#

"app"

42

{ "name": "app" }

[1, 2, 3]