Find package.json files in parent directories, keep finding until you find the right one using iterators.
Last updated 5 months ago by 3rdeden .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install find-package-json 
SYNC missed versions from official npm registry.


Easily find package.json files that you're searching for. It spiders parent directories for package.json files and correctly reads the results. It follows an ES6 iterator design so it should be easy to implement.


The module is released in the public npm registry and can be installed by running:

npm install --save find-package-json


We expose a single function as module interface. So in all examples we assume that you've already required the code as illustrated in the example below:

'use strict';

var finder = require('find-package-json');

The function accepts 1 optional argument which is the directory it should start searching in or a module object with a filename key. If nothing is provided it will default to process.cwd() as entry point.

As we're build upon the iterator interface you can simply call the .next() function of the returned result to find the first package.json. If you don't like the result, call .next() again to find the next file. Please do note that these methods do synchronous API calls in Node.js so they are blocking.

var f = finder(__dirname);

console.log(; // the package.json object
console.log(; // the path to the package.json file

You can also search for the global module object:

var f = finder(module);

console.log(; // the package.json object
console.log(; // the path to the package.json file

If there is no more package.json's to be found, the method will set the returned done key as true;

var f = finder(__dirname); // false // true



Current Tags

  • 1.2.0                                ...           latest (5 months ago)

3 Versions

  • 1.2.0                                ...           5 months ago
  • 1.1.0                                ...           a year ago
  • 1.0.0                                ...           4 years ago
Maintainers (1)
Today 14
This Week 173
This Month 432
Last Day 38
Last Week 135
Last Month 588
Dependencies (0)
Dev Dependencies (4)

Copyright 2014 - 2016 © |