You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
rosh
459aece669
|
4 years ago | |
---|---|---|
.. | ||
.nyc_output | 4 years ago | |
.travis.yml | 4 years ago | |
CHANGELOG.md | 4 years ago | |
LICENSE | 4 years ago | |
README.md | 4 years ago | |
index.js | 4 years ago | |
package.json | 4 years ago |
README.md
cli-width
Get stdout window width, with four fallbacks, tty
, output.columns
, a custom environment variable and then a default.
Usage
npm install --save cli-width
'use strict';
var cliWidth = require('cli-width');
cliWidth(); // maybe 204 :)
You can also set the CLI_WIDTH
environment variable.
If none of the methods are supported, and the environment variable isn't set,
the default width value is going to be 0
, that can be changed using the configurable options
.
API
cliWidth([options])
cliWidth
can be configured using an options
parameter, the possible properties are:
- defaultWidth<number> Defines a default value to be used if none of the methods are available, defaults to
0
- output<object> A stream to be used to read width values from, defaults to
process.stdout
- tty<object> TTY module to try to read width from as a fallback, defaults to
require('tty')
Examples
Defining both a default width value and a stream output to try to read from:
var cliWidth = require('cli-width');
var ttys = require('ttys');
cliWidth({
defaultWidth: 80,
output: ttys.output
});
Defines a different tty module to read width from:
var cliWidth = require('cli-width');
var ttys = require('ttys');
cliWidth({
tty: ttys
});
Tests
npm install
npm test
Coverage can be generated with npm run coverage
.