javascript-plus v0.0.5

Javascript+

Adds new features to javascript.

How to install

npm install javascript-plus

Documentation

Strict

All functions have a strict parameter that defaults to false. When set to true the function will throw errors when any of conditions relating to the item are met.

• Array does not contain relevant type
• Array is empty

However, when set to false most errors will be skipped. Some errors, like _TypeError_s where an option does not have the valid type, will still be thrown.

Arrays

Array.sum(abs: boolean = false, strict: boolean = false): number

Sums all numeric contents of an array either using absolute values or naturally.

abs

When set to true, converts all numbers to their absolute value before adding. When set to false or left blank, numbers are added naturally.

Array.mean(abs: boolean = false, strict: boolean = false): number

Finds the mean of all numeric contents of an array either using absolute values or naturally.

abs

When set to true, converts all numbers to their absolute value before finding the mean. When set to false or left blank, numbers are added naturally.

Array.deviate(of: number, abs: boolean = false, strict: boolean = false): number

of

Deviates based off of's value. If set to 0, for example, the function will return the mean.

abs

When set to true, converts all numbers to their absolute value before finding the deviation. When set to false or left blank, numbers are deviated naturally.

Array.query(type: queryType, is: any, strict: boolean): any[]

Queries the array for all objects that return true when compared to is with type

QueryType

Type refrenced in documentation that is any of "===", "exists", "typeof", "true", ">=","<=", ">", "<", "!==", "!exists", "!typeof", "false"

exists (-!exsits)

If contents are returned when value?? is run

typeof (-!typeof)

Equivalent to typeof value === is

true (-false)

If value is true when converted to boolean

All others use operator as shown

Group options exist on all specified array types

Use Array.group{Function capitalized at start}({group you want to query}, {function options})

Array.getGroup(group: string | symbol | number, strict?: boolean): any[];

Gets each member of a group and returns them.

Group

What group to look at

Dates

Date.getMonthString(intl: string, strict: boolean): number

Not finished. Converts month to english string (uses Date.getMonth).

Functions

Function.if(onFalse?: any, ...values: any): any

Returns values is function called with values return true. Returns onFalse otherwise.

Function.ifNot(onTruth?: any, ...values: any): any

Returns values is function called with values return false. Returns onTruth otherwise.