is-absolute

Polyfill for node.js path.isAbolute. Returns true if a file path is absolute.

Install

Install with npm:

$ npm install is-absolute --save

Originally based on the isAbsolute utility method in express.

Usage

var isAbsolute = require('is-absolute');

isAbsolute('a/b/c.js');
//=> 'false'
isAbsolute('/a/b/c.js');
//=> 'true'

Explicitly test windows paths

isAbsolute.posix('/foo/bar');
isAbsolute.posix('/user/docs/Letter.txt');
//=> true

isAbsolute.posix('foo/bar');
//=> false

Explicitly test windows paths

var isAbsolute = require('is-absolute');

isAbsolute.win32('c:\\');
isAbsolute.win32('//C://user\\docs\\Letter.txt');
isAbsolute.win32('\\\\unc\\share');
isAbsolute.win32('\\\\unc\\share\\foo');
isAbsolute.win32('\\\\unc\\share\\foo\\');
isAbsolute.win32('\\\\unc\\share\\foo\\bar');
isAbsolute.win32('\\\\unc\\share\\foo\\bar\\');
isAbsolute.win32('\\\\unc\\share\\foo\\bar\\baz');
//=> true

isAbsolute.win32('a:foo/a/b/c/d');
isAbsolute.win32(':\\');
isAbsolute.win32('foo\\bar\\baz');
isAbsolute.win32('foo\\bar\\baz\\');
//=> false

You might also be interested in these projects:

is-dotfile: Return true if a file path is (or has) a dotfile. Returns false if the… more | homepage
is-glob: Returns true if the given string looks like a glob pattern or an extglob pattern.… more | homepage
is-relative: Returns true if the path appears to be relative. | homepage
is-unc-path: Returns true if a filepath is a windows UNC file path. | homepage
is-valid-glob: Return true if a value is a valid glob pattern or patterns. | homepage

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

This file was generated by verb, v, on April 02, 2016.

3.5 KiB Raw Blame History