1.0.0 • Published 1 year ago

@hoangcung1804npm/culpa-corporis-laboriosam v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Mergician

NPM GitHub Workflow Status (main) Codacy code quality License: MIT jsDelivr Sponsor this project

Mergician is a uniquely flexible and light-weight utility for cloning and deep (recursive) merging of JavaScript objects.

Unlike native methods and other utilities, Mergician faithfully clones and merges objects by properly handling descriptor values, accessor functions, and prototype properties while offering advanced options for customizing the clone/merge process.

Features

  • Deep (recursive) clone/merge JavaScript objects
  • Generates new object without modifying source object(s)
  • Clone/merge enumerable and non-enumerable properties
  • Clone/merge property descriptor values
  • Retain, skip, or convert accessor functions to static values
  • Inspect, filter, and modify properties
  • Merge, skip, or hoist prototype properties
  • Merge or skip key intersections, unions, and differences
  • Merge, sort, and remove duplicate array items
  • IntelliSense / code hinting support
  • TypeScript support
  • Lightweight (2k min+gzip) and dependency-free

Platform Support

Node 10+ Chrome 61+ Edge 16+ Firefox 60+ Safari 10.1+

Examples

Basic object cloning using default options:

// ES module shown. CommonJS module also available (see below).
import { @hoangcung1804npm/culpa-corporis-laboriosam } from '@hoangcung1804npm/culpa-corporis-laboriosam';

const obj1 = { a: [1, 1], b: { c: 1, d: 1 } };
const clonedObj = @hoangcung1804npm/culpa-corporis-laboriosam({}, obj1);

// Results
console.log(clonedObj); // { a: [1, 1], b: { c: 1, d: 1 } }
console.log(clonedObj === obj1); // false
console.log(clonedObj.a === obj1.a); // false
console.log(clonedObj.b === obj1.b); // false

Advanced object merging using custom options:

// ES module shown. CommonJS module also available (see below).
import { @hoangcung1804npm/culpa-corporis-laboriosam } from '@hoangcung1804npm/culpa-corporis-laboriosam';

const obj1 = { a: [1, 1], b: { c: 1, d: 1 } };
const obj2 = { a: [2, 2], b: { c: 2 } };
const obj3 = { e: 3 };

const mergedObj = @hoangcung1804npm/culpa-corporis-laboriosam({
  skipKeys: ['d'],
  appendArrays: true,
  dedupArrays: true,
  filter({ depth, key, srcObj, srcVal, targetObj, targetVal }) {
    if (key === 'e') {
      targetObj['hello'] = 'world';
      return false;
    }
  }
})(obj1, obj2, obj3);

// Result
console.log(mergedObj); // { a: [1, 2], b: { c: 2 }, hello: 'world' }

Installation

NPM

npm install @hoangcung1804npm/culpa-corporis-laboriosam
// ES module
import { @hoangcung1804npm/culpa-corporis-laboriosam } from '@hoangcung1804npm/culpa-corporis-laboriosam';
// CommonJS module
const { @hoangcung1804npm/culpa-corporis-laboriosam } = require('@hoangcung1804npm/culpa-corporis-laboriosam');

CDN

Available on jsdelivr (below), unpkg, and other CDN services that auto-publish npm packages.

💡 Note the @ version lock in the URLs below. This prevents breaking changes in future releases from affecting your project and is therefore the safest method of loading dependencies from a CDN. When a new major version is released, you will need to manually update your CDN URLs by changing the version after the @ symbol.

// ES module @ latest v2.x.x
import { @hoangcung1804npm/culpa-corporis-laboriosam } from 'https://cdn.jsdelivr.net/npm/@hoangcung1804npm/culpa-corporis-laboriosam@2';

Usage & Options

See the documentation site for details.

Sponsorship

A sponsorship is more than just a way to show appreciation for the open-source authors and projects we rely on; it can be the spark that ignites the next big idea, the inspiration to create something new, and the motivation to share so that others may benefit.

If you benefit from this project, please consider lending your support and encouraging future efforts by becoming a sponsor.

Thank you! 🙏🏻

Contact & Support

  • Follow 👨🏻‍💻 @jhildenbiddle on Twitter and GitHub for announcements
  • Create a 💬 GitHub issue for bug reports, feature requests, or questions
  • Add a ⭐️ star on GitHub and 🐦 tweet to promote the project
  • Become a 💖 sponsor to support the project and future efforts

License

This project is licensed under the MIT license.

Copyright (c) John Hildenbiddle (@jhildenbiddle)

