my-idlers/node_modules/collect.js/docs/api/prepend.md

34 lines
822 B
Markdown
Raw Normal View History

# `prepend()`
The prepend method adds an item to the beginning of the collection:
```js
const collection = collect([1, 2, 3, 4, 5]);
collection.prepend(0);
collection.all();
// [0, 1, 2, 3, 4, 5]
```
You may also pass a second argument to set the key of the prepended item:
> Pro tip: Order of properties in objects is not guaranteed in JavaScript; When calling prepend with a key, the Collection uses the underlying `put` method behind the scenes. This is only supported so that collect.js have the same api as Laravel Collections.
```js
const collection = collect({
product: 'iPhone 6s',
});
collection.prepend('Apple', 'brand');
collection.all();
// {
// brand: 'Apple',
// product: 'iPhone 6s',
// }
```
[View source on GitHub](https://github.com/ecrmnn/collect.js/blob/master/src/methods/prepend.js)