node package manager

text-table

borderless text tables with alignment

text-table

generate borderless text table strings suitable for printing to stdout

example

default align

var table = require('text-table');
var t = table([
    [ 'master', '0123456789abcdef' ],
    [ 'staging', 'fedcba9876543210' ]
]);
console.log(t);
master   0123456789abcdef
staging  fedcba9876543210

left-right align

var table = require('text-table');
var t = table([
    [ 'beep', '1024' ],
    [ 'boop', '33450' ],
    [ 'foo', '1006' ],
    [ 'bar', '45' ]
], { align: [ 'l', 'r' ] });
console.log(t);
beep   1024
boop  33450
foo    1006
bar      45

dotted align

var table = require('text-table');
var t = table([
    [ 'beep', '1024' ],
    [ 'boop', '334.212' ],
    [ 'foo', '1006' ],
    [ 'bar', '45.6' ],
    [ 'baz', '123.' ]
], { align: [ 'l', '.' ] });
console.log(t);
beep  1024
boop   334.212
foo   1006
bar     45.6
baz    123.

centered

var table = require('text-table');
var t = table([
    [ 'beep', '1024', 'xyz' ],
    [ 'boop', '3388450', 'tuv' ],
    [ 'foo', '10106', 'qrstuv' ],
    [ 'bar', '45', 'lmno' ]
], { align: [ 'l', 'c', 'l' ] });
console.log(t);
beep    1024   xyz
boop  3388450  tuv
foo    10106   qrstuv
bar      45    lmno

methods

var table = require('text-table')

var s = table(rows, opts={})

Return a formatted table string s from an array of rows and some options opts.

rows should be an array of arrays containing strings, numbers, or other printable values.

options can be:

  • opts.hsep - separator to use between columns, default ' '
  • opts.align - array of alignment types for each column, default ['l','l',...]
  • opts.stringLength - callback function to use when calculating the string length

alignment types are:

  • 'l' - left
  • 'r' - right
  • 'c' - center
  • '.' - decimal

install

With npm do:

npm install text-table

Use with ANSI-colors

Since the string length of ANSI color schemes does not equal the length JavaScript sees internally it is necessary to pass the a custom string length calculator during the main function call.

See the test/ansi-colors.js file for an example.

license

MIT

Develop front-end JavaScript?

Help us make npm better.

Tell us how you develop, build, and ship front-end JavaScript, and we’ll help make it easier. Take the survey »

how? learn more

Collaborators

Stats

Try it out

Keywords

tabular, rows, ascii, align, table, text

Dependencies

None

Dependents

http-mock-json-server, deedee, eslint, npm, npm-check, gulp-html-lint, yeoman-environment, apiconnect-cli-pm, vbuild, cac, @beisen/hookformatter, couchmin, leasot, csslint-loader, generate, yeoman-generator, grunt-standard, package-checker, csslint-stylish, justo-cli, jscs-stylish, now, dependency-comparator, canidiff, logger-request-cli, snazzy, surger, jshint-stylish, outdated, unified-args, textlint, @nhz.io/leasot, gulp-checktextdomain, time-grunt, time-panto, live-perf, bbucket, update, stylish-reporter, @rstacruz/pnpm, twcli, maodou-cli, generate-help, react-templates-bhf-assets, kanpai, psy, grandma, lesshint-reporter-stylisher, gulp-jsdoc, hexo, and more