# Extract values of a property from an array of objects

Pluck one field from every record.

Canonical: https://1loc.dev/object/extract-values-of-a-property-from-an-array-of-objects/
Version: 1.0.0
Runtime: JavaScript · Node.js 22 / modern browsers
Verification: Local fixtures; no external services
Updated: 2026-10-28

## Implementation

```javascript
function pluck({ objects, property }) { return objects.map(object => object[property] ?? null); }
```

## Input

```json
{
  "objects": [
    {
      "recipient": "ana@example.com",
      "status": "delivered"
    },
    {
      "recipient": "rui@example.com",
      "status": "deferred"
    }
  ],
  "property": "recipient"
}
```

## Expected output

```json
[
  "ana@example.com",
  "rui@example.com"
]
```

## Edge case

Input:
```json
{
  "objects": [
    {}
  ],
  "property": "recipient"
}
```
Output:
```json
[
  null
]
```

## Limits

- Missing fields become null (undefined in the original).

The lab validates types and size before calling this function. Add equivalent validation at your own trust boundary.

## Source and license

Original: https://github.com/phuocng/1loc/blob/14b481cf60dff1620ab1bb99a43b1f68068cdd9b/contents/extract-values-of-a-property-from-an-array-of-objects.mdx
Source file (this edition): https://github.com/akamind/1loc/blob/0a77f131b22d2ba3b7ec1728846f900c22821678/contents/extract-values-of-a-property-from-an-array-of-objects.mdx
Author: Nguyen Huu Phuoc and original contributors
Contributors: See original repository history
Source commit: 14b481cf60dff1620ab1bb99a43b1f68068cdd9b
Copyright (c) 2020 phuoc-ng
License: MIT — https://1loc.dev/licenses/
Maintainer: Oveyon
Modifications: Missing fields become null. Original MDX retained as inert source evidence.
