bellajs

BellaJS

Lightweight util for handling data type, string... in your Node.js and browser apps.

Setup

• Node.js

  npm install bellajs
  

• CDN

  • bella.js
  • bella.min.js
  • bella.min.map

• Also supports ES6 Module, CommonJS, AMD and UMD style.

Usage

var bella = require('bellajs');

// or:
import bella from 'bellajs';

// or import several methods only
import {
  isArray,
  isString
} from 'bellajs';

// similar:
var {
  isArray,
  isString
} = require('bellajs');

APIs

DataType detection

• .isArray(Anything val): check if val is Array
• .isBoolean(Anything val): check if val is Boolean
• .isDate(Anything val): check if val is Date
• .isElement(Anything val): check if val is likely a DOM element
• .isEmail(Anything val): check if val is well-format email address
• .isEmpty(Anything val): check if val is [], {} or ''
• .isFunction(Anything val): check if val is Function
• .isInteger(Anything val): check if val is an integer
• .isLetter(Anything val): check if val is letter
• .isNull(Anything val): check if val is null
• .isNumber(Anything val): check if val is Number
• .isObject(Anything val): check if val is Object
• .isString(Anything val): check if val is String
• .isUndefined(Anything val): check if val is Undefined

Template

• .template(String tpl)

Returns an object with .compile() method

Example:

var tpl = [
  '<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: '[e-mail]'
  }
}

var html = bella.template(tpl).compile(data);
console.log(html);

Other utils

.clone(Anything val):

Return a copy of val.

let b = [
  1, 5, 0, 'a', -10, '-10', '',
  {
    a: 1,
    b: 'Awesome'
  }
];

let cb = bella.clone(b);
console.log(cb);

cb now has the same values as b, while the properties are standalone, not reference. So that:

cb[7].a = 2;
cb[7].b = 'Noop';

console.log(b[7]);

What you get is still:

{
  a: 1,
  b: 'Awesome'
}

.copies(Object source, Object target[[, Boolean requireMatching], Array excepts]):

Copy the properties from source to target.

• requireMatching: if true, BellaJS only copies the properties that are already exist in target.
• excepts: array of the properties properties in source that you don't want to copy.

Example:

let a = {
  name: 'Toto',
  age: 30,
  level: 8,
  nationality: {
    name: 'America'
  }
};
let b = {
  level: 4,
  IQ: 140,
  epouse: {
    name: 'Alice',
    age: 27
  },
  nationality: {
    long: '18123.123123.12312',
    lat: '98984771.134231.1234'
  }
};

bella.copies(a, b);
console.log(b);

Output:

{
  level: 8,
  IQ: 140,
  epouse: {
    name: 'Alice',
    age: 27
  },
  nationality: {
    long: '18123.123123.12312',
    lat: '98984771.134231.1234',
    name: 'America'
  },
  name: 'Toto',
  age: 30
}

.createId([Number length [, String prefix]])

.equals(Anything a, Anything b)

.md5(String s)

.random([Number min [, Number max]]):

Note

Some parts of bella have been split to separate modules, including:

• bella.stabilize: stabilize.js
• bella.date: bella-date
• bella.scheduler: bella-scheduler
• bella.detector: device-detector

Test

git clone https://github.com/ndaidong/bellajs.git
cd bellajs
npm install
npm test

License

The MIT License (MIT)