cli-truncate
Truncate a string to a specific width in the terminal
Gracefully handles ANSI escapes. Like a string styled with chalk
. It also supports Unicode surrogate pairs and fullwidth characters.
Install
npm install cli-truncate
Usage
import cliTruncate from 'cli-truncate';
cliTruncate('unicorn', 4);
cliTruncate('unicorn', 4, {position: 'start'});
cliTruncate('unicorn', 4, {position: 'middle'});
cliTruncate('unicorns rainbow dragons', 6, {position: 'end'})
cliTruncate('\u001B[31municorn\u001B[39m', 4);
cliTruncate('uni\uD83C\uDE00corn', 5);
cliTruncate('안녕하세요', 3);
const paragraph = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa.';
cliTruncate(paragraph, process.stdout.columns);
API
cliTruncate(text, columns, options?)
text
Type: string
The text to truncate.
columns
Type: number
The number of columns to occupy in the terminal.
options
Type: object
position
Type: string
Default: 'end'
Values: 'start' | 'middle' | 'end'
The position to truncate the string.
space
Type: boolean
Default: false
Add a space between the text and the ellipsis.
import cliTruncate from 'cli-truncate';
cliTruncate('unicorns', 5, {space: false});
cliTruncate('unicorns', 5, {space: true});
cliTruncate('unicorns', 6, {position: 'start', space: true});
cliTruncate('unicorns', 7, {position: 'middle', space: true});
preferTruncationOnSpace
Type: boolean
Default: false
Truncate the string from a whitespace if it is within 3 characters from the actual breaking point.
import cliTruncate from 'cli-truncate';
cliTruncate('unicorns rainbow dragons', 20, {position: 'start', preferTruncationOnSpace: true})
cliTruncate('unicorns rainbow dragons', 20, {position: 'start'})
cliTruncate('unicorns rainbow dragons', 20, {position: 'middle', preferTruncationOnSpace: true})
cliTruncate('unicorns rainbow dragons', 6, {position: 'end', preferTruncationOnSpace: true})
cliTruncate('unicorns rainbow dragons', 6, {position: 'middle', preferTruncationOnSpace: true})
truncationCharacter
Type: string
Default: …
The character to use at the breaking point.
import cliTruncate from 'cli-truncate';
cliTruncate('unicorns', 5, {position: 'end'});
cliTruncate('unicorns', 5, {position: 'end', truncationCharacter: '.'});
cliTruncate('unicorns', 5, {position: 'end', truncationCharacter: ''});
Related
- wrap-ansi - Wordwrap a string with ANSI escape codes
- slice-ansi - Slice a string with ANSI escape codes