Why does JSON have commas?

https://simonsafar.com/2025/json_with_no_commas/

by Tomte • 1 year ago

33 62 1 year ago

simonsafar.com

01HNNWZ0MV43FF• 1 year ago

At this, the me was enlightened

nurettin• 1 year ago

Makes sense. A PEG would probably be the same length as the original json format.

leshenka• 1 year ago

We can throw away colons too. Dictionaries will be sequences of “key””value””key””value”

Just because we can throw away redundancy doesn’t mean we should

tarvaina• 1 year ago

This is how Clojure does it.

https://clojure.org/guides/learn/hashed_colls#_creating_a_li...

EGreg5• 1 year ago

And iOS programming makes you fill dictionaries with alternating k,v,k,v,nil

jonplackett• 1 year ago

Kinda answers its doe question though

To be fair, dictionary one-liners might be a tiny bit less easy to read:

{"key1": "value1" "key2": "value2"}

Not just a bit less easy, a lot less easy

t3rra• 1 year ago

a hugely uneasy to read indeed. I feel wasted time to read the article. So horrible.

yonixw• 1 year ago

This. The article suggestion will make parsers need lookahead support instead of simple state machine.

Is "key1" array of ["value1", "key2"] ? or string "value1"? We can't now until we find ':'.

frizlab2• 1 year ago

Huh? The article does not suggest dropping the [] or did I miss something?

ghusto2• 1 year ago

He also accounts for that immediately by saying they should therefore be optional.

laurentlb• 1 year ago

If it's about readability, you could have a rule "either comma or line break".

solids• 1 year ago

The main reason behind JSON widespread usage is human readability.

croes• 1 year ago

What exactly is the problem?

By that logic one could argue the whole JSON format is bad because of all the key name redundancy.

tracnar• 1 year ago

Or go even further and you get yaml?

ajuc• 1 year ago

YAML: when you wished json made you count spaces to avoid syntax errors

I don't even mind indentation for nesting, but this

    key: value

    key:value

is EVIL.

fnordsensei• 1 year ago

In EDN[1], which is to Clojure as JSON is to JS, commas are whitespace (as it is in Clojure itself).

1: https://github.com/edn-format/edn

CWIZO• 1 year ago

Coming from this direction, the addition of commas feels like an evil plan to have more syntax errors, with no obvious benefit

It helps to learn your history before you criticise something and claim it is useless.

JSON is the way it is mainly because it is just JavaScript and that meant that every browser in the world already supported it before JSON was even invented. It is THE reason why it is as popular as it is.

jeroenhd3• 1 year ago

Relying on the inherent JavaScript compatibility hack has caused as many problems as it has solved. Plus, the additional of trailing commas made a mess of things once more, forcing developers to let go of the direct compatibility with many versions of JavaScript engines and redirecting them to specialised JSON APIs instead.

The easy solution would be to go the JavaScript route and make commas optional, like JavaScript does with semicolons. You could even introduce vague and easily forgotten rules about commas being inserted between oneliner dictionaries.

I think the question "why" is easily answered, but "why should it still" is more difficult.

watwut• 1 year ago

The easy solution is horrible solution. Pretty much all the projects set semicolons as mandatory for a reason.

randunel• 1 year ago

Making things optional means you'd end up with the csv standard mess on json, let's not!

eastbound• 1 year ago

Jokingly, why does Javascript have the semi-colon “;”

jeroenhd3• 1 year ago

There are a few minor, uncommon edge cases, probably only encountered by minimisers, where automatic semicolon insertion may cause unintentional behaviour, so semicolons are required. One of the specs; https://262.ecma-international.org/7.0/#sec-rules-of-automat... (link from an earlier comment of like) spells it out in detail.

jfengel• 1 year ago

I really with the semicolon weren't optional. Its "I'll take my best guess" parsing is maddening.

One that keeps killing me is:

    return
        (complicated-multi-line-computation)

Since it can put a semicolon at the end of the first line, it does. Which means the return value is undefined, and the rest of it is just some code that it never actually reaches. A linter will fix that, but I find the usual fix a bit ugly:

    return (
        (complicated multi line computation)
    )

sebazzz• 1 year ago

It was just a matter of:

    var myObject = eval(httpResponseBody)

Of course, this is vulnerable to all kinds of issues so we got JSON parser, and later JSON became part of the Web API.

cosmotic• 1 year ago

I remember the infinite loops stuffed into JSON results to prevent this sort of thing.

Tomte• 1 year ago

The author knows that. Fourth paragraph.

pwdisswordfishz• 1 year ago

If the author knows that, why even bother with writing a whole "what should have been" article? It could not have been any oher way.

michaelcampbell• 1 year ago

> ... feels like an evil plan to have more syntax errors, with no obvious benefit
... before you criticise something and claim it is useless.

These 2 statements feel quite far apart.

Xmd5a• 1 year ago

If it is "just JavaScript", why the lack of comments ?

dharmab• 1 year ago

Comments were intentionally excluded to prevent the use of parsing directives.

(Sadly, Crockford's post about this reasoning was on Google Plus and is no longer online.)

sargstuff3• 1 year ago

Yet another example/demo of "Use the source!"

There is nothing in the JSON spec that prohibits pre/post non-json parsing search / replace 'end of line' marker with one or more commas.

JSON spec just tells one what the JSON parser expects, not what the end user needs/wants. (GPT-JSON not withstanding)

EGreg5• 1 year ago

anyone actually use comma-first syntax? It lets you easily move lines around, too:

  {"foo": "bar"
  ,"baz": "hehe"
  ,"yes": "aligned"
  ,"better": "this way"}

scottmf• 1 year ago

more easy how?

AlchemistCamp• 1 year ago

Not the top one!

nkrisc2• 1 year ago

This has the same number of lines that can’t be moved freely as comma at the end.

EGreg5• 1 year ago

But visually easier to check Also you can put the last brace on its own line

sham1• 1 year ago

Haskell culture tends to do this kind of stuff for records, FWIW. Of course, in this case, it might even make sense to render this in a way such as the following:

  {
    "foo": "bar"
  , "baz": "hehe"
  , "yes": "aligned"
  , "better": "this way"
  }

Because as another person already said, the first line isn't movable, and the last line wasn't either. The first key-value pair does look a tad strange because it doesn't have anything before the key, but nevertheless, now changing things is even easier.

Admittedly, it would look nicer if we could have trailing commas, though. Oh well, we have YAML for extra readable record syntax, even with how horrible YAML can get in reality.

EGreg5• 1 year ago

My opinion: just have commas be optional, like semicolons.

Allow linebreaks to insert implied commas

smackeyacky2• 1 year ago

Readability matters and humans like that. Otherwise XML would have won.

https://guidetogrammar.org/grammar/twain.htm

jeroenhd3• 1 year ago

I don't find commas at the end of line adding any more readability than avoiding them, except for the oneliner counter case.

JavaScript has optional separators (semicolons) with some rules to avoid ambiguity. Not everyone like it (I use semicolons in JS unnecessarily because I can't be bothered to learn the three edge cases they're not optional). I think there's something to be said for "commas are optional except in oneliners".

Languages like Go describe structs without commas. It took me some getting used to, but it's really not more or less readable in my opinion.

gregopet• 1 year ago

If readability was the only criteria perhaps YAML deserves to win. For some data XML is more readable, its complexity is the bigger problem.

People went all in with things like XSLT and namespaces, Java became the "language that transforms XML into stack traces" for no good reason and complex XML monstrosities were considered normal so when something simple came along it was a much needed breath of fresh air (we were even prepared to overlook its lack of comments). If it wasn't JSON it would have been something else, I'm sure.

smackeyacky2• 1 year ago

We are trained from a very young age, as a rule, to see the comma. The semicolon, not so much. Semicolons are unusual: they are not part of story telling; they are from a forgotten grammar which is hardly used.

Timon32• 1 year ago

YAML seems easier to read, but for me it's much harder to actually read properly since so many things are ambiguous. JSON is very explicit - you always know the data type you're looking at. YAML has a bunch of special cases that you have to remember, and these frequently lead to bugs.

The best example are boolean values. With JSON, you have `true` or `false`. With YAML you have all of these: y|Y|yes|Yes|YES|n|N|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF

paulmooreparks• 1 year ago

I wrote my own language mainly to get rid of commas and colons, and I added comments while I was at it.

https://github.com/paulmooreparks/Xfer/tree/master/ParksComp...

tommy_axle• 1 year ago

Neat. Did you have any thoughts on json5 or hjson?

jgyter• 1 year ago

Why? What does he actually gain? The small convenience of skipping a comma in the one specific case where a human is reading pretty-printed JSON?

It's an adamant No from me.

ghusto2• 1 year ago

In configuration languages such as HCL, having to account for the fact that there will not be a comma for the last element becomes unnecessarily difficult.

dazhbog• 1 year ago

When it comes to serialization or sending data over the wire (non http), I prefer relaxed json (no quotes on keys e.g. {a:1,b:"hi"} ).

It keeps the message readable and it can be re-assembled on the server. That is if MessagePack or CBOR are not an option.

antirez• 1 year ago

The problem is not commas, but the fact the specification does not tell you MUST, in a conforming parser, handle extra commas at the end. While commas are not very useful in this case, they have some value because:

1. They help humans parse the JSON object: we are helped by structure. 2. They add redundancy of information and allow for simpler spotting of syntax errors.

What JSON really needs is to extend its syntax to allow strings that are prefixed length, without the need of a binary protocol. "foo": 6="foobar". Otherwise JSON forces you to parse byte by byte, which is extremely inefficient for large amounts of data.

conaclos• 1 year ago

I kinda disagree with the conclusion. Punctuation is important to humans, it makes it more parsable/readable. I just accept that in a multi-line context they are not so useful, because the newline acts like a kind of punctuation. So I could make them optional and provide some recommendations: use them in a single line, and don't use them when a newline follows.

geor9e2• 1 year ago

These JSON versus YAML versus whatever discussions seem to mainly be arguments from people hand-coding it in grey ASCII with no tools. IMO the ASCII itself just needs to be machine-readable, because humans have visualization tools to parse it and give a pretty view. I'm not Rain Man.

EPWN3D• 1 year ago

Criticizing JSON for needless commas with a post full of needless ellipses.

librasteve• 1 year ago

{ "interests": ["编程” "reading" "travel"] }

is written

{ :interests<编程 reading travel>, }

in raku literals, quite a lot less wiggling of the pinky than the authors “maximal” proposal

yeah raku : perl without the line noise

Why does JSON have commas?

Related Stories