❤
npm
Sign UpSign In

valid-path

2.1.0 • Public • Published

valid-path Created by Itentika NPM version

Built with love, will be grateful for ❤️

Returns an object, that tells if provided string is a valid path, or describes got problem.

valid invalid
input 'a/b/c' 'a/nul/b'
output 
{
  valid: true,
  error: null,
  data: {
    input: "a/b/c",
    notes: []
    //...flags
  }
}
 
{
  valid: false,
  error: 'Input string contains file
          or folder name, that is
          forbidden in Windows  (nul)',
  data: {
    input: 'a/nul/b',
    notes: []
    //...flags
  }
}

Table of contents

Install

npm i valid-path

Usage

validPath function takes three arguments:

  • string
  • options
  • callback
validPath('string'[, options, callback]);
argument required expected type
string ✔️ string
options ➖ object
callback ➖ function

Example:

const validPath = require('validPath');

const myPath = validPath('string/to/check');

if (myPath.valid) {
    // ...
} else {
    console.log(`Error in ${myPath.data.input}: ${myPath.error}`);
}

return object

{
    valid: boolean,
    error: null || string,
    data: {
        input: input,
        notes: string[],
        sepDuplications: boolean,
        driveLetter: boolean,
        globPatterns: boolean,
        forbiddenWindowsNames: boolean,
        fobiddenWindowsChars: boolean,
        forbiddenUnixChars: boolean
    }
}

Examples

Outputs for calls with default options

Input Output
a/b/c 
{
  valid: true,
  error: null,
  data: {
    input: 'a/b/c',
    notes: []
  }
}
a/b/c.js 
{
  valid: true,
  error: null,
  data: {
    input: 'a/b/c.js',
    notes: []
  }
}
C://a/b 
{
  valid: true,
  error: null,
  data: {
    input: 'C://a/b',
    notes: [
      'Input string contains drive letter'
    ]
  }
}
(nothing) 
{
  valid: false,
  error: '"string" argument must be of type "string",
          got "undefined" for "undefined"',
  data: {
    input: undefined,
    notes: []
  }
}
null 
{
  valid: false,
  error: '"string" argument must be of type "string",
          got "object" for "null"',
  data: {
    input: null,
    notes: []
  }
}
!a/b/c 
{
  valid: false,
  error: 'Input string contains Glob pattern',
  data: {
    input: '!a/b/c',
    notes: []
  }
}
a\\b\\c 
{
  valid: false,
  error: 'Input string contains characters, that
          are forbidden in Windows (a\\b\\c)',
  data: {
    input: 'a\\b\\c',
    notes: []
  }
}
a/b//c 
{
  valid: false,
  error: 'Input string contains duplicated separator',
  data: {
    input: 'a/b//c',
    notes: []
  }
}
a/b/con 
{
  valid: false,
  error: 'Input string contains file or folder name,
          that is forbidden in Windows  (con)',
  data: {
    input: 'a/b/con',
    notes: []
  }
}
a/b:c/d 
{
  valid: false,
  error: 'Input string contains characters,
          that are forbidden in Windows (b:c)',
  data: {
    input: 'a/b:c/d',
    notes: []
  }
}
a/\0b\c 
{
  valid: false,
  error: 'Input string contains characters,
          that are forbidden in Unix (\x00b)',
  data: {
    input: 'a/\x00b/c',
    notes: []
  }
}

Options

Options are optional:

options.simpleReturn

If true, valid-path will return boolean (true or false), not an object.

Default Expects
false boolean

Example

input a/b/c a/b/con
options 
{
  simpleReturn: true
}
 
{
  simpleReturn: true
}
output true false

options.sep

Defines path separator: / or \\.

Default Expects
/ / or \\

Example

input a/b/c a/b/c
options 
{
  //default
}
 
{
  sep: '\\'
}
output 
{
  valid: true,
  error: null,
  data: {
    input: 'a/b/c',
    notes: []
  }
}
 
{
  valid: false,
  error: 'Input string contains characters, that
          are forbidden in Windows (a/b/c)',
  data: {
    input: 'a/b/c',
    notes: []
  }
}

options.allowSepDuplications

If true, valid-path will ignore separator duplications and will add a note in notes array of returned object (Object.data.notes).

Default Expects
false boolean

Example

input a/b//c a/b//c
options 
{
  // default
}
 
{
  allowSepDuplications: true
}
output 
{
  valid: false,
  error: 'Input string contains
          duplicated separator',
  data: {
    input: 'a/b//c',
    notes: []
  }
}
 
