athea

Repositories Projects Packages

map-obj (4.3.0)

Published 2026-02-24 14:01:10 +00:00 by atheaadmin

Installation

Setup this registry in your project .npmrc file:

registry=

To install the package using npm, run the following command:

npm install map-obj@4.3.0

or add it to the package.json file:

"map-obj": "4.3.0"

For more information on the npm registry, see the documentation.

About this package

map-obj

Map object keys and values into a new object

Install

npm install map-obj

Usage

const mapObject = require('map-obj');

const newObject = mapObject({foo: 'bar'}, (key, value) => [value, key]);
//=> {bar: 'foo'}

const newObject = mapObject({FOO: true, bAr: {bAz: true}}, (key, value) => [key.toLowerCase(), value]);
//=> {foo: true, bar: {bAz: true}}

const newObject = mapObject({FOO: true, bAr: {bAz: true}}, (key, value) => [key.toLowerCase(), value], {deep: true});
//=> {foo: true, bar: {baz: true}}

const newObject = mapObject({one: 1, two: 2}, (key, value) => value === 1 ? [key, value] : mapObject.mapObjectSkip);
//=> {one: 1}

API

mapObject(source, mapper, options?)

source

Type: object

Source object to copy properties from.

mapper

Type: (sourceKey, sourceValue, source) => [targetKey, targetValue, mapperOptions?] | mapObject.mapObjectSkip

Mapping function.

mapperOptions

Type: object

shouldRecurse

Type: boolean
Default: true

Whether targetValue should be recursed.

Requires deep: true.

options

Type: object

deep

Type: boolean
Default: false

Recurse nested objects and objects in arrays.

target

Type: object
Default: {}

Target object to map properties on to.

mapObject.mapObjectSkip

Return this value from a mapper function to exclude the key from the new object.

const mapObject = require('map-obj');

const object = {one: 1, two: 2}
const mapper = (key, value) => value === 1 ? [key, value] : mapObject.mapObjectSkip
const result = mapObject(object, mapper);

console.log(result);
//=> {one: 1}

Related

• filter-obj - Filter object keys and values into a new object

---

Get professional support for this package with a Tidelift subscription
_{Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies.}

Dependencies

Development Dependencies

ID	Version
ava	^2.0.0
tsd	^0.14.0
xo	^0.24.0

Keywords

map object key keys value values iterate iterator rename modify deep recurse recursive

Details

npm

2026-02-24 14:01:10 +00:00

1

Sindre Sorhus

Project Site

MIT

latest

3.1 KiB

Assets (1)

map-obj-4.3.0.tgz 3.1 KiB

Versions (2) View all

1.0.1 2026-02-24

4.3.0 2026-02-24