JSONEncode

Unsafe

For thread safety, this property is not safe to read in an unsynchronized thread.

Function of:

Description:

The JSONEncode function transforms a Lua table into a JSON object or array based on the following guidelines:

Keys of the table must be either strings or numbers. If a table contains both, an array takes priority (string keys are ignored).
An empty Lua table {} generates an empty JSON array.
The value nil is never generated.
Cyclic table references cause an error.

This function allows values such as inf and nan, which are not valid JSON. This may cause problems if you want to use the outputted JSON elsewhere.

To reverse the encoding process, and decode a JSON object, you can use HttpService|HttpService's HttpService/JSONDecode 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 Variant	Default	Summary The input Lua table

Returns

Return Type	Summary
Return Type string	Summary The returned JSON string

Code Samples

HttpService JSONEncode

This code sample turns a Lua table tab into a JSON string using HttpService’s JSONEncode. Then, it prints out the string.

Try editing the Lua table to see how the JSON output changes.

			
				HttpService JSONEncode

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

local tab = {
	-- Remember: these lines are equivalent
	["message"] = "success";
	message = "success";
	
	info = {
		points = 123,
		isLeader = true,
		user = {
			id = 12345,
			name = "JohnDoe"
		},
		past_scores = {50, 42, 95},
		best_friend = nil
	}
}

local json = HttpService:JSONEncode(tab)
print(json)
		
				Copy Code
			
				Light Theme

JSONEncode

Parameters

input

Returns

string

Code Samples

HttpService JSONEncode