/Godot 3.1


Inherits: Reference < Object

Category: Core

Brief Description

Data class wrapper for decoded JSON.


Error error
int error_line
String error_string
Variant result


Returned by JSON.parse, JSONParseResult contains decoded JSON or error information if JSON source not successfully parsed. You can check if JSON source was successfully parsed with if json_result.error == OK.

Property Descriptions

Error error

Setter set_error(value)
Getter get_error()

The error type if JSON source was not successfully parsed. See @GlobalScope ERR_* constants.

int error_line

Setter set_error_line(value)
Getter get_error_line()

The line number where the error occurred if JSON source was not successfully parsed.

String error_string

Setter set_error_string(value)
Getter get_error_string()

The error message if JSON source was not successfully parsed. See @GlobalScope ERR_* constants.

Variant result

Setter set_result(value)
Getter get_result()

A Variant containing the parsed JSON. Use typeof() to check if it is what you expect. For example, if JSON source starts with curly braces ({}) a Dictionary will be returned, if JSON source starts with braces ([]) an Array will be returned.

Be aware that the JSON specification does not define integer or float types, but only a number type. Therefore, parsing a JSON text will convert all numerical values to float types.

Note that JSON objects do not preserve key order like Godot dictionaries, thus you should not rely on keys being in a certain order if a dictionary is constructed from JSON. In contrast, JSON arrays retain the order of their elements:*

var p = JSON.parse('["hello", "world", "!"]')
if typeof(p.result) == TYPE_ARRAY:
    print(p.result[0]) # prints 'hello'
    print("unexpected results")

© 2014–2019 Juan Linietsky, Ariel Manzur, Godot Engine contributors
Licensed under the MIT License.