❤
npm
Sign UpSign In

nonstandard

1.1.1 • Public • Published

Readme

NPM

Build Status Dependencies npm version Code Climate Test Coverage bitHound Overalll Score

Some non standard JavaScript features.

from Node.js > 0.12.0

Usage

require('nonstandard'); // Install all features
 
// install specified function
require('nonstandard/src/array/contains').Install();
[1, 2, 3].contains(2); // true
 
// Install some module
require('nonstandard/src/array').Install();
require('nonstandard/src/console').Install();
require('nonstandard/src/number').Install();
require('nonstandard/src/object').Install();
require('nonstandard/src/string').Install();

Contents

console.pipe

Log value to console and pass value First value was passed next.

console.pipe(returnValue: any, logValue1: any, logValue2: any, logValueN: any) : any;

Install:

require('nonstandard/src/console').Install();
// write `123` to console with `console.log`
var a = console.pipe(123);
 
// write:
// hello world
// hello
//
console.log(console.pipe('hello', 'world'));

console.[log, info, warn, error].pipe

console.log.pipe(value: any, ...values: any[]) : any;
console.info.pipe(value: any, ...values: any[]) : any;
console.warn.pipe(value: any, ...values: any[]) : any;
console.error.pipe(value: any, ...values: any[]) : any;

Install:

require('nonstandard/src/console').Install();
executeFunction(console.log.pipe({ some: 'data' }, "that string has been logged only")); // value was shown in console, and passed to function `executeFunction`
 
function actionLogin(user) {
  return login(user.credentials)
  .then(function(resp) {
    return console.info.pipe(resp.data);
  })
  .catch(function(error) {
    throw console.error.pipe(error); // in promise throwns was catched by next then/catch pair
  });
}

Array.empty

Check if array has not elements

Array.empty(target: array) : boolean;

Install:

require('nonstandard/src/array/empty').Install();
Array.empty([]) // true
Array.empty([1, 2, 3]) // false

Array.present

Check if array has some elements

Array.present(target: array) : boolean;

Install:

require('nonstandard/src/array/present').Install();
Array.present([]) // false
Array.present([1, 2, 3]) // true

Array.prototype.first

First element in array

[].first

Install:

require('nonstandard/src/array/properties').Install();
var arr = [5, 9, 14];
 
arr.first // 5
 
arr.first = 2;
 
arr // [2, 9, 14]

Array.prototype.second

Second element in array

[].second

Install:

require('nonstandard/src/array/properties').Install();
var arr = [1, 8, 10];
 
arr.second // 8
 
[].second // undefined
 
[].second = 2 // equals:  [][1] = 2

Array.prototype.last

Latest element in array

[].last

Install:

require('nonstandard/src/array/properties').Install();
var arr = [12, 34, 56, 78, 90];
 
arr.last // 90
 
arr.last == arr[arr.length - 1] // true
 
[].last = 1; // nothing changed

Array.prototype.clean

Clear array

[].clean()

Install:

require('nonstandard/src/array/clean').Install();
var arr = [1, 2, 3, 45, 67];
 
arr.clean();
 
arr // now `[]`

If as argument function passed, .clean call it on every value and clean if callback return not false, 0, null or undefined

var arr = [1, 2, 3, 4, 5, 6];
arr.clean(function(e){
  return e % 2;
});
arr; // [2, 4, 6]

Array.prototype.contains

Check elements exists in array

[].contains(any[]) : boolean

Install:

require('nonstandard/src/array/contains').Install();
var arr = ["a", "b", "c"];
 
arr.contains(['a', 'b']); // true
 
arr.contains('c'); // true
 
arr.contains('d'); // false

Array.prototype.clone

Full clone array.

[].clone() : any[]

Install:

require('nonstandard/src/array/clone').Install();
var arr = [1, 5].clone();
 
// its simple
arr // [1, 5]

Object.clone

Deep clone object

Object.clone(target: object) : object;

Install:

require('nonstandard/src/object/clone').Install();
var oob = { name: "Foo", test: "bar", cool: { yeah: true } };
 
var wob = Object.clone(oob);
// Object `wob` is full copy of `oob` without links in memory

Object.empty

Check if object has not keys

Object.empty(target: object) : boolean;

Install:

require('nonstandard/src/object/empty').Install();
Object.empty({}) // true
Object.empty({ a: 2 }) // false
Object.empty(window) // false

Object.present

Check if object has keys

Object.present(target: object) : boolean;

Install:

require('nonstandard/src/object/present').Install();
Object.present({}) // false
Object.present({ a: 2 }) // true
Object.present(window) // true

Number.range

Create array of numbers

Number.range(min: number, max: number, step: number = 1) : number[];

Install:

require('nonstandard/src/number/present').Install();
console.log(Number.range(1, 10))
/*
  [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
*/
 
console.log(Number.range(2, 8, 2))
/*
  [2, 4, 6, 8]
*/

Number.prototype.times

Run callback n times

(5).times(function(index: number) { return index + 1; }) : any[]

Install:

require('nonstandard/src/number/times').Install();
var result = (5).times(function(index) { return ++index * 2; });
result // [ 2, 4, 6, 8, 10 ]

String.random

Generate random string with custom length

String.random(length: string = 10) : string;

Install:

require('nonstandard/src/string/random').Install();
String.random() // "778fx0hmc0"
String.random(5) // "u5ojh"
String.random(64) // "ww5z8kar8m6l4ichouw221n307xiec1wt6584qf4bib2rbsa4b379hoblsd42h3e"

Readme

Keywords

Package Sidebar

Install

npm i nonstandard

Repository

github.com/LestaD/nonstandard.js

Homepage

github.com/LestaD/nonstandard.js#readme

Weekly Downloads

13

Version

1.1.1

License

MIT

Last publish

Collaborators

  • lestad
Try on RunKit
Report malware