Collapse white space.

• What is this?
• When should I use this?
• Install
• Use
• API
  • collapseWhiteSpace(value[, options|style])
• Types
• Compatibility
• Security
• Related
• Contribute
• License

This is a small package that collapses multiple white space characters into one.

You can use this package if you want to HTML or JavaScript (default) white space to a single character. You can optionally drop initial and final white space. By default it collapses to a single space, but optionally line endings can be preserved.

This package is ESM only. In Node.js (version 14.14+, 16.0+), install with npm:

npm install collapse-white-space

In Deno with esm.sh:

import {collapseWhiteSpace} from 'https://esm.sh/collapse-white-space@2'

In browsers with esm.sh:

<script type="module">
  import {collapseWhiteSpace} from 'https://esm.sh/collapse-white-space@2?bundle'
</script>

import {collapseWhiteSpace} from 'collapse-white-space'
collapseWhiteSpace('\tfoo \n\tbar  \t\r\nbaz') //=> ' foo bar baz'

This package exports the identifier collapseWhiteSpace. There is no default export.

Collapse white space in value (string).

Treated as options.style ('html' or 'js', default: 'js').

Configuration (optional).

Style of white space to support ('html' or 'js', default: 'js'). JavaScript white space matches the pattern \s. HTML white space matches [\t\n\v\f\r ].

Whether to collapse white space containing a line ending to that line ending (boolean, default: false). The default is to collapse to a single space. Line endings matches the pattern \r?\n|\r.

Whether to drop white space at the start and end of value (boolean, default: false). The default is to keep it.

Value with collapsed white space (string).

This package is fully typed with TypeScript. It exports the additional types Options and Style.

This package is at least compatible with all maintained versions of Node.js. As of now, that is Node.js 14.14+ and 16.0+. It also works in Deno and modern browsers.

This package is safe.

• wooorm/is-whitespace-character — check if a character is a white space character
• wooorm/detab — convert tabs to spaces
• wooorm/trim-lines — remove tabs and spaces around line-breaks

Yes please! See How to Contribute to Open Source.

MIT © Titus Wormer