Master the Basics of JSON: A Beginner’s Guide to Data Exchange

JSON Is a Data Exchange Format

A data exchange format is a textual format for transmitting data between different platforms. Besides JSON, you may have heard of XML as another data exchange format. Formats like XML and JSON are crucial for enabling data exchange between disparate systems.

JSON Is Language-Agnostic

JSON stands for JavaScript Object Notation. The name may suggest that one must learn JavaScript to understand JSON. While some JavaScript knowledge can be helpful, it is not required because JSON is language-independent; you can use it with any programming language.

JSON Is Based on JavaScript Objects

JSON is based on JavaScript object literals. Note the term “based”. In JavaScript (and most languages with object concepts), objects can contain functions. Since a data exchange format focuses on data, JSON does not include functions from JavaScript object literals; it only uses the syntax for object literals and their properties.

Name‑Value Pairs

Name‑value pairs are a common concept in computing, also known as key‑value pairs, attribute‑value pairs, or field‑value pairs. If you are familiar with name‑value pairs, JSON will feel natural. In a name‑value pair you declare a name, e.g., "animal", and assign it a value. In JSON, the value can be a number, boolean, null, array, or object.

Correct JSON Syntax

The name, such as "animal" in our example, must always be enclosed in double quotes. The name can contain any valid characters, so a name like "My animal": "cat" is legal in JSON. Even single quotes inside the string are allowed, e.g., "Lindsay's animal": "cat". JSON’s name‑value pairs are designed for broad system compatibility, though using spaces or special characters (outside a‑z, 0‑9) can affect portability.

Syntax Validation

Unlike machines, a small typo by a human can cause errors. Therefore, when working with JSON, validation is essential. Many integrated development environments (IDEs) include built‑in JSON validation.

JSON Files

You might think JSON can only be created in code and viewed via developer tools, but JSON can also be stored as a standalone file in a file system. Its extension is easy to remember: .json. For example, you can save the object { "animal": "cat" } to a file like C:/animals.json.

JSON Media Type

When transmitting data, you must indicate its type, known as the media type (also called Internet media type, content type, or MIME type). Media types use a type/subtype format, such as text/html. JSON’s MIME type is application/json.

Introduction to Data Types

In computing, knowing the data type you are handling is essential because different types support different operations. You can multiply two numbers, but not a word and a number. Knowing that a method expects a numeric argument prevents passing a string like "ketchup".

Computer science defines primitive data types, which refer to the most basic kinds of data, not to primitive or crude data.

Data Types in JSON

Although composite data types and some primitive types differ across programming languages, the primitive types mentioned earlier are covered by most languages:

Numbers (e.g., 5 or 5.09): integers, floating‑point, fixed‑point

Characters and strings (e.g., "a", "A", "apple")

Boolean type (true or false)

Object data types are common in many languages such as Java or C#. A data exchange format aims to convey only the shared parts between systems, so complex object structures are broken down into primitive types. JSON supports the following data types:

Object

String

Number

Boolean

Null

Array

Object Type in JSON

JSON objects are straightforward: JSON itself is an object, a list of name‑value pairs enclosed in curly braces. To create nested name‑value pairs, you use nested objects.

String Type in JSON

Earlier we illustrated JSON strings with the example { "animal": "cat" }. The value "cat" is a string. JSON strings may contain any Unicode characters, and they must be enclosed in double quotes.

Number Type in JSON

Numbers are common data elements for conveying quantities such as inventory counts, monetary values, coordinates, or planetary mass. JSON numbers can be integers, decimals, negatives, or expressed in exponential notation.

Boolean Type in JSON

In everyday language, the simplest answers are yes or no. In programming, the Boolean type represents true or false. Some languages map true to 1 and false to 0.

null Type in JSON

Zero might seem appropriate for representing nothing, but zero is a number. Do not confuse null with undefined, especially in JavaScript. Undefined refers to a non‑existent variable or property, while null explicitly denotes the absence of a value. In JSON, null must be written in lowercase.

Array Type in JSON

Now let’s examine arrays. If you are unfamiliar with arrays, think of a container holding a dozen eggs; it has 12 slots, analogous to an array of size 12 containing 12 elements.

End of the first three chapters.