JSON Format

Jun 25 2019, 4:47 PM PST 2 min

JSON is a data storage format. In Roblox, HttpService provides two functions for working with JSON data:

HttpService/JSONEncode|HttpService:JSONEncode() converts a variable to its JSON equivalent.
HttpService/JSONDecode|HttpService:JSONDecode() converts a JSON value to its Lua representation.

Encoding

This code snippet encodes characterStats into a JSON string and prints it to the output.

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

local characterStats = {
	money = 123456,
	title = "1337 h4x04",
	is_epic = true,
	awards = {
		kills10 = true,
		died20 = false,
	}
}

local json = HttpService:JSONEncode(characterStats)
print(json)
		
			{"awards":{"died20":false,"kills10":true},"title":"1337 h4x04","is_epic":true,"money":123456}
		
				Copy Code
			
				Light Theme
				
			Copy Code
		
			Light Theme

HttpService/JSONEncode|HttpService:JSONEncode() cannot encode anything other than strings, numbers, tables, and booleans — passing anything else will error.

Decoding

This code snippet converts the JSON value created above back into its table representation, then prints its money value to the output.

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

local jsonData = '{"awards":{"died20":false,"kills10":true},"title":"1337 h4x04","is_epic":true,"money":123456}'
local characterStats = HttpService:JSONDecode(jsonData)
print(characterStats.money)
		
			123456
		
				Copy Code
			
				Light Theme
				
			Copy Code
		
			Light Theme

Tags:

json
lua