> For the complete documentation index, see [llms.txt](https://jscula.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jscula.gitbook.io/docs/manipulation/.map.md).

# .map()

Transforms a `NodeList` or `HTMLCollection` into a new array.

Retruns: `Collection`

```javascript
const titles = $('.card*').map(card => card.find('.title').text());
```

### More examples

Extract attribute values from matching elements:

```javascript
const imageSources = $('img*').map(image => image.attr('src'));
```

Create objects from a collection:

```javascript
const users = $('.user*').map(user => ({
  name: user.find('.name').text(),
  role: user.attr('data-role')
}));
```