Documentation on bem-core in a much more informative way is also available at bem.info. It is also available in Russian.
bem-core is a base library for web interface development.
It provides the minimal stack for coding client-side JavaScript and templating.
The easiest way to run a project with bem-core is to use
the project-stub.
You can use any other way you are familiar with to include the library into the project.
common.blocks — suited for any devices and browsersdesktop.blocks — should be used for desktop browserstouch.blocks — implement some touch-platforms specificsi-bem — base block with helpers for JS and HTMLstrings — helpers for JS-stringsobjects — helpers for JS-objectsfunctions — helpers for JS-functionsevents — JS-eventsquerystring — helpers for work with querystringtick — global timeridle — IDLE eventnext-tick — polyfill for nextTick/setTimeout(0, ...)inherit — OOP helpersjquery — jQueryclearfix — CSS clearfix trickidentify — identify JS-objectscookie — helpers for work with browser cookiesvow — Promises/A+ implementationdom — helpers for work with DOMloader — loader for JS filesua — browser features detectionkeyboard — keyboard helperspage — html/head/body scaffoldThe autogenerated JSDoc API can be found on bem.info. E.g. JSDoc for i-bem is here https://en.bem.info/libs/bem-core/current/desktop/i-bem/jsdoc/
You can check the changelog at the Changelog page.
If you used BEM before, check the migration instructions.
Get the needed version code (e.g., v2):
$ git clone -b v2 git://github.com/bem/bem-core.git
$ cd bem-core
Install the dependencies:
$ npm install
You need export PATH=./node_modules/.bin:$PATH
or an alternative way to run locally-installed npm dependencies.
Install all necessary libraries:
$ npm run deps
Build and run tests (specs):
$ npm test
Run development server:
$ npm start
Please refer to How to contribute guide.
A default test bundle for functions__debounce:
$ magic make desktop.specs/functions__debounce
You can see the results of the tests in the terminal after the building process finishes.
You can also watch them in a browser loading desktop.specs/functions__debounce/spec-js+browser-js+bemhtml/spec-js+browser-js+bemhtml.html.
Run tests for other BEM entities in the same way. This will work for those which are equipped with .spec.js file.
To build code coverage report add ISTANBUL_COVERAGE=yes environment variable to the tests run command:
$ ISTANBUL_COVERAGE=yes magic make desktop.specs && istanbul report html
You can run modular testing with coverage as well by using more concrete build target as was described above.
$ ISTANBUL_COVERAGE=yes magic make desktop.specs/functions__debounce && istanbul report html
After tests finish, you can view coverage HTML report by opening coverage/index.html in your favorite
browser.
The whole code coverage statistics can be found on the bem-core profile page on Coveralls.
Tests are built with a enb-bem-specs library. Check the details (available in Russian only).
Our browser support policy is based on statistics we get from Yandex services.
Browsers with more than 2% users get full compliant support, more than 0.5% — partially compliant (which means that data is accessible but not necessary 100% functional). New features testing is not provided by us for browsers with less than 0.5% users.
Code and documentation copyright 2012 YANDEX LLC. Code released under the Mozilla Public License 2.0.
4.2.0
bem-xjst 8.x support was introduced in BEMHTML templates (#1486).concat() method was fixed in i-bem-dom__collection (#1488).ua__dom was fix (#1479).i-bem-dom__init_auto was removed from no-autoinit bundle (#1482).findChildBlock, findChildBlocks, findParentBlock, findParentBlocks, findMixedBlock and findMixedBlocks methods throw an error if block is given as String (#1469).buildClassName function was optimized (#1404).FAQs
bem-core Library
The npm package bem-core receives a total of 55 weekly downloads. As such, bem-core popularity was classified as not popular.
We found that bem-core demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Critics call the Node.js EOL CVE a misuse of the system, sparking debate over CVE standards and the growing noise in vulnerability databases.
Security News
cURL and Go security teams are publicly rejecting CVSS as flawed for assessing vulnerabilities and are calling for more accurate, context-aware approaches.
Security News
Bun 1.2 enhances its JavaScript runtime with 90% Node.js compatibility, built-in S3 and Postgres support, HTML Imports, and faster, cloud-first performance.