npm

npm’s 2019 JavaScript ecosystem survey analysis is now available! Get your copy here »

vfile-location

2.0.4 • Public • Published

vfile-location

Build Coverage Downloads Chat

Convert between positions (line and column-based) and offsets (range-based) locations in a virtual file.

Installation

npm:

npm install vfile-location

Usage

var vfile = require('vfile')
var vfileLocation = require('vfile-location')
 
var location = vfileLocation(vfile('foo\nbar\nbaz'))
 
var offset = location.toOffset({line: 3, column: 3}) // => 10
location.toPosition(offset) // => {line: 3, column: 3, offset: 10}

API

location = vfileLocation(doc)

Get transform functions for the given doc (string) or file.

Returns an object with toOffset and toPosition.

location.toOffset(position)

Get the offset (number) for a line and column-based position in the bound file. Returns -1 when given invalid or out of bounds input.

location.toPosition(offset)

Get the line and column-based position for offset in the bound file.

Contribute

See contributing.md in vfile/vfile for ways to get started.

This organisation has a Code of Conduct. By interacting with this repository, organisation, or community you agree to abide by its terms.

License

MIT © Titus Wormer

install

npm i vfile-location

Downloadsweekly downloads

976,880

version

2.0.4

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability