pluck()
pluck<
T,Key>(collection,path):T[Key][]
Gets the value of property from all elements in collection.
💎 Why is this a Hidden Gem?
Extract a single property from every object in a collection — cleaner than map + accessor.
DEPRECATED
Use array.map(item => item.property) directly instead.
Type Parameters
T: T
The type of elements in the array.
Key: Key extends string | number | symbol
The key of the property to pluck.
Parameters
collection: Record<string, T> | T[]
The collection to iterate over.
path: Key
The path of the property to pluck.
Returns: T[Key][]
The new array of property values.
See Also
Since
2.0.0
Also known as
map (Lodash) · pluck (Ramda) · ❌ (es-toolkit, Remeda, Radashi, Effect, Modern Dash, Antfu)
Example
const users = [
{ name: 'John', age: 25 },
{ name: 'Jane', age: 30 },
{ name: 'Bob', age: 20 }
];
// ❌ Deprecated approach
const names = pluck(users, 'name');
console.log(names); // ['John', 'Jane', 'Bob']
// ✅ Recommended approach
const namesNative = users.map(user => user.name);
console.log(namesNative); // ['John', 'Jane', 'Bob']
How it works?
Extracts values of a property from all objects.
Deprecated: Use array.map() directly.
Native Equivalent
// ❌ pluck(arr, 'name')
// ✅ arr.map(x => x.name)
Use Cases
Extract property from objects 📌
Get a specific property from each object in a collection.
const users = [{ name: "Alice" }, { name: "Bob" }, { name: "Charlie" }];
users.map(u => u.name);
// => ["Alice", "Bob", "Charlie"]
Get IDs from collection
Extract identifiers from a list of objects.
const products = [{ id: 1 }, { id: 2 }, { id: 3 }];
products.map(p => p.id);
// => [1, 2, 3]
Collect nested values
Extract deeply nested properties.
const items = [{ meta: { score: 10 } }, { meta: { score: 20 } }];
items.map(i => i.meta.score);
// => [10, 20]