Skip to main content

http.jsondecode(JSONstring)

Parses JSON data into objects

Availability

Agent

Parameters

Name Type Description
JSONstring String A valid JSON string

Returns

Almost anything (see ‘Description’, below)

Description

This method parses JSON (JavaScript Object Notation) data, as specified in the RFC4627 specification, as described in a more informal way at json.org and as widely used by web services on the Internet.

Depending on the specific JSON data received, this function can return almost any Squirrel data type: table, array, string, float, integer, bool or null. However, it cannot return or invoke Squirrel functions, and thus is ‘safe’ to use with untrusted data from the Internet.

Tables and arrays can be nested up to five levels deep.

A Squirrel error is produced if the JSON is not valid. This error can be detected using Squirrel’s normal try ... catch mechanism.

The corresponding encoding operation is http.jsonencode().

Example Code