Basics of JSON: parsing, stringifying, and best practices

Anton Ioffe - August 28th 2023 - 13 minutes read

Defining JSON and Its Utility

JavaScript Object Notation (JSON) is a favored lightweight data-interchange format, notable for both human readability and machine parsing. Its capacity to encapsulate structured data, rooted in the simplicity of JavaScript's object syntax, isn't limited to merely elementary representation; JSON adeptly handles complex data types as well.

Consider this example:

  "name": "John Doe",
  "age": 30,
  "isMarried": false,
  "children": ["Jane", "Joe"]

This shows JSON's effective handling of different data types through name-value pairs, from numbers and strings to Booleans, arrays, and other objects.

In contrast to alternatives like XML, JSON presents a leaner, less verbose option for data interchange while preserving simplicity and clarity:

  <name>John Doe</name>

This XML representation involves more text and requires more bandwidth.

JSON has found extensive use in API creation, configuration files, and data storage in the field of web development due to its readability, simplicity, and swift parsing capabilities. However, it's worth noting that while it can capably handle complex data structures, it doesn't support advanced features like extensive metadata or powerful querying capabilities, something XML offers.

A common misunderstanding is the conflation of JSON and JavaScript. Although they share a common syntax, they aren't interchangeable. Syntax errors such as missing braces or mismatching quotes will render JSON invalid, despite its JavaScript-esque appearance.

While XML is frequently used as an alternative, data formats like BSON and YAML could offer increased flexibility depending on application needs. Yet, the balance JSON strikes between simplicity and adaptability makes it a go-to choice for many developers, irrespective of its nuanced limitations and potential for misunderstandings.

JSON Stringify & Parse

JSON.stringify() and JSON.parse() are intrinsic JavaScript functions facilitating data conversion between a JavaScript object (or certain kinds of values) and a JSON string. These functions are instrumental when JavaScript data types must be transposed into a string format for storage or transfer purposes.

JSON.stringify() transforms a JavaScript object or value into a JSON string. However, it's cardinal to acknowledge that only data in a valid JSON format can be stringified. While functions, undefined, and symbols are JavaScript values, they are not in a valid JSON format, hence, an attempt to stringify these will lead to their omission from the converted JSON string.

Sample usage:

