{"_id":"split-on-first","_rev":"4224827","name":"split-on-first","description":"Split a string on the first occurance of a given separator","dist-tags":{"latest":"4.0.0"},"maintainers":[{"name":"sindresorhus","email":""}],"time":{"modified":"2026-03-12T00:27:15.000Z","created":"2019-02-07T10:31:09.773Z","4.0.0":"2025-08-20T09:12:11.738Z","3.0.0":"2021-04-15T06:09:11.688Z","2.0.1":"2020-11-22T17:53:43.496Z","2.0.0":"2019-11-13T08:00:04.589Z","1.1.0":"2019-04-23T09:01:07.066Z","1.0.0":"2019-02-07T10:31:09.773Z"},"users":{},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"https://sindresorhus.com"},"repository":{"type":"git","url":"git+https://github.com/sindresorhus/split-on-first.git"},"versions":{"4.0.0":{"name":"split-on-first","version":"4.0.0","description":"Split a string on the first occurance of a given separator","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sindresorhus/split-on-first.git"},"funding":"https://github.com/sponsors/sindresorhus","author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"https://sindresorhus.com"},"type":"module","exports":{"types":"./index.d.ts","default":"./index.js"},"sideEffects":false,"engines":{"node":">=20"},"scripts":{"test":"xo && ava && tsd"},"keywords":["split","string","first","once","occurrence","separator","delimiter","text"],"devDependencies":{"ava":"^6.4.1","tsd":"^0.33.0","xo":"^1.2.2"},"_id":"split-on-first@4.0.0","gitHead":"7ef74ece990d3f424bb1128daf44b5a49202b290","types":"./index.d.ts","bugs":{"url":"https://github.com/sindresorhus/split-on-first/issues"},"homepage":"https://github.com/sindresorhus/split-on-first#readme","_nodeVersion":"20.19.1","_npmVersion":"10.9.2","dist":{"shasum":"f49436d62be0d529cef522e2fd4bd08725de2ff3","size":2073,"noattachment":false,"key":"/split-on-first/-/split-on-first-4.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/split-on-first/download/split-on-first-4.0.0.tgz"},"_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"directories":{},"maintainers":[{"name":"sindresorhus","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/split-on-first_4.0.0_1755681131551_0.17395139867441567"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-08-20T09:12:11.738Z","publish_time":1755681131738,"_source_registry_name":"default","_cnpm_publish_time":1755681131738},"3.0.0":{"name":"split-on-first","version":"3.0.0","description":"Split a string on the first occurance of a given separator","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sindresorhus/split-on-first.git"},"funding":"https://github.com/sponsors/sindresorhus","author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"https://sindresorhus.com"},"type":"module","exports":"./index.js","engines":{"node":">=12"},"scripts":{"test":"xo && ava && tsd"},"keywords":["split","string","first","once","occurrence","separator","delimiter","text"],"devDependencies":{"ava":"^3.15.0","tsd":"^0.14.0","xo":"^0.38.2"},"gitHead":"d6bf86163df4e6490b134c303477644a52736997","bugs":{"url":"https://github.com/sindresorhus/split-on-first/issues"},"homepage":"https://github.com/sindresorhus/split-on-first#readme","_id":"split-on-first@3.0.0","_nodeVersion":"15.12.0","_npmVersion":"6.14.10","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"f04959c9ea8101b9b0bbf35a61b9ebea784a23e7","size":1854,"noattachment":false,"key":"/split-on-first/-/split-on-first-3.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/split-on-first/download/split-on-first-3.0.0.tgz"},"directories":{},"maintainers":[{"name":"sindresorhus","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/split-on-first_3.0.0_1618466951543_0.4764352634330624"},"_hasShrinkwrap":false,"publish_time":1618466951688,"_cnpm_publish_time":1618466951688},"2.0.1":{"name":"split-on-first","version":"2.0.1","description":"Split a string on the first occurance of a given separator","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sindresorhus/split-on-first.git"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=8"},"scripts":{"test":"xo && ava && tsd"},"keywords":["split","string","first","once","occurrence","separator","delimiter","text"],"devDependencies":{"ava":"^2.4.0","tsd":"^0.10.0","xo":"^0.25.3"},"gitHead":"02a913862bc05f800659743738c9615fdd4e63f0","bugs":{"url":"https://github.com/sindresorhus/split-on-first/issues"},"homepage":"https://github.com/sindresorhus/split-on-first#readme","_id":"split-on-first@2.0.1","_nodeVersion":"10.22.1","_npmVersion":"6.14.9","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"a01fd731d050aa610e3898242a0d11b1a56e990b","size":1889,"noattachment":false,"key":"/split-on-first/-/split-on-first-2.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/split-on-first/download/split-on-first-2.0.1.tgz"},"directories":{},"maintainers":[{"name":"sindresorhus","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/split-on-first_2.0.1_1606067623380_0.2207000932295844"},"_hasShrinkwrap":false,"publish_time":1606067623496,"_cnpm_publish_time":1606067623496},"2.0.0":{"name":"split-on-first","version":"2.0.0","description":"Split a string on the first occurance of a given separator","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sindresorhus/split-on-first.git"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=8"},"scripts":{"test":"xo && ava && tsd"},"keywords":["split","string","first","occurrence","separator","delimiter","text"],"devDependencies":{"ava":"^2.4.0","tsd":"^0.10.0","xo":"^0.25.3"},"gitHead":"1cba7583680c024b333c3653170bba9a72008805","bugs":{"url":"https://github.com/sindresorhus/split-on-first/issues"},"homepage":"https://github.com/sindresorhus/split-on-first#readme","_id":"split-on-first@2.0.0","_nodeVersion":"10.17.0","_npmVersion":"6.11.3","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"6532300e408c285415c757e1464e952bfa20fec4","size":1879,"noattachment":false,"key":"/split-on-first/-/split-on-first-2.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/split-on-first/download/split-on-first-2.0.0.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/split-on-first_2.0.0_1573632004471_0.9440429914521933"},"_hasShrinkwrap":false,"publish_time":1573632004589,"_cnpm_publish_time":1573632004589},"1.1.0":{"name":"split-on-first","version":"1.1.0","description":"Split a string on the first occurance of a given separator","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sindresorhus/split-on-first.git"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=6"},"scripts":{"test":"xo && ava && tsd"},"keywords":["split","string","first","occurrence","separator","delimiter","text"],"devDependencies":{"ava":"^1.4.1","tsd":"^0.7.2","xo":"^0.24.0"},"gitHead":"8ccf0dcca19355875e52bb2262d47e7f276ed811","bugs":{"url":"https://github.com/sindresorhus/split-on-first/issues"},"homepage":"https://github.com/sindresorhus/split-on-first#readme","_id":"split-on-first@1.1.0","_npmVersion":"6.4.1","_nodeVersion":"10.15.3","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"f610afeee3b12bce1d0c30425e76398b78249a5f","size":1894,"noattachment":false,"key":"/split-on-first/-/split-on-first-1.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/split-on-first/download/split-on-first-1.1.0.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/split-on-first_1.1.0_1556010066967_0.09897204476786459"},"_hasShrinkwrap":false,"publish_time":1556010067066,"_cnpm_publish_time":1556010067066},"1.0.0":{"name":"split-on-first","version":"1.0.0","description":"Split a string on the first occurance of a given separator","license":"MIT","repository":{"type":"git","url":"git+https://github.com/sindresorhus/split-on-first.git"},"author":{"name":"Sindre Sorhus","email":"sindresorhus@gmail.com","url":"sindresorhus.com"},"engines":{"node":">=6"},"scripts":{"test":"xo && ava"},"keywords":["split","string","first","occurrence","separator","delimiter","text"],"devDependencies":{"ava":"^1.2.0","xo":"^0.24.0"},"gitHead":"13d4a7d4c7d67a7371f6626c195132c1cc908ea1","bugs":{"url":"https://github.com/sindresorhus/split-on-first/issues"},"homepage":"https://github.com/sindresorhus/split-on-first#readme","_id":"split-on-first@1.0.0","_npmVersion":"6.5.0","_nodeVersion":"10.15.0","_npmUser":{"name":"sindresorhus","email":"sindresorhus@gmail.com"},"dist":{"shasum":"648af4ce9a28fbcaadd43274455f298b55025fc6","size":1754,"noattachment":false,"key":"/split-on-first/-/split-on-first-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/split-on-first/download/split-on-first-1.0.0.tgz"},"maintainers":[{"name":"sindresorhus","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/split-on-first_1.0.0_1549535469644_0.9418896824901093"},"_hasShrinkwrap":false,"publish_time":1549535469773,"_cnpm_publish_time":1549535469773}},"readme":"# split-on-first\n\n> Split a string on the first occurrence of a given separator\n\nThis is similar to [`String#split()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/split), but that one splits on all the occurrences, not just the first one.\n\n## Install\n\n```sh\nnpm install split-on-first\n```\n\n## Usage\n\n```js\nimport splitOnFirst from 'split-on-first';\n\nsplitOnFirst('a-b-c', '-');\n//=> ['a', 'b-c']\n\nsplitOnFirst('key:value:value2', ':');\n//=> ['key', 'value:value2']\n\nsplitOnFirst('a---b---c', '---');\n//=> ['a', 'b---c']\n\nsplitOnFirst('a-b-c', '+');\n//=> []\n\nsplitOnFirst('abc', '');\n//=> []\n\nsplitOnFirst('a,b.c', /[.,]/);\n//=> ['a', 'b.c']\n```\n\n## API\n\n### splitOnFirst(string, separator)\n\n#### string\n\nType: `string`\n\nThe string to split.\n\n#### separator\n\nType: `string | RegExp`\n\nThe separator to split on. When a `RegExp` is provided, it splits on the first match.\n\n## Related\n\n- [split-at](https://github.com/sindresorhus/split-at) - Split a string at one or more indices\n","_attachments":{},"homepage":"https://github.com/sindresorhus/split-on-first#readme","bugs":{"url":"https://github.com/sindresorhus/split-on-first/issues"},"license":"MIT"}