2017-05-03 15:35:00 +02:00
# string-width [![Build Status](https://travis-ci.org/sindresorhus/string-width.svg?branch=master)](https://travis-ci.org/sindresorhus/string-width)
> Get the visual width of a string - the number of columns required to display it
2017-12-27 19:33:54 +01:00
Some Unicode characters are [fullwidth ](https://en.wikipedia.org/wiki/Halfwidth_and_fullwidth_forms ) and use double the normal width. [ANSI escape codes ](https://en.wikipedia.org/wiki/ANSI_escape_code ) are stripped and doesn't affect the width.
2017-05-03 15:35:00 +02:00
Useful to be able to measure the actual width of command-line output.
## Install
```
2017-12-27 19:33:54 +01:00
$ npm install string-width
2017-05-03 15:35:00 +02:00
```
## Usage
```js
const stringWidth = require('string-width');
stringWidth('古');
//=> 2
stringWidth('\u001b[1m古\u001b[22m');
//=> 2
stringWidth('a');
//=> 1
```
## Related
- [string-width-cli ](https://github.com/sindresorhus/string-width-cli ) - CLI for this module
- [string-length ](https://github.com/sindresorhus/string-length ) - Get the real length of a string
- [widest-line ](https://github.com/sindresorhus/widest-line ) - Get the visual width of the widest line in a string
## License
MIT © [Sindre Sorhus ](https://sindresorhus.com )