The basics of JSON syntax

JSON (JavaScript Object Notation) is a lightweight and widely-used data interchange format that has become a standard for representing structured data. Its simplicity, human-readability, and compatibility with a variety of programming languages make it a popular choice for data exchange over the web. In this blog post, I will outline the fundamental syntax of JSON and provide some basic examples.

What is JSON?

JSON, short for JavaScript Object Notation, is an open-standard format that uses human-readable text to transmit data in a structured manner. It originated from JavaScript but has since become language-independent, and supported by a wide range of programming languages. A key strength of JSON is the lightweight and easy-to-parse format for representing data, making it easy to integrate with web services, APIs, and data storage.

JSON syntax overview

The JSON syntax follows a set of basic rules to ensure the proper structure and formatting of JSON data. Here are the fundamental rules of JSON syntax:

Data types

JSON supports the following data types.

Strings

Enclosed within double quotes "" and represent sequences of characters.

"Hello, World!"

Numbers

Integer or floating-point values.

42
3.14159

Booleans

Represented by true or false.

true

Null

Represents the absence of a value.

null

Arrays

Ordered lists of values enclosed within square brackets [].

[1, 2, 3]

Objects

Unordered collections of key-value pairs enclosed within curly braces {}.

{ "name": "John", "age": 25, "isStudent": true }

Delimiters

Objects are enclosed within curly braces {}.
Arrays are enclosed within square brackets [].
Strings are enclosed within double quotes "".
Key-value pairs within objects are separated by commas ,.

Escape characters

Certain characters have special meanings in JSON and need to be escaped when used within strings. The backslash \ is used to escape characters.

Here are the characters that need to be escaped in JSON:

Double Quote ("): To include a double quote within a string, it should be escaped as \".
Backslash (\): To include a backslash within a string, it should be escaped as \\.
Forward Slash (/): Although it is not required to escape forward slashes in JSON, it can be escaped as \/ to avoid potential issues when the JSON is used within HTML <script> tags.
Backspace (\b): Represented as \b, this is an escape sequence for the backspace character.
Form Feed (\f): Represented as \f, this is an escape sequence for the form feed character.
Newline (\n): Represented as \n, this is an escape sequence for the newline character.
Carriage Return (\r): Represented as \r, this is an escape sequence for the carriage return character.
Tab (\t): Represented as \t, this is an escape sequence for the tab character.

Escaping these characters is necessary to ensure they are treated as literal characters within the string and do not interfere with the JSON syntax or structure. When parsing this JSON data, the escape characters will be removed, and the resulting string values will contain the desired characters.

Here’s an example that demonstrates the usage of escaped characters in JSON:

{
  "name": "John Doe",
  "description": "He said, \"Hello, World!\"",
  "path": "C:\\Documents\\Files"
}

In this example the double quotes (") within the description value are escaped using a backslash (\"). The backslashes (\) within the path value are also escaped using a backslash (\\).

Whitespace

JSON allows the use of whitespace characters (spaces, tabs, and line breaks) outside of strings. Whitespace is optional and used to enhance readability. It does not affect the structure of the JSON data.

The basic syntax of objects

JSON objects are enclosed in curly braces {} and consist of key-value pairs. In JSON objects, each key is followed by a colon : which separates it from its corresponding value. The value can be of any JSON data type, including objects or arrays.

The syntax for a key-value pair is as follows:

"key": value

The keys must be strings and are followed by a colon : to separate them from their corresponding values. Multiple key-value pairs are separated by commas. The syntax for an object is as follows:

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

JSON allows nesting objects and arrays within one another, allowing for complex and hierarchical data structures. Objects can contain arrays, and arrays can contain objects or other arrays.

Examples of JSON objects

JSON objects consist of key-value pairs enclosed within curly braces ({}). Each key is a string, followed by a colon (:), and the corresponding value. Objects can have any number of key-value pairs and can include other JSON data types as values, such as strings, numbers, booleans, null, arrays, or even nested objects.

Simple object

{
  "name": "John Doe",
  "age": 30,
  "city": "New York"
}

In this example, we have a JSON object representing a person. It includes key-value pairs for “name” with a value of “John Doe”, “age” with a value of 30, and “city” with a value of “New York”.

Nested object

{ 
  "name": "Jane", 
  "age": 30, 
  "address": { 
               "street": "123 Main St", 
               "city": "San Francisco" 
             } 
}

This JSON object includes a nested object called “address” that contains additional properties like street and city.

Object containing an array

{ 
  "name": "Mike", 
  "hobbies": [
               "reading", 
               "painting", 
                "hiking"
             ] 
}

In this example, the JSON object includes an array of hobbies as one of its properties.

Object containing a null value

{ 
  "name": "Emily", 
  "age": null, 
  "city": "London" 
}

This JSON object demonstrates the usage of a null value for the age property.

Object containing a boolean

{
  "name": "Alex", 
  "isStudent": true 
}

Here, the JSON object includes a boolean property indicating whether the person is a student or not.

The basic syntax of arrays

JSON arrays are ordered collections of values, enclosed in square brackets []. The values within an array can be of any JSON data type, including objects, arrays, numbers, strings, booleans, or null. Multiple values within an array are separated by commas. The syntax for an array is as follows:

[ value1, value2, ... ]

JSON array examples

JSON arrays provide a way to organize and store multiple values in a specific order. They are enclosed within square brackets ([]), and the values within the array are separated by commas (,). Arrays can contain any JSON data type, including numbers, strings, booleans, null, objects, or even nested arrays.

Array of numbers

[1, 2, 3, 4, 5]

This JSON array represents a list of numbers from 1 to 5.

Array of strings:

["apple", "banana", "orange"]

This example represents a JSON array containing three string values: “apple”, “banana”, and “orange

Array of objects

[
  {
    "name": "John", 
    "age": 25}, 
  {
    "name": "Jane", 
    "age": 30}, 
  {
    "name": "Mike", 
    "age": 35
  } 
]

This JSON array consists of multiple objects, where each object represents a person with a name and age.

Nested arrays

[
  [1, 2, 3], 
  [4, 5, 6], 
  [7, 8, 9]
]

Here, the JSON array contains three nested arrays, each representing a row of numbers.

Mixed array

[1, "apple", true, null]

This example demonstrates a JSON array that includes elements of different data types, such as a number, string, boolean, and null.