uuidpackagequeueES2020ArrayBufferes2015variables in csspostcssFloat32ArrayUint32ArraywidthlockfileAsyncIteratorchineseSetpasswordexecmrugraphqlpositivexterminvariantloggingtoArrayObject.getPrototypeOfdataviewi18nlimitedargvstylingcurlless cssCSSStyleDeclarationhelpersconsumebrowsermkdirjsonpathbatchsomewarningobjectdeepcopyECMAScript 2020apiinspect256parserMapcsstermelectronconnectcode pointsajaxdependenciesdom-testing-librarymake dirsuperagentpropertydotenvdeepcloneimmutablepropertiesoptimizerutilarraybufferdebugtsliblrufindauthclassnamerm -frtimecoreURLSearchParamspromisesviewhasOwnPropertyloggerdayjsproxylinkWebSocketdirectoryURLsimpledbunicodedescriptiongradients csstsbluebirdperformantreactarktypebundlereslintsettingspackagesdescriptorscheme-validationYAMLsearchtypescript[[Prototype]]livestatelesstoolsjsxReactiveXbeanstalkReflect.getPrototypeOfmatchconcurrencydateprotoArrayBuffer#slicejoiloadingECMAScript 3schemetelephonecss nestingendpointec2throattc39preprocessorapollobuffersaccessordescriptorsjsdomrgbes2017regexpconcatpackage managervalidatemimecloudsearchstreams2definePropertyredux-toolkitrdstraverseES2019spinnerisframeworkObject.entriesFunction.prototype.namenpmweakmapietaskentriesroutingguidreadableoffsetinputconsolequoteownvalidationemojiformsgettertapeformstatewaitArray.prototype.includesparentpathpromiseString.prototype.trimoutputcorsfunctionstrimEnduninstallgetoptwgetwalkingelmshellspinnersdynamodbkinesisa11yreplayECMAScript 2023fetchrouterangeerrorformatpreserve-symlinksansiredactttyforEachjsdiffcodesvisualjavascriptfull-widthamazonsymbolselasticachecomputed-typeses8styletakeES2015walkoptimistfast-copyprototypechromiumecmascriptparentsjasminewritableMicrosoftUnderscoreratefindLastIndexObject.iscss lesses6upawaitWebSocketsform-validationObject.definePropertycjksymlinkstesterenvironmentWeakMapreal-timeJSONbuffernodecolorspostcss-pluginStreamschannelstyleguidecolumnsSymbollengthiamnativeimportexportexpression@@toStringTagencryptionsqscollectionextragdprcommand-linees2016fastclonejQueryextensionpipesortedratelimitlimitasciifindLastiterationnumberargseslesscsstoSortedshrinkwrapgradients css3flatES2018chrometapdebuggerStreamwrapcreateUint8ClampedArrayargumentemitprotobufiteratephoneloadbalancingartebshashprivateTypedArraysnsgetfpsless compilervalidTypeBoxes-shim APIgetintrinsictoStringTagstructuredClonesetperformanceeslint-pluginclientrfc4122react-hook-formroute53watchArray.prototype.flatMapmakeopen$.extendshebangtestsafecolourexpressfromtextrequestwordwrapESmkdirp.envcss-in-jsjscachecryptargparse__proto__ECMAScript 2016zodRegExp.prototype.flagscoercibleautoscalingdirsyntaxerrorcall-boundmapredirectenumerableindicatorfastcopyfseventspluginpredictabledeep-copyhardlinkses5Objectbddclass-validatorl10nfast-deep-copynegative zeroPushresolveastfind-upnodejslookenvxhrESnextregular expressionfigletbyteOffsetglacierchaiutilitiesspecjapaneseminimalsymbolidkarmajestequalityhttpsArray.prototype.flatspeed_.extendtestingECMAScript 2019util.inspecthas-ownassignpushimmerArray.prototype.flattenenderString.prototype.matchAllfixed-widthtyped arraygenericsmergemkdirshasfiltermobilecallboundextendserializationArrayECMAScript 2015RegExp#flagsprogresscompilermomentfluxECMAScript 6stylesheetstringifyreduxpackage.jsoneventDispatcheriteratorStyleSheetlistenersJSON-Schemainternalstringhttpquerystringcompile lessRxJSmime-dbmatchAlltypeerrorsesmixinses2018slotwatcherwatchingisConcatSpreadablecharacterscheckomittddpatchagentObject.fromEntriesawswebvestequalglobmatchesclassnamesvariablesreducefolderqueryconfigurablecolorpersistentbreakschemagetOwnPropertyDescriptorfastifyfast-clonerequireHyBinamebootstrap csslessnested cssregular expressionsdeepECMAScript 2022touchvalueauthenticationArray.prototype.findLastbannerterminaleventEmittercss variableES5ES7WeakSetlinewrapconcatMapintrinsiclanguagebcryptconfignegativeES2021ECMAScript 2017middlewareSymbol.toStringTagreact-testing-librarytrimStartio-tsstdlibwatchFileclassesprotocol-buffersfunctionstableeventsmonorepofullespreestylesbrowserlistestreeremoverapiddependency managerECMAScript 2021bindhigher-orderbrowserslistautoprefixerIteratortypessetPrototypeOfwordbreakkoreanes-abstractawesomesaucedeleteworkerlibphonenumberstreamcollection.es6efficientbundlingInt32ArraysyntaxajvflattenfsPromisesameValueZeroimportgroupBystarterES6robustdeterministicparsemochasuperstructoptionsharedarraybufferinstallerdeep-clonermECMAScript 7includesdatastructuremodulemodulesreadablestreammetadataemrrecursivelook-upcore-jsTypeScriptmulti-packagecallbindreact-hooksbytehooksflatMapcontainses7comparecloudwatchfast-deep-clonequeueMicrotaskregexinstallwhatwglocationcloudtrailthrottlees-shimsFloat64ArraysetImmediateArray.prototype.containsdiffInt16ArraycopywafprettycommandRFC-6455Int8Arrayasyncarraysyupgroupcall-bindsequenceRxjwtdataViewairbnbkeycircularES2016clonestyled-componentscolumnstreamssliceless.jsregulardatarandomqsrm -rfassertlazyoncemoveshamcloudfrontdomflagpnpm9file systemvaluescloudformationmimetypesparsingBigInt64ArrayES2022duplexweaksetmapreduceclieslintplugintoobjectzeroUint16ArraypropreducerhotArray.prototype.findLastIndexcryptotypedarraypicomatchfastelbeverysideES3objtypeassertionponyfillkeyslintsharedassertscensoreast-asian-widthless mixinsECMAScript 2018eslintconfigbusyCSSescapeES2023vpcaccessibilitytrimtrimLeftpolyfillObject.assigntrimRightinternal slotECMAScript 5functionaltypedarraysreadhookformwhich
1.0.0

1 year ago