Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

join-string

version license build Coverage Status

Joining string/classes with specified delimiter.


Example

import joinString from 'join-string';

const joinFn = joinString(', ');
const isTrue = true;
const isFalse = false;
const result = joinFn('a', 'b', isTrue && 'c', isFalse && 'd', undefined);

console.log(result); // "a, b, c"

Installation

This module is distributed via npm which is bundled with node and should be installed as one of your project's dependencies:

npm install --save join-string

or

yarn add join-string

API

joinString: (delimiter: string) => (...items: any[]) => string

joinString is a higher-order function that accepts delimiter as parameter and returns a joining function that will join all its parameters with the delimiter.

The filtering rule of the joining functions are:

  1. string will be included except when it is an empty string ("");
  2. number will be included
  3. null, undefined, and boolean will be ignored. This allows you to provide optional strings or conditional string with ternary expression.
  4. array will be flattened and filtered based on the rules above.

joinString is available with import joinString from 'join-string' or import { joinString } from 'join-string', based on your preference.

joinClassName: (...classNames: any[]) => string

joinClassName is an utility to construct className. It join all its parameter with a space.

Under the hood, joinClassName is just joinString(' ').

About

Joining string/classes with specified delimiter.

Resources

Stars

Watchers

Forks

Packages

No packages published