split-on-first

v3.0.0
Split a string on the first occurance of a given separator
split string first once occurrence separator delimiter text

split-on-first

Split a string on the first occurrence of a given separator

This is similar to String#split(), but that one splits on all the occurrences, not just the first one.

Install

$ npm install split-on-first

Usage

import splitOnFirst from 'split-on-first';

splitOnFirst('a-b-c', '-');
//=> ['a', 'b-c']

splitOnFirst('key:value:value2', ':');
//=> ['key', 'value:value2']

splitOnFirst('a---b---c', '---');
//=> ['a', 'b---c']

splitOnFirst('a-b-c', '+');
//=> []

splitOnFirst('abc', '');
//=> []

API

splitOnFirst(string, separator)

string

Type: string

The string to split.

separator

Type: string

The separator to split on.

Related

  • split-at - Split a string at one or more indices
npm i split-on-first

Metadata

  • MIT
  • >=12
  • Sindre Sorhus
  • released 4/15/2021

Downloads

Maintainers