JSONDecode

Function of:

Description:

The JSONDecode function transforms a JSON object or array into a Lua table with the following characteristics:

Keys of the table are strings or numbers but not both. If a JSON object contains both, string keys are ignored.
An empty JSON object generates an empty Lua table {}.
If the input string is not a valid JSON object, this function will throw an error.

To encode a Lua table into a JSON object, you can use HttpService|HttpService's HttpService/JSONEncode function.

Many web endpoints use JSON, as it is commonly used on the Internet. Visit JSON.org to become more familiar with the format.

This method can be used regardless of whether HTTP Requests are HttpService/HttpEnabled|enabled.

Parameters

Name	Type	Default	Description
Name input	Type string	Default	Summary The JSON object being decoded

Returns

Return Type	Summary
Return Type Variant	Summary The decoded JSON object as a Lua table

Code Samples

HttpService JSONDecode

This code sample gives an example JSON format string and parses it using HttpService’s JSONDecode. It then verifies that the JSON was parsed correctly, and prints out some of the information within the object.

Try editing the JSON string to experiment with the format. Also experiment with inspecting the data in Lua to get comfortable with the Lua representation of the data (tables and other values).

				
					HttpService JSONDecode
				
					Expected Output
				
					Expand
					
			local HttpService = game:GetService("HttpService")

-- An example JSON formatted string 
-- For details, see: http://www.json.org/
local jsonString = [[
{
	"message": "success",
	"info": {
		"points": 120,
		"isLeader": true,
		"user": {
			"id": 12345,
			"name": "JohnDoe"
		},
		"past_scores": [50, 42, 95],
		"best_friend": null
	}
}
]]

local data = HttpService:JSONDecode(jsonString)
if data.message == "success" then
	-- Print the sample data
		
	-- Since tab["hello"] and tab.hello are equivalent,
	-- you could also use data["info"]["points"] here:
	print("I have " .. data.info.points .. " points")
	if data.info.isLeader then
		print("I am the leader")
	end
	print("I have " .. #data.info.past_scores .. " past scores")
	
	print("All the information:")
	for k, v in pairs(data.info) do
		print(k, type(v), v)
	end
end
		
				Copy Code
			
				Light Theme

JSONDecode

Parameters

input

Returns

Variant

Code Samples

HttpService JSONDecode