join-array

Description

join-array joins the elements of an array into a [String] value, and returns that value. In addition you can specify:

• the regular separator, that separates the subsequent items' values
• the last separator, that separates the last and the last but one item's value
• the maximal number of items to join. If the array contains more items that expected, it ommits the middle ones, joins the last one to the [String] chain and returns this incomplete chain.
• the message that replaces the missing items in the [String] chain.

Any bugs found? Give me to know on GitHub

Installation

npm install join-array

const join = require('join-array');
const names = ['Rachel','Taylor','Julia','Robert','Jasmine','Lily','Madison'];
const config = {
  array: names,
  separator: ', ',
  last: ' and ',
  max: 4,
  maxMessage:(missed)=>`(${missed} more...)`
};
const list = join(config); //Rachel, Taylor, Julia, (3 more...) and Madison

const join = require('join-array');
const cars = ['BMW','Tesla','Audi','Honda','Aston Martin','Cadillac','Citroen'];

const list = join(cars, " | ", " | ", 3, "[...]"); //BMW | Tesla | [...] | Citroen

Usage

Syntax:

• join(array:Array, separator:String, last:String, max:Number, maxMessage:Function|String)
• join(config:Object) where config contains the following properties: array:Array, separator:String, last:String, max:Number, maxMessage:Function|String. The [Object] config properties can be omitted (if optional). Then the default values are used instead.

The TypeError is thrown when any argument type is invalid.
Follow the TypeError.message instructions to configure the module.

array [Array]

Description: Indicates the [Array] object, which items are joined into the [String] value.

separator [String] (optional)

Default: ", "
Description: It separates all but the last one subsequent items of the array.

last [String] (optional)

Default: " and "
Description: It separates the last and the last but one item of the array.

max [Number] (optional)

Default: Infinity
Description: If defined, it limits the number of array items to be joined; eg. if the max equals 10 and the array contains 100 items, the first 9 items and the 100th one are joined.

maxMessage [Function|String] (optional)

Default: (missed)=>`(${missed} more...)`
Description: If the number of array items is bigger than the max value, the missed items are replaced by the maxMessage value.

• When [String], it is directly appended into the [String] chain before the last item.
• When [Function], it expects the [String] value to be returned. The missed argument passed through this function equals the number of missed items and can be used in the returned [String] message.