1 # read-pkg-up [![Build Status](https://travis-ci.org/sindresorhus/read-pkg-up.svg?branch=master)](https://travis-ci.org/sindresorhus/read-pkg-up)
3 > Read the closest package.json file
8 - [Finds the closest package.json](https://github.com/sindresorhus/find-up)
9 - [Gracefully handles filesystem issues](https://github.com/isaacs/node-graceful-fs)
10 - [Strips UTF-8 BOM](https://github.com/sindresorhus/strip-bom)
11 - [Throws more helpful JSON errors](https://github.com/sindresorhus/parse-json)
12 - [Normalizes the data](https://github.com/npm/normalize-package-data#what-normalization-currently-entails)
18 $ npm install read-pkg-up
25 const readPkgUp = require('read-pkg-up');
27 readPkgUp().then(result => {
32 name: 'awesome-package',
36 path: '/Users/sindresorhus/dev/awesome-package/package.json'
45 ### readPkgUp([options])
47 Returns a `Promise` for the result object.
49 ### readPkgUp.sync([options])
51 Returns the result object.
58 Default: `process.cwd()`
60 Directory to start looking for a package.json file.
67 [Normalize](https://github.com/npm/normalize-package-data#what-normalization-currently-entails) the package data.
72 - [read-pkg](https://github.com/sindresorhus/read-pkg) - Read a package.json file
73 - [pkg-up](https://github.com/sindresorhus/pkg-up) - Find the closest package.json file
74 - [find-up](https://github.com/sindresorhus/find-up) - Find a file by walking up parent directories
75 - [pkg-conf](https://github.com/sindresorhus/pkg-conf) - Get namespaced config from the closest package.json
80 MIT © [Sindre Sorhus](https://sindresorhus.com)