node package manager

text-table

text-table

generate borderless text table strings suitable for printing to stdout

build status

browser support

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

Use this within your firewall

Combine open-source packages with your private code and publish to a private registry behind the firewall. npm ♥ enterprise developers

how? learn more

Collaborators list

Stats

Try it out

Keywords

text, table, align, ascii, rows, tabular

Dependencies

None

Dependents (383)

ideal-postcodes-cli, jdkswitch, efes, avoscloud-code, npm-check-interactive, invoicer, node-zhihu-daily, modulus, lamu, bcat, gulp-stats, jshint-stylish-file, couchmin, fcompass, laravel-elixir-scss-lint, npm-issues-14488, idl, generate, simplay, outdated, colorguard, gulp-checktextdomain, node-dictionary, grunt-semistandard, jshint-stylish-cool, @beisen/hookformatter, grunt-standard, dependency-comparator, unified-args, live-perf, stylish-reporter, twcli, generate-help, lesshint-reporter-stylisher, grunt-puglint, sls-sample-app, loopback-example-app, jmpr-jpm, wdn, nsp-formatter-slack, weblearn-tensor, common-config, scsslint-loader, mocha-slow-test-reporter, metalsmith-hammer, grunt-checktextdomain, pre-hexo, @boneskull/invoicer, @seed/todos, fluid-eslint, and more