Array.prototype.pop()
The pop() method removes the last
element from an array and returns that element. This method changes the length of the
array.
Syntax
pop()
Return value
The removed element from the array; undefined if the array is empty.
Description
The pop method removes the last element from an array and returns that
value to the caller.
pop is intentionally generic; this method can be called or applied to objects
resembling arrays. Objects which do not contain a length property
reflecting the last in a series of consecutive, zero-based numerical properties may not
behave in any meaningful manner.
If you call pop() on an empty array, it returns undefined.
Array.prototype.shift() has similar behavior to pop, but
applied to the first element in an array.
Examples
Removing the last element of an array
The following code creates the myFish array containing four elements, then
removes its last element.
const myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
const popped = myFish.pop();
console.log(myFish); // ['angel', 'clown', 'mandarin' ]
console.log(popped); // 'sturgeon'
Using apply( ) or call ( ) on array-like objects
The following code creates the myFish array-like object containing four
elements and a length parameter, then removes its last element and decrements the length
parameter.
const myFish = {0:'angel', 1:'clown', 2:'mandarin', 3:'sturgeon', length: 4};
const popped = Array.prototype.pop.call(myFish); //same syntax for using apply( )
console.log(myFish); // {0:'angel', 1:'clown', 2:'mandarin', length: 3}
console.log(popped); // 'sturgeon'
Using an object in an array-like fashion
push and pop are intentionally generic, and we can use that to our advantage — as the following example shows.
Note that in this example, we don't create an array to store a collection of objects. Instead, we store the collection on the object itself and use call on Array.prototype.push and Array.prototype.pop to trick those methods into thinking we're dealing with an array.
const collection = {
length: 0,
addElements: function(...elements) {
// obj.length will be incremented automatically
// every time an element is added.
// Returning what push returns; that is
// the new value of length property.
return [].push.call(this, ...elements);
},
removeElement: function() {
// obj.length will be decremented automatically
// every time an element is removed.
// Returning what pop returns; that is
// the removed element.
return [].pop.call(this);
}
}
collection.addElements(10, 20, 30);
console.log(collection.length); // 3
collection.removeElement();
console.log(collection.length); // 2
Specifications
| Specification |
|---|
| ECMAScript Language Specification # sec-array.prototype.pop |
Browser compatibility
BCD tables only load in the browser