# spacetrim
> Spacetrim is trimming string from all 4 sides.
Latest version **0.13.0** (published 2025-12-10) · Apache-2.0 license · 0 weekly downloads
## Install
```sh
npm install spacetrim
pnpm add spacetrim
yarn add spacetrim
bun add spacetrim
```
## Health
**Score 60/100 (C)** — status: stable.
Positive: has types; esm support; no vulnerabilities; high quality score.
Warnings: low downloads; pre 1.0.
## Facts
| | |
|---|---|
| Version | 0.13.0 |
| Published | 2025-12-10 |
| First published | 2021-10-21 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 139.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | hejny |
## Links
- npm: https://www.npmjs.com/package/spacetrim
- Repository: https://github.com/hejny/spacetrim
- Homepage: https://github.com/hejny/spacetrim#readme
- Issues: https://github.com/hejny/spacetrim/issues
- Funding: https://buymeacoffee.com/hejny
- npm.io page: https://npm.io/package/spacetrim
## Recent versions
- 0.13.0 (latest) — 2025-12-10
- 0.11.60 — 2024-10-31
- 0.11.59 — 2024-10-13
- 0.11.58 — 2024-09-16
- 0.11.57 — 2024-09-12
- 0.11.56 — 2024-09-09
- 0.11.55 — 2024-09-05
- 0.11.54 — 2024-09-02
- 0.11.53 — 2024-09-02
- 0.11.52 — 2024-09-01
- 0.11.51 — 2024-09-01
- 0.11.50 — 2024-08-29
- 0.11.49 — 2024-08-26
- 0.11.48 — 2024-08-25
- 0.11.47 — 2024-08-24
- … 89 more at https://npm.io/package/spacetrim/versions
## README
# ✂️ Space trim
[](https://www.npmjs.com/package/spacetrim)
[](https://packagequality.com/#?package=spacetrim)
[](https://github.com/hejny/spacetrim/actions/workflows/lint.yml)
[](https://github.com/hejny/spacetrim/actions/workflows/test.yml)
[](https://snyk.io/test/github/hejny/spacetrim)
[](https://github.com/hejny/spacetrim/issues)
[](https://socket.dev/npm/package/spacetrim)
Spacetrim is trimming string from all 4 sides.
It is very helpful to keep pretty code indentation without keeping strange spaces inside a string.
> ░ is whitespace and `spaceTrim` will trim the string at the boundaries ╔═╗
```
░░░░░░░░░░░░░
░░░░░░░░░░░░░░
░░░░░░░╔═════╗░
░░░░░░░║Hello║░░
░░░░░░░║Space║░░░
░░░░░░░║Trim ║░░░░
░░░░░░░╚═════╝░░░░░
░░░░░░░░░░░░░░░░░░░░
```
## Usage
```bash
npm i spacetrim
```
```typescript
import spaceTrim from 'spacetrim';
const trimmed = spaceTrim(`
Hello
Space
Trim
`);
console.log(trimmed);
/*
Hello
Space
Trim
*/
```
_See more examples in [simple tests](./src/spaceTrim.test.ts)._
## Nesting
This is very usefull when you want to trim multiline strings inside multiline strings.
```typescript
import { spaceTrim } from 'spacetrim';
const trimmed = spaceTrim(
(block) => `
Numbers
${block(['1', '2', '3'].join('\n'))}
Chars
${block(['A', 'B', 'C'].join('\n'))}
`,
);
console.log(trimmed);
/*
Numbers
1
2
3
Chars
A
B
C
*/
```
_See more examples in [nesting tests](./src/nesting/nesting.test.ts)._
## Asynchronous nesting
You can also trim multiline strings which are fetched asynchronously inside multiline strings.
```typescript
import { spaceTrim } from 'spacetrim';
const trimmed = await spaceTrim(
async (block) => `
TypeScript:
${await fetch('https://en.wikipedia.org/wiki/TypeScript').then(
(result) => result.text(),
)}
`,
);
console.log(trimmed);
/*
TypeScript:
TypeScript is a free and open source programming language...
*/
```
_See more examples in [asynchronous nesting tests](./src/nesting/async-nesting.test.ts)._
## 🖋️ Contributing
I am open to pull requests, feedback, and suggestions. Or if you like this utility, you can [☕ buy me a coffee](https://www.buymeacoffee.com/hejny) or [donate via cryptocurrencies](https://github.com/hejny/hejny/blob/main/documents/crypto.md).
You can also ⭐ star the spacetrim package, [follow me on GitHub](https://github.com/hejny) or [various other social networks](https://www.pavolhejny.com/contact/).
## ✨ Partners
[Become a partner](https://www.pavolhejny.com/contact/)
---
_Source: https://npm.io/package/spacetrim · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._