Package Exports

firstline

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (firstline) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Firstline

Introduction

Firstline is a npm async module for NodeJS, that reads and returns the first line of any file. Based on q, supports promises and streams. It is well tested and built for high performance.

It is particularly suited if you need to programmatically access the first line of a large amount of files, while handling errors when they occur.

Install

npm install firstline

(add "--save" if you want the module to be automatically added to your project's "package.json" dependencies)

var firstline = require(firstline)

API

firstline(filepath)

Incrementally reads data from "filepath" until it reaches the end of the first line. Returns a promise, eventually fulfilled with a string.

// Imagine the file content is:
// abc
// def
// ghi
//

firstline('./my-file.txt')
// -> Returns a promise that will be fulfilled with: 'abc'

MIT License