Skip to content

Latest commit

 

History

History
60 lines (41 loc) · 1.38 KB

README.md

File metadata and controls

60 lines (41 loc) · 1.38 KB

map-extend

Extend a Map instance with one or more others.

Installation

$ npm install map-extend

Status

Stable

Actions Status

Usage

const extend = require('map-extend')

// shallow merge
extend(map, ...maps) // merge map entries in `maps` into `map`

// merge entry values in `maps` before merging into `map`
extend(true, map, ...maps)

API

extend([merge = false], map, ...maps)

Extend a Map instance with one or more other maps where merge is a boolean (default: false) used to indicate if the entry values for each candidate found in maps should be merged before extending map. If true the extend() module function is used with deep set to true on the entry values in the order in which they are given.

// copy entries from `maps` into `map`
extend(map, ...maps)

// copy and merge entry values in `maps` into `map`
extend(true, map, ...maps)

License

MIT