{
  valid: true,
  error: null,
  data: {
    input: 'a/b//c',
    notes: [
      'Input string contains
       duplicated separator'
    ]
  }
}

options.allowDriveLetter

If true, valid-path will accept drive letter in provided path and will add a note in notes array of returned object (Object.data.notes).

Drive letter can have single and doubled separator (C:/a/b or C://a/b). In case of doubled separator you do not need to set allowSepDuplications option to true: valid path will accept the duplication just for drive letter.

Default Expects
true boolean

Example

input C://a/b C://a/b
options 
{
  //  default
}
 
{
  allowDriveLetter: false
}
output 
{
  valid: true,
  error: null,
  data: {
    input: 'C://a/b',
    notes: [
      'Input string contains
       drive letter'
    ]
  }
}
 
{
  valid: false,
  error: 'Input string contains
          drive letter',
  data: {
    input: 'C://a/b',
    notes: []
  }
}

options.allowGlobPatterns

If true, valid-path will accept glob pattern in provided path and will add a note in notes array of returned object (Object.data.notes).

Default Expects
false boolean

Example

input a/*/*.js a/*/*.js
options 
{
  //  default
}
 
{
  allowGlobPatterns: true
}
output 
{
  valid: false,
  error: 'Input string contains
          Glob pattern',
  data: {
    input: 'a/*/*.js',
    notes: []
  }
}
 
{
  valid: true,
  error: null,
  data: {
    input: 'a/*/*.js',
    notes: [
      'Input string contains
       Glob pattern'
    ]
  }
}

options.allowForbiddenWindowsNames

By default valid-path does not accept file and folder names that are forbidden in Windows: nul, prn, con, lpt[0-9], com[0-9]. Set to true to accept these names.

Default Expects
false boolean

Example

input a/b/lpt3 a/b/lpt3
options 
{
  //  default
}
 
{
  allowForbiddenWindowsNames: true
}
output 
{
  valid: false,
  error: 'Input string contains file or folder name,
          that is forbidden in Windows  (lpt3)',
  data: {
    input: 'a/b/lpt3',
    notes: []
  }
}
 
{
  valid: true,
  error: null,
  data: {
    input: 'a/b/lpt3',
    notes: [
      'Input string contains file or folder name,
       that is forbidden in Windows  (lpt3)'
    ]
  }
}

options.allowFobiddenWindowsChars

By default valid-path does not accept characters in path items that are forbidden in Windows: /, \, <, >, :, ", *, ?, |. Set to true to accept these characters.

Default Expects
false boolean

Example

input a/b:c/d a/b:c/d
options 
{
  //  default
}
 
{
  allowFobiddenWindowsChars: true
}
output 
{
  valid: false,
  error: 'Input string contains characters,
          that are forbidden in Windows (b:c)',
  data: {
    input: 'a/b:c/d',
    notes: []
  }
}
 
{
  valid: true,
  error: null,
  data: {
    input: 'a/b:c/d',
    notes: [
      'Input string contains characters,
       that are forbidden in Windows (b:c)'
    ]
  }
}

options.allowForbiddenUnixChars

By default valid-path does not accept characters in path items that are forbidden in Unix: \0 (NULL byte), /. Set to true to accept these characters.

Default Expects
false boolean

Example

input a/\0b/c a/\0b/c
options 
{
  //  default
}
 
{
  allowForbiddenUnixChars: true
}
output 
{
  valid: false,
  error: 'Input string contains characters,
          that are forbidden in Unix (\x00b)',
  data: {
    input: 'a/\x00b/c',
    notes: []
  }
}
 
{
  valid: true,
  error: null,
  data: {
    input: 'a/\x00b/c',
    notes: [
      'Input string contains characters,
       that are forbidden in Unix  (\x00b)'
    ]
  }
}

[NB] Migrate from version 1.0.0

valid-pqath v1.0.0 had return and options different from current version, and did not have callback argument. If you switch to the latest version, it will break your code. To keep your existing code and use the latest valid-path version you have to set migrate option to true:

validPath('a/b', {migrate: true});

Plese note, that migrate will be deprecated in future versions.

/valid-path/

    Package Sidebar

    Install

    npm i valid-path

    Repository

    github.com/itentika/valid-path

    Homepage

    github.com/itentika/valid-path#readme

    Weekly Downloads

    699

    Version

    2.1.0

    License

    MIT

    Unpacked Size

    55.5 kB

    Total Files

    15

    Last publish

    Collaborators

    • solovets
    Try on RunKit
    Report malware