utilities/README.md

@sapphirecode/utilities

version: 1.5.x

small utility functions to make much needed features easier to work with

Installation

npm:

npm i --save @sapphirecode/utilities

yarn:

yarn add @sapphirecode/utilities

Usage

const util = require('@sapphirecode/utilities');

cut off decimal places to a specified point

util.truncate_decimal(12.345678, 2);
// returns 12.34

will return null instead of throwing on invalid json

util.try_parse_json('{{foo');

copy an object to prevent modification of the original

const obj = {foo: 'bar'};
const copy = util.copy_object(obj);
copy.foo = 'baz';
console.log(obj.foo); // bar

run a regular expression and get a callback for every result

const data = 'foobarfoo';
const regex = /foo/g;
util.run_regex(regex, data, (res) => {
  console.log(res[0]); // will output 'foo' 2 times
});

check if a variable is null, undefined or NaN

console.log(util.is_nil(parseInt('abc'))); // true
console.log(util.is_nil('foo')); // false
console.log(util.is_nil(42)); // false
console.log(util.is_nil(null)); // true
console.log(util.is_nil(undefined)); // true

filter an array recursively

const to_filter = [
  {name: 'include_foo'},
  {
    name: 'include_bar',
    children: [{name: 'foo'}, {name: 'bar'}],
  },
  {
    name: 'baz',
    children: [{name: 'include_foo'}, {name: 'bar'}],
  },
  {
    name: 'barbaz',
    children: [{name: 'foo'}, {name: 'bar'}],
  },
];
const filter = {
  field: 'name', // the field the filter will apply on
  filter: /^include_.*/iu, // regex filter
};

const result = util.recursive_filter(
  to_filter,
  [filter], // you can specify multiple filters, they will be connected using AND
  'children' // specify which field an objects children are stored in ('children' is default)
);

console.log(JSON.stringify(result, null, 2));
/* output:

[
  { name: 'include_foo' },
  {
    name:     'include_bar',
    children: [
      { name: 'foo' },
      { name: 'bar' }
    ]
  },
  {
    name:     'baz',
    children: [ { name: 'include_foo' } ]
  }
]*/

filters can also apply to multiple fields

const result = util.recursive_filter(
  [{name: 'foo', name_2: 'bar'}],
  [
    {
      filter: /foo bar/iu,
      fields: ['name', 'name_2'] // fields will be joined with a space in between
      // {name: 'foo', name_2: 'bar'} will become 'foo bar'
    }
  ]
);

License

MIT © Timo Hocker timo@scode.ovh