Changelog

February 26, 2026 · View on GitHub

5.0.0

Breaking changes

ESM-only: The entire codebase has been migrated from the ym module system (modules.define/modules.require) to native ES modules (import/export). The ym runtime dependency has been removed.
Vite build system: ENB and all 17+ associated packages have been replaced with Vite. A custom vite-plugin-bem-levels plugin handles BEM level scanning, bem:* virtual module resolution, and redefinition chain barrel generation.
jQuery 4.0: The jquery peer dependency has been upgraded from ^3.x to ^4.0.0. Notable API change: $.unique() has been removed — use $.uniqueSort() instead.
Node.js 20+: The minimum supported Node.js version is now 20 (was 8).
Native Promises: vow has been removed. All code now uses native Promise.
Native test runner: Server-side tests now use node:test and node:assert instead of mocha/chai.
Playwright: Browser tests now use Playwright instead of mocha-phantomjs (PhantomJS is dead).
ESLint 10: Linting has been migrated from jshint/jscs to ESLint 10 with flat config (eslint.config.js).
GitHub Actions CI: Travis CI has been replaced with GitHub Actions.
Husky + lint-staged: git-hooks has been replaced with husky and lint-staged.

Notable changes

All .vanilla.js and .js source files have been converted to ES modules with import/export syntax.
Module redefinition chains (e.g., jquery with pointer event extensions) are now handled via auto-generated barrel files by vite-plugin-bem-levels.
The i18n block retains its API but uses native ES modules internally.
Browser spec tests (28 spec files, 500+ test cases) run via Vite dev server + Playwright.
Vite produces platform-specific builds (desktop, touch) with jQuery as an external dependency.

Removed packages

Build: enb, enb-bem-techs, enb-magic-factory, enb-magic-platform, enb-bemxjst, enb-bemxjst-6x, enb-bemxjst-7x, enb-bemxjst-i18n, enb-bh, enb-bh-i18n, enb-borschik, enb-css, enb-js, enb-bem-docs, enb-bem-examples, enb-bem-specs, enb-bem-tmpl-specs, enb-bem-i18n, borschik
Linting: jscs, jscs-bem, jshint, jshint-groups
Testing: mocha-phantomjs, istanbul, chai-as-promised
Other: ym, vow, bower, git-hooks, gitbook-api, bem-naming, bem-walk

Removed config files

.enb/ directory (ENB build config)
.jshintrc, .jscs.json, .jshint-groups.js (linting configs)
.bowerrc, bower.json (Bower configs)
.travis.yml (Travis CI config)
.githooks/ directory (git-hooks config)

4.3.1

Bug fixes