let exampleObject = {
    id: 1,
    name: "John Doe",
    email: ""
let jsonString = JSON.stringify(exampleObject);
console.log(jsonString); // outputs "{"id":1,"name":"John Doe","email":""}"

JSON.parse() conversely, revives the JavaScript object or value from a JSON string. It is typically employed to process JSON-formatted data from a server. Nonetheless, this method can throw exceptions when parsing malformed JSON strings.

Usage example:

let jsonString = '{"id":1,"name":"John Doe","email":""}';
let parsedObject = JSON.parse(jsonString);
console.log(; // outputs "John Doe"

These tools are powerful allies in managing complex data structures, but their effective use requires an understanding of their potential limitations and properly handling exceptional cases.

JSON Parsing Methodologies

Parsing JSON data efficiently and accurately is an essential competency for developers. JSON, or JavaScript Object Notation, is a data-interchange format that allows data exchange between servers in a manner that is easily interpretable by both humans and machines.

This segment guides you through different parsing techniques and illustrates when to utilize each, complete with code examples. If you're working with JSON, there's a primary method you should be familiar with: JSON.parse().

JSON.parse(): JavaScript natively provides this commonly used method. It takes a JSON string and transforms it into a JavaScript object. Ponder over the given JSON data:

let jsonData = '{ "name":"John", "age":30, "city":"New York"}';
let obj = JSON.parse(jsonData);

The code snippet above takes the JSON string and transforms it into a JavaScript object, which you can then manipulate as required.

After grasping the primary method, let's discuss parsing multiple objects. An effective approach is to parse JSON objects during their read time, a technique known as read-streaming. This method shines when dealing with large data sets, as depicted in the following example:

const fs = require('fs');
let stream = fs.createReadStream('largeFile.json', {flags: 'r', encoding: 'utf-8'});
let buf = '';
let jsonArr = [];

stream.on('data', function(d) {
    buf += d.toString(); // when data is read, stash it in a string buffer
    pump(); // then process the buffer

function pump() {
    let pos;
    while ((pos = buf.indexOf('}\n')) >= 0) { // while there's a JSON object in the buffer
        let jsonStr = buf.slice(0, pos+1); // isolate the JSON object
        buf = buf.slice(pos+2); // and remove it from the buffer
        jsonArr.push(JSON.parse(jsonStr)); // push the parsed JSON object into the array

In the above design, incoming data is divided into distinct JSON objects and placed into an array.

But what happens if your JSON is not correctly structured? Let's suppose you attempt to parse a JSON string which is not correctly formatted. It results in a SyntaxError, as shown below:

let jsonData = '{ "name":"John", "age":30, city":"New York"}'; 
let obj = JSON.parse(jsonData); 

The SyntaxError, in this case, is a result of a missing quote mark, making it invalid JSON. Always validate the structure of your JSON data to preclude such errors.

Coming to other aspects of handling JSON, we can convert JavaScript objects back to JSON strings using JSON.stringify(). JSON data structures are ways we can organize JSON data. Error handling involves catching and dealing with errors encountered during the process of parsing.

In conclusion, ensure you utilize JSON.parse() for secure parsing, use read streaming for large data sets, and structure your JSON data correctly to prevent syntax errors. Stay tuned for future sections where we dive into more aspects of working with JSON data such as using JSON.stringify(), understanding JSON data structures, and handling JSON parsing errors.

By mastering these strategies, you will be able to make your JSON parsing operations significantly more efficient and error-free.

Handling Errors and Exceptions

Handling errors and exceptions, especially those associated with parsing and stringifying JSON, is a critical aspect of development in JavaScript. JSON's burgeoning popularity due to its simplicity and scalability makes it essential to understand how to manage its errors effectively. This article delves into the common errors you might face, and provides insights on how to manage and debug these errors.

Common JSON Errors

During the parsing and stringifying of JSON, developers may encounter several prevalent errors.

A frequent mistake made when handling JSON-related errors is attempting to parse or stringify incorrectly formatted JSON which can result in a SyntaxError. Consider this example:

let incorrectJson = "{ 'name': 'John', 'age': 30 }"; // incorrect – uses single quotes instead of double
let parsedData = JSON.parse(incorrectJson); // this will cause a SyntaxError

JSON keys and values should be wrapped in double quotes, not single quotes as in standard JavaScript objects. If you use single quotes, a syntax error is triggered. It's vital to cross-check that your JSON strings are properly formatted with double quotes.

More examples of common errors include dealing with undefined or null values, trailing commas, etc, and each would result in different kinds of issues or errors that we'll explore in future articles.

Error Handling Strategies

When you receive JSON data from an external source, always plan for potential errors. Traditional try-catch blocks can effectively handle any errors that may arise. If JSON.parse() triggers an error, the catch block is automatically activated.

let incorrectJson = "{ name: 'John', 'age': 30 }"; // incorrect – lacks double quotes around the key

try {
  let parsedData = JSON.parse(incorrectJson);
} catch (error) {
  console.log('An error occurred:', error);

In this code snippet, the catch block intercepts the error, preventing it from causing a catastrophic failure in your script. This way, even if the parsing fails, script execution continues.

Debugging Techniques

Debugging is integral to error handling and most programming languages including JavaScript provide various debugging methods.

Integrated Development Environments (IDEs) usually include powerful debuggers that let you step through code, examine variables at specific spots, and monitor the execution trail. For example, consider the instance of debugging a typical JSON error:

let incorrectJson = "{ 'name': John, 'age': 30 }"; // incorrect – lacks quotes around the value

try {
  parsedData = JSON.parse(incorrectJson);
} catch (error) {
  console.log('An error occurred:', error); // place a breakpoint here

In the given case, you would set a breakpoint on the console.log line inside the catch block. When debugging, your IDE will halt execution at this line, allowing you to investigate the error object for more details about the issue.

Understanding common JSON related errors, implementing effective error handling strategies, and utilizing efficient debugging strategies are fundamental when working with JSON in JavaScript. These tools will equip you to build robust applications capable of dealing with unexpected scenarios aptly.

JSON and Data Structures

JSON, or JavaScript Object Notation, is a light-weighted, text-based data interchange format that's easy for humans to read and write and easy for machines to parse and generate. It is entirely language independent and serves as an alternative to XML in web applications. JSON's simplicity has resulted in its widespread use, notably for data transportation. This article explores the parsing of JSON data into various data structures, the usage of JSON, and how to query JSON data.

JSON data often consists of arrays and objects. To accurately use them, one needs to understand their applications to prevent common mistakes when working with JSON data. Let's delve into their use-cases, buttressed by some practical code examples.

JSON objects are made up of key-value pairs where a key is a string, and the value can be several data types like arrays, boolean expression, number, string, or another JSON object. Here's an illustration of a JSON object:

  "name": "John",
  "age": 30,
  "city": "New York"

JSON arrays hold multiple values, written inside square brackets, and these values can be of any data type akin to JSON objects. The example below highlights a basic JSON array:

  "employees": ["John", "Anna", "Peter"]

To query JSON data, consider a JSON object named 'person' which has been defined as follows:

var person = { "name": "John", "age": 30, "city": "New York"}

To access the value of the 'name' property, you can use dot notation:

var name =;

Or bracket notation, valuable when the property name is a variable:

var prop = "name";
var name = person[prop];

Working with JSON data structures requires a deep comprehension of data types, referencing, and structuring. Common errors occur when there is an inaccurate reference to a property of a nested JSON object or array. One way to avoid this error is to carefully study the JSON structure or use a JSON viewer.

A difference between JSON and JavaScript objects is that JavaScript objects can contain methods, unlike JSON objects. Here's an example of a JavaScript object with a method:

var person = {
  firstName: "John",
  lastName : "Doe",
  id       : 5566,
  fullName : function() {
    return this.firstName + " " + this.lastName;

Lastly, always validate your JSON format. This includes ensuring all strings are in double quotes, array and object brackets are correctly opened and closed, and proper comma usage between properties.

Practicing the parsing, use, and query of JSON will strengthen your mastery of JSON data. Don't forget, continuity in exploring, reading, and practicing solidifies your skills in JSON. Happy coding!

JSON Size and Performance

Working with JSON (JavaScript Object Notation) efficiently requires keen consideration for size and performance. This is particularly significant in resource-heavy applications where speed and optimal functionality are vital. Hence, there are methods through which JSON size can be reduced, and when these are compared with XML parsing, one can identify considerable improvements in speed.

As a straightforward and user-friendly data storage system, JSON's main limitation arises from the potential increase in size with an accumulation of more data. To alleviate this, certain strategies may be employed. Minimizing key names, taking advantage of value similarities, and integrating data compression can be beneficial.

Take a look at the following example for a practical understanding:

Initial JSON code:

    "firstName": "John",
    "lastName": "Doe",
    "age": 30,
    "city": "New York"


    "fn": "John",
    "ln": "Doe",
    "a": 30,
    "c": "New York"

In the optimized instance, the key names have been shortened. It's important, however, to avoid excessive shortening of keys to the point where they lose their descriptive nature – care must be taken to maintain data clarity and readability even while aiming for size reduction.

Delving into performance, data parsing significantly impacts data-driven applications. There's been a notable advantage of JSON parsing speeds over XML parsing. According to benchmarks provided by official sources (link), JSON parsing tends to be faster.

Here's a simple method for benchmarking the parsing time difference between JSON and XML (including actual parsing):

let startTime;
let exampleJSON = '{"firstName":"John"}';    
let parser, xmlDoc; 
// 'Date' is a built-in JavaScript object for working with dates

startTime =;
let jsonTime = - startTime; 

let exampleXML = "<firstName>John</firstName>"; 
startTime =;
parser = new DOMParser();
xmlDoc = parser.parseFromString(exampleXML,"text/xml");
let xmlTime = - startTime; 

console.log(`JSON time: ${jsonTime}ms, XML time: ${xmlTime}ms`);

While your test results might vary due to the complexity of the data, JSON parsing is generally quicker.

A frequent oversight among developers is not considering JSON size and performance implications in heavy applications. This can result in enlarged JSON outputs that impact application performance. For instance, verbose, unminimized key names and the repetition of identical data units across multiple requests can bloat payload size, negatively affecting performance.

In summary, adept handling of JSON size and parsing can significantly enhance an application's performance. It is also worth emphasizing that while striving for an optimal JSON size, care must be taken to not compromise the readability and comprehensibility of the data structure. Thus, find a balance in performance improvements and maintainability for a truly efficient and robust application.

JSON vs SQL and Other Languages

When comparing JSON to data languages like SQL or XML, various factors including structure, accessibility, and applicability are taken into consideration. While they exhibit significant differences, both JSON and SQL find their practical uses in different application environments.

JSON (JavaScript Object Notation) is chiefly a data interchange format that is efficient and user-friendly. It extends its functionality to numerous programming languages, including Python, JavaScript, and PHP. On the other hand, SQL (Structured Query Language) is a standardized query language widely used for managing and manipulating relational databases.

So, how does JSON compare to SQL and other data formats?

JSON, being a language-independent textual data format, offers a myriad of benefits. It's lightweight, self-descriptive, and can be easily parsed by a multitude of programming languages. In contrast, it lacks the sophisticated querying capabilities of SQL, making it less suitable for handling complex database management tasks.

Consider code execution – parsing JSON in Python is straightforward:

import json
person = '{"name": "John", "age": 30, "city": "New York"}'
person_dict = json.loads(person)

The Python code above loads a JSON string into a Python dictionary.

In JavaScript, an equivalent task would look like this:

var person = '{"name":"John", "age":30, "city":"New York"}';
var person_obj = JSON.parse(person);

Here, the JSON string is turned into an object for easy access and manipulation.

However, if you were to retrieve the same data from a database using SQL, the query would be:

SELECT name, age, city FROM People WHERE name = 'John';

This SQL query returns the person whose name is 'John' with his corresponding age and city.

As with any data language, each, including JSON and SQL, has strengths and weaknesses. Despite certain misconceptions, JSON is not meant to replace SQL or vice versa, as their capacities are not inherently exclusive. JSON excels in data interchange, particularly in situations like handling responses in APIs. SQL is indispensable in handling relational databases due to its powerful query capabilities.

Therefore, the choice between JSON, SQL, or even combining both depends on your application's particular needs like the complexity and volume of data, team expertise, and other operational aspects.

In sum, JSON and SQL are two powerful tools in a developer's arsenal, with distinct roles in software development. Each shines in different scenarios, promising efficient data handling and superior functionality when appropriately combined or utilized. A keen understanding of their strengths and weaknesses can pave the way for optimal software performance and management.

JSON Applications

JSON (JavaScript Object Notation) showcases a varied range of applications in the realm of data exchange and storage. It paves the way for advanced data management and representation, which we will delve into in this section.

  1. Data Storage: JSON, with its structured organization, is an excellent tool for storing dynamic data that changes over time. It allows easy readability and writing, making data storage and retrieval in the JSON format a breeze. Let's grasp this with a simple example where we store user information in a JSON object:
  "users": [
    { "name": "John", "age": 27, "city": "New York" },
    { "name": "Jane", "age": 23, "city": "Chicago" }
  1. Data Interchange: JSON's efficiency in transferring data from server to client and vice versa is commendable. Being less verbose compared to XML, it facilitates speedy data transfers. It's a favored tool for applications from web services, APIs to mobile apps for data exchange purposes.

  2. Configuration Files: The simplicity and comprehensibility of JSON structures have led to their wide usage in configuration files across various development platforms. Here’s a basic configuration file example to illustrate.

  "server": "localhost",
  "port": 8080,
  "database": "testDB"
  1. Data Beautifying: JSON endears itself to all with its human-readable format, easy parsing, and generation. Many JSON beautifier tools allow us to format JSON files for a clearer, organized representation of our data. Give any browser-based JSON beautifier tool a try to format the following JSON data:
{"name":"John","age":30,"city":"New York"}

One frequent oversight among developers is underestimating JSON's capability to store complex, multi-dimensional data. Let’s consider a menu represented as a JSON object:

  "menu": {
    "id": "file",
    "value": "File",
    "popup": {
      "menuitem": [
        {"value": "New", "action": "Creates a new document"},
        {"value": "Open", "action": "Opens a document"},
        {"value": "Close", "action": "Closes the current document"}

This illustration showcases JSON's adeptness in handling nested data structures. Adapting JSON for more intricate, nested structures can significantly streamline and amp up your data management strategy.

Mastering the power of JSON goes a long way in improving data exchange, fundamental storage capabilities, and consequently, overall application performance. Recognizing its potential and the multitude of applications it offers is pivotal to optimizing its use. It would be beneficial to delve deeper into how JSON handles complex data structures with feasible real-world scenarios and practical coding examples for an enriched understanding of its capabilities.

Don't Get Left Behind:
The Top 5 Career-Ending Mistakes Software Developers Make
FREE Cheat Sheet for Software Developers