pf

parse-filepath

Parse a filepath and return an object of path parts. Falls back on native node.js `path.parse` if it exists

Showing:

Popularity

Downloads/wk

3.2M

GitHub Stars

28

Maintenance

Last Commit

4yrs ago

Contributors

3

Package

Dependencies

3

Size (min+gzip)

1.1KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

parse-filepath NPM version NPM downloads Build Status

Pollyfill for node.js path.parse, parses a filepath into an object.

You might also be interested in global-prefix.

Install

Install with npm:

$ npm install parse-filepath --save

Usage

var parsePath = require('parse-filepath');
parsePath(filepath);

This can be used as a polyfill for the native node.js path.parse() method, and it also adds a few properties:

  • path: the original filepath
  • isAbsolute: (getter) true if the given path is absolute
  • absolute: (getter) fully resolved, absolute filepath
  • dirname: alias for dir
  • basename: alias for base
  • extname: alias for ext
  • stem: alias for name

Example

var parsePath = require('parse-filepath');
console.log(parsePath('foo/bar/baz/index.js'));

Returns:

{ root: '',
  dir: 'foo/bar/baz',
  base: 'index.js',
  ext: '.js',
  name: 'index',

  // aliases
  extname: '.js',
  basename: 'index.js',
  dirname: 'foo/bar/baz',
  stem: 'index',

  // original path
  path: 'foo/bar/baz/index.js',

  // getters
  absolute: [Getter/Setter],
  isAbsolute: [Getter/Setter] }

You might also be interested in these projects:

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.


This file was generated by verb, v, on March 29, 2016.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial