Scripting: JSON – Arma Reforger

JSON Format

JSON stands for JavaScript Object Notation. It is a way to present data in a simple form.

ⓘ

See:

• JSON for a more informative Wikipedia article
• RFC7159 for the RFC
• ECMA-404 for the standard
• https://www.json.org/ for general details and libraries
• Mozilla's article for more information.

The parent class is always an object (the O from JSON).

{
}

A property is defined with its name on the left of the colon, and its value on the right. Properties and strings are defined by double-quotes ".
If another property follows, a comma is required. If no other property follows, there must be no comma.

⚠

There can be no comments in a JSON file.

{
	"property": 42
}

{
	"property1": 41,
	"property2": "fourty-two"
}

Spacing does not matter outside of the quotes.

{
	"property1": "name",
	"property2": 42
}

is identical to

{"property1":"name","property2":42}

but for obvious readability reasons, tabs and spaces are welcome.

Boolean

A boolean can be either true or false and nothing else.

{
	"boolean1": true,
	"boolean2": false
}

Number

A number can be either an integer or a float. There are no quotes around it. It cannot start with a period .. Scientific notations are accepted.

{
	"number1": 42,
	"number2": 4.2,
	"number3": -33,
	"number4": 10e10
}

String

Line returns cannot happen in JSON strings. The following character escape sequences are accepted:

• \b
• \f
• \r
• \n
• \t
• \"
• \\
• \/
• \u#### - see Unicode chars

{
	"string1": "This is a string",
	"string2": "Is \"this\" a string?\tYes, Sir\u0021"
}

Object

{
	"object1": {
		"property1": "sub-object"
	}
}

The null value is covered.

{
	"object1": null
}

Array

An array can contain anything: direct values, or other objects with named properties.

{
	"array1": [
		4,
		5,
		6
	],
	"array2": ["This", "is", "Sparta!"],
	"array3": [
		{
			"name": "object's name",
			"value": 33
		},
		{ "name": "another object, inlined", "value": 42 }
	]
}

See Also

• JsonApiStruct Usage - covers JSON serialisation, deserialisation, validation
• Serialisation - JSON