split-retain
Split a string and preserve the delimiters.
Install
Node.js
npm install split-retain --save
var splitRetain = require('split-retain');
Browser
Include the full or minified version on your webpage from browser/, then use splitRetain(...).
<script src="path/to/split-retain.min.js">
Examples
// ['home/', 'jack/', 'images/', 'photo12.jpeg'] // ['home', '/jack', '/images', '/photo12.jpeg'] ...Documentation
splitRetain(string, separator[, options])
Arguments
| argument | type | desription |
|---|---|---|
| string | String | string to split |
| separator | String ——— RegExp |
single character ——— must have grouping parentheses and global flag, e.g. /(\d+)/g |
[options = {}] |
Object | - |
[options.leadingSeparator = false] |
Boolean | if true, the separator will be placed at the beginning of the split tokens |
Results
| property | type | description |
|---|---|---|
| @return | String[] | array of split tokens |
| @throws | Error | on incorrect argument types |
Tests
npm test
Coverage
npm run cover
TODO
- create 'publish steps'
- replace browserify with UMD?
- more examples in Examples
- changelog
- lint
- ...
License
MIT