line-numbers

Add line numbers to a string.

Copy its ~20 LOC directly into your code instead.
Last updated 10 years ago by lydell .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ npm install line-numbers 
SYNC missed versions from official npm registry.

Overview Build Status

DEPRECATED. This is a rather silly package that I do not recommend using. It's easier to copy the ~20 lines of code of this package and customize that code, rather than downloading and learning how to use this package.

Add line numbers to a string.

var lineNumbers = require("line-numbers")

var string = [
  "function sum(a, b) {",
  "  return a + b;",
  "}"
].join("\n")

lineNumbers(string)
// 1 | function sum(a, b) {
// 2 |   return a + b;
// 3 | }

Installation

  • npm install line-numbers
var lineNumbers = require("line-numbers")

Usage

lineNumbers(code, [options])

Inserts a line number at the beginning of each line in code, which is either a string or an array of strings—one for each line. All the line numbers are of the same width; shorter numbers are padded on the left side.

The return value is of the same type as code.

options:

  • start: Number. The number to use for the first line. Defaults to 1.

  • padding: String. The character to pad numbers with. Defaults to " ".

  • before: String. String to put before the line number. Defaults to " ".

  • after: String. String to put between the line number and the line itself. Defaults to " | ".

  • transform: Function. It is called for each line and passed an object with the following properties:

    • before: options.before
    • number: Number. The current line number.
    • width: Number. The padded width of the line numbers.
    • after: options.after
    • line: String. The current line.

    You may modify the above properties to alter the line numbering for the current line. This is useful if before and after aren’t enough, if you want to colorize the line numbers, or highlight the current line.

License

The X11 (“MIT”) License.

Current Tags

  • 0.2.2                                ...           latest (9 years ago)

4 Versions

  • 0.2.2 [deprecated]           ...           9 years ago
  • 0.2.1 [deprecated]           ...           9 years ago
  • 0.2.0 [deprecated]           ...           10 years ago
  • 0.1.0 [deprecated]           ...           10 years ago
Maintainers (1)
Downloads
Total 0
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (1)
Dev Dependencies (1)

© 2010 - cnpmjs.org x YWFE | Home | YWFE