« Changelog History


Sugar v2.0.0 Release Notes

Release Date: 2016-11-05 // over 7 years ago

  • API Changes

    • ➕ Added global objects. All methods will also be defined here.
    • ✂ Removed String#escapeRegExp. Use RegExp.escape instead.
    • 🔄 Changed String#escapeHTML to double-escape entities.
    • Date#utc is now Date#setUTC.
    • Date.SugarNewDate is now an option accessor Sugar.Date.setOption('newDateInternal', fn)
    • 👀 Modified String#startsWith and String#endsWith to be more in compliance with ES6. See CAUTION.md for details.
    • ✂ Removed String#has in favor of String#includes to be more in compliance with ES6. See CAUTION.md for details.
    • ➕ Added Number.isNaN shim. Removed Object.isNaN in favor of this.
    • Alphanumeric array options are now on the global object.
    • 🚚 Moved Object.map, Object.each, and Object.size to the object module.
    • ➕ Added Object.isArguments.
    • 🔄 Changed String#each (renamed to String#forEach) to allow breaking the loop with false.
    • ➕ Added ability for String#stripTags and Strip#removeTags to pass a callback.
    • 🚚 Made String#stripTags and String#removeTags much more robust.
    • ✂ Removed String#normalize and will put into its own plugin module as String#toAscii later.
    • ⚡️ Updated Array#sortBy to handle sorting on multiple properties (Issue #386, thanks to @eric-weiser).
    • 🛠 Fixed String#unescapeHTML to handle HTML (and hex) codes. Also now handling  
    • ➕ Added a third argument to Number#bytes to allow normal SI units.
    • ⚡️ Object.merge updated to take an options object. Non-enumerable property support is now an option, as well as property descriptors. Resolver function now will not traverse further into a deep merge if it has been resolved with a function. Sugar global object continues the merge.
    • 👍 Allowing a global thousands and decimal marker to be set.
    • String#hankaku now makes a hyphen from hyphen-like fullwidth chars in number mode.
    • 🛠 Fixed issue with the digit ten in date creation (Issue #431).
    • 🛠 Fixed issue with the Date#[unit]Since improperly applying error margins.
    • 🔨 Refactored the since and fromNow methods to traverse using internal date methods instead of applying an error margin. This makes them much more accurate in dicey situations like DST traversal, leap years, etc.
    • 🛠 Fixed issue with dates shifting in "monthsFromNow" (and consequently "relative") when traversing into a month that doesn't have enough days.
    • 🛠 Fixed issue with advance/rewind using an object with both a "week" and "day" parameter (Issue #492).
    • 🛠 Fixed issue Function#every not being able to cancel itself (Issue #488).
    • 🛠 Fixed issue with German dates not allowing abbreviated weekdays with 2 characters.
    • ➕ Added Date#get allowing date creation with a context date that can be used as a starting point for relative dates.
    • ➕ Added Function#memoize (Issue #486)
    • 🔀 Async functions are now synchronous with Sinon.
    • 📇 Renamed Object.equal and Object#equals to isEqual for parity.
    • ✂ Removed Date.utc object as well as Date.past and Date.future in favor of an options object on Date#create.
    • ✅ Renamed Function#fill to Function#partial. Tests from Underscore and Lodash brought in to confirm conformitive behavior.
    • 🛠 null now no longer acts as a placeholder in Function#partial. Other bugs fixed around this including using partial on constructors.
    • Date#create options object now uses fromUTC instead of just utc. A new option setUTC is also added which will set the internal utc flag on creation.
    • 🔨 String#assign refactored and renamed to String#format. Tokens are zero based and a few other changes.
    • ➕ Added Object.get and Object.set, allowed them to use dot, bracket, range, and push syntax, and allowed deep object transforms on Array#map, and other methods.
    • 🛠 Fixed many issues with DST and simplified month traversal.
    • 📇 Renamed Array#randomize to Array#shuffle
    • ➕ Added Array#sample ability to remove sampled elements and performance optimization.
    • ➕ Added String#replaceAll and String#removeAll.
    • ➕ Added polyfill for Array.from and modified Array.create to return a reference by default.
    • 🔄 Changed behavior of Function#after to more closely match that of Underscore/Lodash.
    • 🔄 Changed behavior of Number#times to return an array of return values.
    • 🔄 Changed Object.fromQueryString to return a plain object.
    • ✂ Removed Object.watch and Object.unwatch.
    • ✂ Removed ability for Date.create to accept enumerated arguments.
    • Modified Object.toQueryString to accept an options object.
    • Modified Object.fromQueryString to accept an options object.
    • ➕ Added support for Sets in isEqual.
    • ➕ Added Array#median.
    • Modified Number#metric to use a more flexible system of defining units.
    • ➕ Added strf tokens to Date#format as well as a number of new standard tokens. Aligned tokens more with moment/ldml and renamed to ldml in the code.
    • Modified Array#at and String#at to use arrays instead of enumerated arguments.
    • ✂ Removed mixed modes for String#hankaku and String#zenkaku.
    • 🐎 Modified String#replaceTags and String#stripTags to simplify argument signature and small performance boost.
    • ➕ Added Array#isEqual.
    • 🚚 Renamed RegExp#addFlag and RegExp#removeFlag to RegExp#addFlags and RegExp#removeFlags, and ensured they work on multiple flags.
    • Created new module enumerable, and split out array methods.
    • ✂ Removed Array#findAll in favor of Array#filter and Array#filterFromIndex.
    • Replaced Object.findAll with Object.filter.
    • Array#isEmpty now only checks for zero length.
    • ⚡️ Moved Object.select and Object.reject to enumerable module and updated to match objects on key existence.
    • ➕ Added Object.remove and Object.exclude.
    • ➕ Added Array#append to take the place of Array#add. Array#add now is non-destructive. Array#insert now aliases append instead of add.
    • ✂ Removed Array#include (now is identical to Array#add).
    • ➕ Added Object.invert.
    • 🚚 Moved String#titleize to String module from Inflections.
    • Modified Object.has to allow deep keys. Also added a flag to allow properties in the prototype.
    • ✂ Removed Object.extended and all trace of Hashes in favor of Sugar chainables.
    • ➕ Added date unit methods to ranges.
    • 👍 Allowed excepting and allowing entire namespaces.
    • Flipped "si" argument to Number#bytes to instead be "binary".
    • Modified String#capitalize to have an extra parameter for downcasing.
    • 🔨 Refactored inflections module to have a more straightforward API.
    • ⚡️ Updated Array#sortBy to not clone the array by default.
    • Modified Date#reset to use higher units to make more semantic sense.
    • Reversed arguments in Date#relative.
    • ✂ Removed Array#each in favor of Array#forEachFromIndex in cases where the index is needed.
    • ➕ Added fromIndex methods. Moved findFrom and findIndexFrom to be inline with these.
    • 📇 Renamed Object.each to Object.forEach to bring it in line with other methods.
    • 🔄 Changed Array#subtract, Array#intersect, and Array#union to only accept a single argument to follow other methods more closely.
    • ✂ Removed String#add, which on its own is largely useless in favor of String#insert which was previously an alias.
    • ✂ Removed all and any aliases.
    • 🚚 Moved the step argument in Number#upto and Number#downto to be an optional 2nd argument.
    • ✂ Removed callbacks in Object.keys and Object.values. Object.forEach should be preferred method of iteration.
    • 🔄 Changed object iteration callbacks to be value first.
    • 📇 Renamed String#each to String#forEach.
    • 🔄 Changed min/max/least/most args to put the callback at the end.
    • ✂ Removed String#paragraphs.
    • ➕ Added Object.addAll.