242417d45d | ||
---|---|---|
.. | ||
.nyc_output | ||
.travis.yml | ||
CHANGELOG.md | ||
LICENSE | ||
README.md | ||
index.js | ||
package.json |
README.md
cli-width
Get stdout window width, with four fallbacks, tty
, output.columns
, a custom environment variable and then a default.
Tested against NodeJS v10+
Usage
npm install --save cli-width
"use strict";
const 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:
const cliWidth = require("cli-width");
const ttys = require("ttys");
cliWidth({
defaultWidth: 80,
output: ttys.output,
});
Defines a different tty module to read width from:
const cliWidth = require("cli-width");
const ttys = require("ttys");
cliWidth({
tty: ttys,
});
Tests
npm install
npm test
Coverage can be generated with npm run coverage
.