Objects

Object is a container for named values called properties. The variables that an object holds can be of any data type and these variables can be read from and written to after the initial object creation, and you can also add more variables to an object after it has been created.

Example of an (stringified) object called person:

{
	"firstName": "John",
	"lastName": "Doe",
	"age": 50,
	"eyeColor": "blue"
};

Creates a new empty object. Does nothing if the object already exists.

Create a new object key or change a value inside an existing key.
Supports setting the values to objects/arrays without having to parse and stringify them.

Retrieves a value associated with the specified object key.

Retrieves the first object key. You can use this command together with Object Get Next Key to iterate over all object keys.
Unlike in some other languages, object keys are not sorted and their order is not guaranteed.

Retrieves the next object key. You can use this command together with Object Get First Key to iterate over all object keys.
Unlike in some other languages, object keys are not sorted and their order is not guaranteed.

Get a random object key and its value

Get a random object key and its value

Import JSON button

Gets a size of an object, i.e. how many keys the object contains.

Returns a JSON string of the whole object.
You can use this command together with File: Save String command to save the whole object into a file. Once loading it back from the file, you can use Parse Array/Object command to turn the JSON string back into the original object.

Stringifies a whole button if you leave the Object Name box empty or set it to local for the current button, or put in the button ID you wish to stringify.

Turns a JSON string into an array/object. Must be properly formatted (SAMMI will give you a warning if it finds any formatting errors).
This way you can easily create a prepopulated object/array, as it supports nesting.
Read more about JSON syntax at w3schools.com.

JSON string before conversion	Result saved in the variable
{ "Lioran":"blue", "Melonax":"orange", "Sebas":"red" }
{ "Names":{ "Lioran":"blue", "Melonax":"orange", "Sebas":"red" }, "randomNumbers":[ 1, 8, 9, 15 ], "singleValue":"Hello World" }

Converts the keys or values of an object into an array.