Reverted change that led to error when lazyInit in declMod was used (#1594).

4.3.0

Notable changes

jQuery was updated to 3.2.1 and 1.12.4 (#1587).

Bug fixes

Possibility to force lazy initialization from markup was fixed (#1579).
Possibility to declare entities with mixins was fixed (#1550).
Now lazyInit in declMod will throw an error (#1579).
With bug in isFunction method of functions block, which works wrong for special functions (#1577).

Other changes

.bemrc config was added (#1568).
vow was updated to 0.4.17 (#1565).
inherit was updated to 2.2.6 (#1519).
Private _delInitedMod method of i-bem block was removed (#1523).
Removed code for old bem-tools (https://github.com/bem/bem-core/commit/e57678b2d64a3b976a53af4a7fa09bf918685821).
npm dependencies were updated (#1589).
Now tests are executed also on Node.js 8 (https://github.com/bem/bem-core/commit/dd7e5344a64ad1595eab28febb2242134fcedbb3).
More specs for i-bem-dom were added (#1517).
gitbook was added (#1569).
JSDoc was fixed.
Documentation updates.

4.2.1

Bug fixes

Fixed an issue with elems cache invalidation on DOM modifications (#1487).
Fixed an issue in i-bem-dom__events when event's data was not passed to handler (#1509).
Fixed method isEditable of dom module. Missing editable input types were added (#1502).

Other changes

Fixed syntax error in i-bem-dom JSDoc.
Minor documentation updates.
CLA introduced.

4.2.0

Notable changes

bem-xjst 8.x support was introduced in BEMHTML templates (#1486).

Bug fixes

concat() method was fixed in i-bem-dom__collection (#1488).
An issue in ua__dom was fix (#1479).
dist: i-bem-dom__init_auto was removed from no-autoinit bundle (#1482).

Other changes

Now findChildBlock, findChildBlocks, findParentBlock, findParentBlocks, findMixedBlock and findMixedBlocks methods throw an error if block is given as String (#1469).
buildClassName function was optimized (#1404).
Docs: English translations were added (#1483, #1476, #1475).
Migration: Added notes about bemTarget (#1491).
Migration: added info about template options (#1467).
Fixed issues in docs.

4.1.1

Bug fixes

— Fixed a bug in ua block on touch.blocks level (#1460).

4.1.0

Bug fixes

Fixed a bug in identify returning different result on each call for document (#1441).
modules.define recursion problem was fixed (#1446).
Support for escaping in ua block was fixed (#1435).
Workaround for Array.prototype.push bug in Opera 41 was implemented.
An issue with pointer events on iOS devices was fixed (#1253).
An issue in i-bem-dom__events was fixed. Method once() was broken in some cases (#1452).

Other changes

Ability to specify html@lang attribute was added to page block (#751).

4.0.0

Breaking changes

Changes in the i-bem block. See MIGRATION.md.
Changes in the querystring. See MIGRATION.md.
The optional parameter onlyGet was removed from the identify module (#1028).
All static methods were removed from the events module (#1024).
The result field in Event class of events module was removed (#1023).
The css element of the page block does not support auto insertion of conditional comments for IE (#379).

3.2.0

Bug fixes

modules.define recursion problem was fixed (#1446).
Support for escaping in ua block was fixed (#1435).
Workaround for Array.prototype.push bug in Opera 41 was implemented.

Other changes

Ability to specify html@lang attribute was added to page block (#751).

3.1.0

Bug fixes

An issue in getMods() method of i-bem was fixed (#1379).

Notable changes

Templates: support for escaped mode was introduced (#1406).

Other changes

Minor documentation updates.

3.0.1

Bug fixes

An issue with pointer events on iOS devices was fixed (#1253).

3.0.0

Breaking changes

Base templates for BEMHTML and BEMTREE were removed (#1258). bem-xjst 6.3.0+ should be used instead.
File extentions of BEMHTML templates were renamed from *.bemhtml to *.bemhtml.js (#984). Please check that new extention is supported in you build config.
i-bem__i18n element was removed (#1304). Please use i18n block for internationalization.
jquery__events_type_pointerclick is not using FastClick anymore (#1088).

Notable changes

jQuery was updated to 2.2.3 and 1.12.3 (#1260).

Bug fixes

An issue in page was fixed. <meta name=viewport> had wrong user-scalable value on the touch level (#1294).
An issue in jquery__event_type_pointernative which led to JS error in IE8 was fixed (1317).

Other changes

dist: Autoinitialisation of blocks is optional now (#1271).

2.9.0

Notable changes

jQuery was updated to 2.2.0 and 1.12.0 (#1249).

Bug fixes

Fixed bug in BEMHTML 1.x which leads to drop of this.mods in reapply() (#97).

Other changes

jquery__event_type_pointerpressrelease now exposes originalEvent (#1254).
dist: Support for i18n was added to dist (#1212).
page__css.bemhtml template was updated to support new bem-xjst versions (#1228).

2.8.0

Notable changes

New i18n block was introduced, providing support for internationalization (#1074).
Now jQuery is included via https by default (#1202).
Dependency on bemhtml-compat was dropped (#1186). Users of bem-tools need to run npm i bemhtml-compat --save to install it on their projects.

Bug fixes

Bug with undefined handler call in loader_type_js was fixed (#1159).

Other changes

BH bundles in dist now mimic to BEMHTML (#1210).
bem create templates for bemhtml, bemtree, vanilla.js and browser.js were improved (#1183).
vow was updated to 0.4.10 (#1056).

2.7.0

Notable changes

New detach method was added to i-bem__dom (#1102).
i-bem.bemhtml now supports nested mixes as objects (873).
Some minor attribute escaping optimizations were added to i-bem.bemhtml (#961), (#980) and (#982).
Support for bem-xjst 2.x was added to BEMHTML templates (#1021).
clearfix was optimized to work properly in supported IE browsers (#722).
jquery was updated to 2.1.4 and 1.11.3 (#999).

Bug fixes

An issue in i-bem__dom was fixed. findElem didn't update cache of elements that had been found previously (#583).
An issue in i-bem__dom was fixed. dropElemCache worked incorrectly in some edge cases (#1037).
An issue in i-bem__dom was fixed. setMod didn't add CSS classes if blocks on the same DOM node had overlapping end parts in their names (#1090).
An issue in page was fixed. zoom attribute of the block didn't work for touch levels (#1020).
An issue in keyboard__codes was fixed. insert and delete keys had wrong key codes (#1002).
An issue in i-bem.bemhtml was fixed. applyNext calls were skipped in nested templates (b1dc50c).
An issue in jquery__events_type_pointernative was fixed to work properly in IE 11/Edge (#1066).

Other changes

Russian documentation for every blocks was reworked. Please visit https://ru.bem.info/libs/bem-core/ for new documentation.
Other minor improvements of the documentation.

2.6.0

Notable changes

Since now i-bem__dom provides module after DOM is ready (#859).
Since now setMod and hasMod methods of i-bem__dom convert their modVal argument to string in case it is not of type string or boolean (#890).
An ability to pass nonce attribute was added to page, to support related parts of Content Security Policy specification (#882).
New page__conditional-comment template was added (#551).
vow was updated to 0.4.8 (#837).

Bug fixes

An issue in i-bem.bemhtml was fixed. Block CSS class repeated in case of mix with the same block (#792).
An issue in loader_type_bundle was fixed. Success callback might be applied after timeout error (67ff55f).
An issue in i-bem__dom was fixed. append, prepend and other similar methods won't properly work with strings in some cases (#852).
An issue in jquery__event_type_winresize was fixed. MSIE wasn't detected properly (#862).
An issue in object was fixed to proper handle null value as target argument in extend method (#910).
An issue in page was fixed. There was no way to disable x-ua-compatible meta tag from BEMJSON (#794).

Other changes

Timeout in loader_type_bundle module was increased to 30000 ms (4e27422).
Russian documentation for several blocks was fixed.

2.5.1

Bug fixes

An issue in jquery__pointerpress and jquery__pointerrelease was fixed. Events work now in Internet Explorer 8 (#792).
An issue in jquery__pointernative was fixed. pointerenter and pointerleave events have bubbled up to the document root, while they shouldn't (#801).
An issue in loader_type_bundle was fixed. CSS bundle has been always added to the top of the HTML <head>, so CSS rules from the bundle might not work properly (#808).
Issues in BH templates for ua were fixed. There was no possibility to pass the content of the block from BEMJSON (#734).
An issue in page was fixed. There was a problem with conditional comments for Internet Explorer in the BH template of the block (#781).

Other changes

jquery was updated to the 2.1.3 and 1.11.2 (#778).
Russian documentation for modules: clearfix, cookie, identify, idle, inherit, keyboard, loader, next-tick, string and tick was added.
Russian documentation for i-bem.js was updated.
English guides to BEMHTM and BEMJSON were updated.

2.5.0

Notable changes

bem-core in now published under the MPL 2.0 license (#443).
An ability to specify error handler was added to loader_type_js (#672).
BEMContext class was added to oninit export context in i-bem.bemtree (#602).
reapply static method was added to BEMContext class of BEMTREE (#706).
bh templates for block page were added to touch level (#689).
bem-xjst was updated to 0.9.0 (#709).

Bug fixes

An issue in i-bem__dom was fixed. findBlocksInside could return blocks which weren't inited (#699).
An issue in tick was fixed. Timer was not removed by Tick#stop() (#694).
An issue in i-bem.bemhtml was fixed. i-bem CSS class was added to elements by mistake (#633).
html-from-bemtree tech was fixed to expose vow, console, setTimeout inside BEMTREE template context (#438ebb8).

Other changes

English guide to BEMJSON was added.
Russian documentation for querystring module was added.
Russian documentation for i-bem.js was fixed to satisfy current API.
Documentation for BEMHML/BEMTREE for both languages was updated.

2.4.0

Notable changes

bem-xjst was updated to 0.8.0; bemhtml-compat was updated to 0.0.11.

Bug fixes

An issue in jquery__event_type_pointerpressrelease was fixed. pointerpress/pointerrelease events fired for any press/release of mouse button (#607).
An issue in i-bem__dom.js was fixed. Base live method was not properly called in some edge cases (#608).

Other changes

English documentation for JS-syntax of BEMHTML was added.

2.3.0

Notable changes

New implementation of pointer events was added. Based on pointer events polyfills from Polymer (#567).
Ability to specify additional data for event was added to bindTo* methods of i-bem__dom.js (#568).

Other changes

An issue in i-bem.bemhtml was fixed. There was an error when mix was used as an object (not an array) in BEMJSON and BEMHTML simultaneously (#555).
An issue in page was fixed. There was no possibility to apply standard modes to page in BEMHTML template and touch template was broken (516).

2.2.4

Bug fixes

An issue in i-bem.js was fixed. Modifier change event has been emitted even if beforeSetMod handler had prevented change (#546).
String decoding process of querystring__uri module was fixed to return original string if decode failed (#554).

2.2.3

Bug fixes

Destruction process of blocks was fixed to prevent unexpected block reinitialization (#540).
An issue in jquery__event_type_pointer was fixed. Native mouse events were replaced with pointer events in unexpected cases (#534).
unbindFrom* methods of i-bem__dom now support multiple events to be passed in arguments (#533).
Lost functions dependency in events module was restored (#532).

2.2.2

Bug fixes

An issue with block reinitialization on the DOM node, that has been processed with destructor, was fixed in i-bem__dom (#518).
An issue in mod events subscription was fixed in i-bem. false could be used as modVal (#529).
jquery was updated to the latest minor releases 2.1.1 and 1.11.1 (#515).

2.2.1

An issue in jquery__event_type_pointerpressrelease was fixed. pointerpress event has been triggered twice on each mousedown in IE10 (#505).

2.2.0

Notable changes

New keyboard__codes module has been added (#431).
BEMContext class was added to oninit export context in i-bem.bemhtml (#485).
Ability to declare elements with block class has been added (#481).
Behaviour of isSimple method of BEMContext was fixed in i-bem.bemhtml (#432).
An issue with liveUnbindFrom method of BEMDOM was fixed in i-bem__dom (#476).
An issue with isFocusable method of dom module was fixed for cases where domElem is a link with tabindex attribute, but without href (#501).
Short way of module declaration was fixed for i-bem__dom_elem-instances (#479).
A workaround for rendering performance of blocks initialisation in Chrome-based browsers was added to i-bem__dom_init_auto (#486).
vow.js module has been moved to vow.vanilla.js (#412).

Other changes

vow module has been updated to 0.4.3 (#504).
Russian documentation about BEMTREE technology was added (#500).
Russian documentation for JS-syntax of BEMHTML was updated (#471).
API references for JS-modules has been added as a separate branch v2-jsdoc (#478).

2.1.0

Notable changes

An issue in i-bem.js when modifiers change event had been emitted before onSetMod handlers have been called was fixed (#454).
An issue in i-bem.bemhtml was fixed. Since now this.mods and this.ctx.mods use the same object (#441).
Error in modular declaration of element modifiers was fixed in i-bem__dom_elem-instances (#447).
inherit module was updated to 2.2.1 (#466).
An order of tags in head section of page.bemhtml was fixed (#465).

Other changes

baseMix field description of i-bem.js was added to russian docs (#461).
CDN host was changed to yastatic.net (#444). Previous CDN host yandex.st is still accessible. Physically they both are the same web servers. DNS records is the only difference.
BEMHTML template for bem create command was added (#277).
We do not support autobuilding of our tests with Node.js 0.8 in Travis CI any longer (#455).
Travis's build status badge was changed to SVG version :)

2.0.0

Breaking changes

All deprecated methods have been removed from i-bem.js and i-bem__dom.js (#318). The following methods were removed:
- destruct, use onSetMod js '';
- extractParams, use elemParams;
- trigger, use emit;
- afterCurrentEvent, use next-tick module;
- channel, use events__channels module;
- changeThis, use native Function.prototype.bind.
init and destruct events have been removed from i-bem.js in favor of modifiers changes events (see "Notable changes" section below).
ecma was moved to separate repo; ES5-shims should be used for IE < 9 (#230).
vow module has been updated to 0.4.1 (#350). See Vow's changelog for changes.
Support for vow@0.4 has been added to i-bem.bemhtml (#385).

Notable changes

Support for defining BEMDOM-blocks as ym modules has been added (#382).
Events for modifiers changes have been added to i-bem.js (#357).
Support for passing string values has been added to BEMDOM.init (#419). and BEMDOM.update methods (#420).
DOM helpers from i-bem__dom.js replace, append, prepend, before, after now return new context and update returns updated context as a jQuery object (#410).
New loader_type_bundle has been added (#358).
Default jQuery versions were updated to 2.1.0 and to 1.11.0, for IE < 9 (#356).

Other changes

i-bem.bemhtml now uses strings concatination instead of pushing to buffer in it's internals (#401).
jQuery no longer removes itself from global scope if it exists (#349).
jquery__event_type_pointerclick.js has been moved from touch level to common (#393).
Modifiers i-bem_elem-instances_yes and i-bem__dom_elem-instances_yes were renamed to boolean style (#352).
Runtime error in page template in development mode has been fixed (#417).
Usage of Function.prototype.bind has been droped from i-bem.js internals in favor of support for Android 2.3 (#404).
Some bugs in browser-js+bemhtml tech have been fixed (#392).
Up to ym@0.0.15 (#414).

1.2.0

Notable changes

BEM-blocks are emit destruct event on destructing (#370).
Improvements of pointerevents polyfills (#354).

Other changes

All JSDocs were fixed so bem-jsd could parse them (#335).
Russian version of BEMHTML reference was actualized to JavaScript syntax (#355).
Use bower for dependency management (#367).

1.1.0

Notable changes

jquery__config uses jQuery 2.x by default for modern browsers (#319).
Add ability to use any BEMJSON as value of attributes in BEMHTML templates (#290).
Fix dependencies in i-bem__collection (#292).
Remove page block touch styles (#306).
Fix page BEMHTML wrapping in production mode (#309).
Fix possible JavaScript error in script injection in IE<9 in next-tick (#324).
Fix FastClick initialisation in jquery__event_type_pointerclick of touch.blocks (#332).
Fix node.js tech bug on Windows systems (#274).
Fix i-bem__dom_elem-instances bug with onElemSetMod (#340).
Use bemhtml from bem-xjst (#329).

Other changes

ym was updated to 0.0.12 (#326).
Do not flood console with messages if i-bem__i18n is not in debug mode (#285).
Fix jsdoc for dropElemCache() method of i-bem__dom module (#296).
Development infrastructure was updated to bem-pr@v0.5.x (#323).
Russian documentation for i-bem.js was updated.
List of supported browsers was specified in project README.

1.0.0

Breaking changes

Starts using modular system ym.
Removes all deprecated methods from i-bem and i-bem__dom.
i-bem now has no dependency on jQuery. i-bem__dom still depends on jQuery.
BEMHTML-template can be written with JS-syntax.
Introduces new tech bemtree (based on bem-xjst) for describing dynamic generation of BEM-tree.
Introduces new tech vanilla.js for JS-implementations that does not depend on particular JS-engine.
Introduces new techs browser.js and node.js for JS-implementations targeted corresponding engines. For backward compatibility we assume that .js-files contains browser.js implementation.
Introduces polyfill (jquery__event_type_pointer and jquery__event_type_pointerclick as a jQuery-plugins) for universalize desktop and touch pointer events.
Introduces system for unit testing and blocks examples generation.
Introduces "simple" modifiers (modifiers without value) support in i-bem and BEMHTML.

Other changes

Gets rid of prefixes in all block names (except i-bem).
Block i-bem__dom becomes a module (in terms of ym) and all BEM.DOM-block must define additions to i-bem__dom (example).
Method for blocks declaration (.decl()) does not accept object with name field as first parameter. Required form with block field: BEM.decl({ block: 'b1', modName: 'm', modVal: 'v' }, ...).
Introduces nextTick method as replacement for afterCurrentEvent method for ensure of block existence in callback invocation time. BEM.afterCurrentEvent is deprecated.
Introduces new channels module instead of BEM.channel. BEM.channel is deprecated.
changeThis is deprecated. Use native bind instead.
Removes del method from i-bem block.
Removes getWindowSize method from i-bem__dom block. Use BEMDOM.win.width() and BEMDOM.win.height().
Introduces jquery module-wrapper for providing jQuery. If jQuery already included into the page module-wrapper provides it. Otherwise it loads jQuery (version 1.10.1) on its own.
$.observable becomes events module and not longer depends on jQuery.
$.inherit becomes inherit module and not longer depends on jQuery.
$.identify becomes identify module and not longer depends on jQuery.
$.throttle splits into two modules: functions__throttle and functions__debounce, they both not longer depend on jQuery.
$.decodeURI, $.decodeURIComponent moves to querystring__uri module and not longer depends on jQuery.
$.cookie becomes cookie module and not longer depends on jQuery.
Introduces ua module instead of $.browser (with same interface).
Use pointerclick instead of leftclick. It provides by jquery__event_type_pointerclick polyfill.
i-system block splits into two modules: idle and tick.
Triggers for modifiers changes now splitted into two groups: before setting new value (beforeSetMod and beforeElemSetMod) and after the value has been set (onSetMod and onElemSetMod). Cancellation of modifiers change is possible only from before*-triggers.
Using of { onSetMod : { js : function() { ... } } } is deprecated, use onSetMod: { js : { inited : ... } } }.
destruct method from i-bem block is deprecated. Use supplementary trigger for _js modifiers: onSetMod: { js : { inited : ... } } } — { onSetMod : { js : { '' : ... } } }.
exractParams method from i-bem__dom block is deprecated. Use elemParams method for access to elements params.
trigger method from i-bem block is deprecated in flavor of emit method.
onFirst method from i-bem block is deprecated in flavor of once method.
Deprecated field e.block that provided block-target of BEM-events was removed. Use e.target field instead.
Field e.data.domElem that provided DOM-element of block in DOM-events was removed. Use $(e.currentTarget) (provided by jQuery).
Introduces parameter for findElem method that allows to search elements of particular block instance (in case of nested blocks with same name).
Introduces possibility to point particular function in unbindFrom* methods.
Introduces objects module for work with JS-objects. It contains methods: extend, isEmpty, each.
Introduces functions module for work with JS-functions. It contains methods: isFunction, noop.
Introduces dom module for work with DOM-tree.
Introduces querystring module for work with URL-based strings.
Introduces loader_type_js module for JS loading.
Introduces vow module for Promises/A+.
Introduces next-tick module as polyfill for nextTick, setImmediate, setTimeout(0, ... and etc.
Introduces strings__escape module for XML, HTML and attributes escaping.
inherit module now supports mixins.
Introduces invokeAsap parameter for functions__throttle module that allows to delay first invocation.