BellaJS is a lightweight library with the useful functions for handling string, array/object, datetime, schedule, template and dom/event better and easier. It supports both Node.js and browser environments.
npm install bellajs
And then:
var Bella = require('bellajs');
console.log(Bella.date.utc());
Assuming there is a file bella.min.js located at "/public/js/lib/", the following ways can be used to include BellaJS:
System.config({
baseURL: '/public/js/lib',
map: {
bella: 'bella.min'
}
});
System.import('bella').then(function(Bella){
console.log(Bella.date.utc());
});
require.config({
baseUrl: '/public/js/lib',
paths: {
bella: 'bella.min'
}
});
requirejs('bella', function(Bella){
console.log(Bella.date.utc());
});
<script type="text/javascript" src="/public/js/lib/bella.min.js"></script>
In the browsers, this method automatically executes and its result - current browser info - is being set to Bella.device object.
In Node.js environment, this method can be used to detect the device with it the request has been sent. Here is an example:
var bella = require('bellajs');
var server = require('http').createServer(function(req, res){
res.writeHeader(200, {'Content-Type': 'text/plain'});
res.write('Running...');
var ua = req.headers['user-agent'];
// Let's BellaJS parse userAgent string
var deviceInfo = bella.detectDevice(ua);
// see how does it look like:
console.log(deviceInfo);
res.end();
});
var port = 8080;
server.listen(port, function(){
console.log('Running at http://127.0.0.1:%s', port);
});
An another example with ExpressJS:
var bella = require('bellajs');
var express = require('express');
var app = express();
app.use(function(req, res, next){
var ua = req.headers['user-agent'];
// Let's BellaJS parse userAgent string
var deviceInfo = bella.detectDevice(ua);
// see how does it look like:
console.log(deviceInfo);
// or attach to response object to reuse at another place
res.device = deviceInfo;
next();
});
var port = 8080;
app.listen(port, function(){
console.log('Running at http://127.0.0.1:%s', port);
});
What does Bella.make do?
This is a simple template engine that allows to quickly assign the values from object "d" to the template string "s".
Here is an example:
var template = [
'<article>',
'<a href="{link}">{title}</a>',
'<p>{content}</p>',
'<p>',
'<span>{author.name}</span>',
'<span>{author.email}</span>',
'</p>',
'</article>'
].join('');
var data = {
title: 'Hello world',
link: 'http://google.com',
content: 'This is an interesting thing, is that right?',
author: {
name: 'Dong Nguyen',
email: 'ndaidong@gmail.com'
}
}
var html = Bella.compile(template, data);
console.log(html);
How to use Bella.sort?
var a = [1, 5, 19, 6, 4, 11, 7, 22, 40, 3, 8];
console.log('Array a, default:');
console.log(a);
console.log('Array a, from lower to higher:');
var a1 = Bella.sort(a);
console.log(a1);
console.log('Array a, descendant:');
var a2 = Bella.sort(a, -1);
console.log(a2);
var players = [
{
'name': 'Jerome Nash',
'age': 24
},
{
'name': 'Jackson Valdez',
'age': 21
},
{
'name': 'Benjamin Cole',
'age': 23
},
{
'name': 'Manuel Delgado',
'age': 33
},
{
'name': 'Caleb McKinney',
'age': 28
}
];
console.log('\nList of players as it is:');
players.forEach(function(item){
console.log([item.name, item.age].join(' | '));
});
console.log('\nSort by age from young to old:');
var players1 = Bella.sort(players, 'age');
players1.forEach(function(item){
console.log([item.name, item.age].join(' | '));
});
console.log('\nAnd then reverse them:');
var players2 = Bella.sort(players, {age: -1});
players2.forEach(function(item){
console.log([item.name, item.age].join(' | '));
});
Default pattern is 'D, M d, Y H:i:s A'. Without any parameter, Bella.date.format() return a string related to current time, in the format of default pattern.
BellaJS' datetime pattern is familiar with PHP developers than MomentJS. The available characters in the pattern are:
- Y: full year, ex: 2050
- y: short year, ex: 50
- F: full month name, ex: August
- M: short month name, ex: Aug
- m: month index with zero, ex: 08 (in 08/24/2050)
- n: short month name with no zero, ex: 8 (in 8/24/2050)
- S: the ordering subfix for date, ext: 1st, 2nd, 3rd, 4th
- j: day of the month, with no zero, ex: 3 (in 18/3/2050)
- d: day of the month, with zero, ex: 03 (in 18/03/2050)
- t: date in year
- w: weekday in number
- l: long name of weekday, ex: Sunday
- D: short name of weekday, ex: Sun
- G: hour, with no zero: 0 - 24
- g: hour, with no zero: 0 - 12
- h: hour, with zero: 00 - 24
- H: hour, with zero: 00 - 12
- i: minute: 00 - 59
- s: second: 00 - 59
- a: am, pm
- A: AM, PM
- O: timezone
Examples:
// default datetime (local)
var t = Bella.now();
console.log(t);
// format it as YYYY/MM/DD hh:ii:ss
var f = Bella.date.format('Y/m/d H:i:s', t);
console.log(f);
// this is a time in future
var atime = 80616962585961;
console.log(atime);
// display it as your local time
var local = Bella.date.local(atime);
console.log(local);
// display it as GMT time
var utc = Bella.date.utc(atime);
console.log(utc);
// display it with default pattern
var s = Bella.date.format(false, atime);
console.log(s);
Scheduler is the best utility BellaJS provides. Almost cases you can use Bella.scheduler instead of setInterval or setTimeout, because it runs only one timer for the entire process. Regarding parameter "pattern" for Bella.scheduler.every, it may be:
1, A string in the format of 'Y m d H i s'.
For example:
- Bella.scheduler.every('2040 05 16 15 30 10', callback);
--> run callback at 15:30:10 on May 16, 2040
- Bella.scheduler.every('* 05 16 15 30 10', callback);
--> run callback at 15:30:10 on May 16 of years
--> similar to yearly('05 16 15 30 10', callback)
- Bella.scheduler.every('* * 16 15 30 10', callback);
--> run callback at 15:30:10 on the 16th of months
--> similar to monthly('16 15 30 10', callback)
- Bella.scheduler.every('* * * 15 30 10', callback);
--> run callback at 15:30:10 of days
--> similar to daily('15 30 10', callback)
- Bella.scheduler.every('* * * * 30 10', callback);
--> run callback at the 10th second of the 30th minute of hours
--> similar to hourly('30 10', callback)
- Bella.scheduler.every('* * * * * 10', callback);
--> run callback at the 10th second of minutes.
2, A string in the format of 'weekday H:i:s'.
For example:
- Bella.scheduler.every('sunday 15:30:10', callback);
--> run callback on Sundays at 15:30:10
- Bella.scheduler.every('sunday 15:30', callback);
--> run callback on Sundays at 15:30:00
- Bella.scheduler.every('sunday 15', callback);
--> run callback on Sundays at 15:00:00
It's possible to use "sun" instead of "sunday", "mon" for "monday", and so on.
3, A string in the format of 'N unit'.
For example:
- Bella.scheduler.every('5m', callback)
--> call callback every 5 minutes
- Bella.scheduler.once('5m', callback)
--> call callback in 5 minutes, then stop
The available units: d (days), h (hours), m (minutes), s (seconds).
Bella.scheduler.once do the same thing as Bella.scheduler.every, but just once. The 4 remain methods yearly(), monthly(), daily(), hourly() can be looked as the shortcuts of every().
The following sub objects are not available in Node.js environment.
The keywords "name", "value", "expires", "domain" and "path" are steadfast.
Bella.cookie.set also accepts an object. Its first two parameters are required, while the third parameter is a string in the format of "N units", such as 2d (2 days), 6h (6 hours), -30m (30 minutes ago), etc...
Examples:
// set a cookie
Bella.cookie.set('userid', 'A98kja8967jkqwKOL');
// another way
Bella.cookie.set({
name: 'userid',
value: 'A98kja8967jkqwKOL'
});
// get its value
var userid = Bella.cookie.get('userid');
// unset it
Bella.cookie.unset('userid');
The HTML DOM Element returned by Bella.dom's methods have several helpful functions as below:
BellaJS DOM vs jQuery 2.x DOM : http://jsperf.com/bellajs-dom
Examples:
Bella.dom.ready(function(){
// Add a new element to document.body
var container = Bella.dom.add('DIV');
// then add a DIV element into container
var div1 = Bella.dom.add('DIV', container);
// then add a class "sub-item" to child DIV
div1.addClass('sub-item');
// more a child DIV
var div2 = Bella.dom.add('DIV', container);
// also add a class "sub-item"
div2.addClass('sub-item');
// now, we can extract list of elements by class name:
var subItems = Bella.dom.all('.sub-item');
console.log(subItems);
// create a button
var btn = Bella.dom.add('BUTTON');
// set label
btn.html('Say Hello!');
// set an event listener
Bella.event.on(btn, 'click', function(){
alert('Hello! How it\'s going?');
});
// simulate a click event on there (it works as same as jQuery.trigger method)
Bella.event.simulate(btn, 'click');
});
/test/SpecRunner.html
FAQs
A useful helper for any javascript program
The npm package bellajs receives a total of 13,384 weekly downloads. As such, bellajs popularity was classified as popular.
We found that bellajs demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer 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
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.
Security News
Biden's executive order pushes for AI-driven cybersecurity, software supply chain transparency, and stronger protections for federal and open source systems.
Security News
Fluent Assertions is facing backlash after dropping the Apache license for a commercial model, leaving users blindsided and questioning contributor rights.