.push

𝙉𝙀𝙒 𝙆𝙀𝙔
localDataStorage.push( arrayKeyName, value1 [, value2 ...] )

𝙀𝙓𝙄𝙎𝙏𝙄𝙉𝙂 𝙆𝙀𝙔
localDataStorage.push( arrayKeyName, value [, index] )

This method stores value(s) under arrayKeyName, creating a new key if necessary, where the key prefix is prepended to arrayKeyName. As a shortcut for set, this automatically creates a new Array Key.

This is also used to place value onto an existing arrayKeyName, optionally at the index position. When index is omitted, the element is appended to the Array Key by default. When specified, the index is automatically corrected to prevent sparse arrays.

This is a non-destructive insert.

EXAMPLE:

Create and initialize a new Array Key with values:
● localData.push( 'nicknames', 'Mac', 'Will', 'Bill', 'Tom' ) --> ['Mac', 'Will', 'Bill', 'Tom']

Push a value onto an existing Array Key:
● localData.push( 'nicknames', 'Todd' ) --> ['Mac', 'Will', 'Bill', 'Tom', 'Todd']

Insert a value into the second position:
● localData.push( 'nicknames', 'Kay', 2 ) --> ['Mac', 'Kay', 'Will', 'Bill', 'Tom', 'Todd']

🌐 This method may fire an event allowing you to monitor the key change.

✨ The complement to this is pull.

📝 NOTE: This method is specific to Array Keys and will fail if used on any other key type. Multiple values can be set only when making a new key. Pushing values onto an existing key must be done one at a time.