# string-collapse-leading-whitespace
> Collapse the leading and trailing whitespace of a string
## Install
```bash
npm i string-collapse-leading-whitespace
```
## Quick Take
```js
import { strict as assert } from "assert";
import { collWhitespace } from "string-collapse-leading-whitespace";
// if leading/trailing whitespace doesn't contain \n, collapse to a single space
assert.equal(collWhitespace(" aaa "), " aaa ");
// otherwise, collapse to a single \n (default setting)
assert.equal(collWhitespace(" \n\n aaa \n\n\n "), "\naaa\n");
// does nothing to trimmed strings:
assert.equal(collWhitespace("aaa"), "aaa");
// if there are multiple lines string is still processed in trim-fashion -
// only beginning and ending whitespace is changed:
assert.equal(
collWhitespace(" abc \n def \n ghi "),
" abc \n def \n ghi "
);
```
## Documentation
Please [visit codsen.com](https://codsen.com/os/string-collapse-leading-whitespace/) for a full description of the API and examples.
## Contributing
To report bugs or request features or assistance, [raise an issue](https://github.com/codsen/codsen/issues/new/choose) on GitHub.
## Licence
MIT License
Copyright (c) 2010-2021 Roy Revelt and other contributors
