BellaJS is a lightweight library with the useful functions for handling string, array, date, schedule and dom/event. It supports both Node.js and browser environments.
npm install bellajs
BellaJS does not require any dependency.
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>
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 offset
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 after every 5 minutes
- Bella.scheduler.once('5h', callback)
--> call callback after 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 remain fours methods just are the shortcuts.
The following object Bella.dom, Bella.event and Bella.device are not available on Node.js environment.
The HTML DOM Elements returned by Bella.dom's methods have several helpful method as below:
/test/SpecRunner.html
FAQs
A useful helper for any javascript program
The npm package bellajs receives a total of 8,181 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
Company News
Socket is joining TC54 to help develop standards for software supply chain security, contributing to the evolution of SBOMs, CycloneDX, and Package URL specifications.
Security News
PyPI now allows maintainers to archive projects, improving security and helping users make informed decisions about their dependencies.
Research
Security News
Malicious npm package postcss-optimizer delivers BeaverTail malware, targeting developer systems; similarities to past campaigns suggest a North Korean connection.