5.1.2 • Published 1 year ago

string-width-sw v5.1.2

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

string-width

Get the visual width of a string - the number of columns required to display it

Some Unicode characters are fullwidth and use double the normal width. ANSI escape codes are stripped and doesn't affect the width.

Useful to be able to measure the actual width of command-line output.

Install

$ npm install string-width

Usage

import {
    stringWidth,
    hasEmoji,
    hasArabic
} from 'string-width';

stringWidth('a');
//=> 1

stringWidth('古');
//=> 2

stringWidth('\u001B[1m古\u001B[22m');
//=> 2

hasEmoji('👍fas')
//=> true
hasArabic('والشعب')
//=>true

API

stringWidth(string, options?)

string

Type: string

The string to be counted.

options

Type: object

ambiguousIsNarrow

Type: boolean \ Default: false

Count ambiguous width characters as having narrow width (count of 1) instead of wide width (count of 2).

Related


<b>
	<a href="https://tidelift.com/subscription/pkg/npm-string-width?utm_source=npm-string-width&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
</b>
<br>
<sub>
	Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
</sub>