Replacement for subset of lodash, with fraction of the size.
npm i @ebay/nodash
Simply replace lodash
with @ebay/nodash
const get = require('lodash/get');
// becomes
const get = require('@ebay/nodash/get');
Often, consumers of lodash use just a handful of the methods. Lodash makes this convenient by only requiring what you need:
const get = require('lodash/get'); // or require('lodash.get') if installed
However, Lodash is optimized as an entire library, which is to say it makes heavy reuse of its own methods. So using get
may require baseGet
, which requires castPath
and toKey
, which then requires isKey
, stringToPath
, and isSymbol
... and so forth. It keeps going for many more levels.
This ends up with a bundle size of over 7kb just for using get
. While that becomes cheaper the more you use Lodash, if all you use is get
, it remains quite expensive. The Nodash version of the same method weighs in at ~500b for comparison.
As such, this library is targeted for just those users that need a small subset of Lodash, and not the whole library. It is not intended to be a replacement for Lodash.
Most methods are identical to Lodash. Some methods have partial support, to shed off edge cases for the sake of saving size. The API for all are otherwise identical to Lodash and can be a drop-in replacement in most cases.
Name | Same as Lodash? | Notes |
---|---|---|
get |
yes | get(obj, 'path.to[0].value', defaultValue) |
set |
yes | set(obj, 'path.to[0].value', value) |
has |
yes | has(obj, 'path.to[0].value') |
cloneDeep |
yes | cloneDeep(obj) |
castArray |
yes | castArray(value) |
isEmpty |
no | does not support TypedArray or Buffers. isEmpty(value)
|
isEqual |
no | only does shallow comparison |
partial |
yes | partial(func, param1, param2) |
partialRight |
yes | partialRight(func, param1, param2) |
throttle |
no | does not support trailing call throttle(func, 200)
|
Copyright 2018-2019 eBay Inc.
Author/Developer: Scott Davis
Use of this source code is governed by an MIT-style license that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
This software contains code licensed by third parties. In particular, see : https://github.com/lodash/lodash/blob/master/LICENSE
Copyright JS Foundation and other contributors https://js.foundation/
Based on Underscore.js, copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors http://underscorejs.org/
This software consists of voluntary contributions made by many individuals. For exact contribution history, see the revision history available at https://github.com/lodash/lodash
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。