The Array method push() in Apps Script

The Array method push() adds elements to the end of an array. It returns the new length of the array after the elements are added to it.

Syntax

array.push(element1, element2, …, elementN)

Parameters

The elements to be added to the array. These will be added to the end of the array.

Return value

The push() method returns the new length of the array after elements are added to it.

Example

The code below uses the push() array method to add two new elements to the array colors.

var colors = ["red", "blue", "green", "black", "orange", "purple"];
Logger.log(colors);
Logger.log(colors.length);
var newLength = colors.push("indigo", "violet");
Logger.log(colors);
Logger.log(newLength);

Output

[red, blue, green, black, orange, purple]

6.0

[red, blue, green, black, orange, purple, indigo, violet]

8.0

Conclusion

In this tutorial, you learned how to use the push() array method to add elements to the end of an array.