• What is nanomatch?
• Getting started
• API
• Options
  • options.basename
  • options.bash
  • options.cache
  • options.dot
  • options.failglob
  • options.ignore
  • options.matchBase
  • options.nocase
  • options.nodupes
  • options.nonegate
  • options.nonull
  • options.nullglob
  • options.snapdragon
  • options.unescape
  • options.unixify
• Features
• Bash expansion libs
• Benchmarks
  • Running benchmarks
  • Latest results
• History
• About
  • Related projects
  • Contributing
  • Running tests
  • Author
  • License

nanomatch

The main function takes a list of strings and one or more glob patterns to use for matching.

Params

• list {Array}: A list of strings to match
• patterns {String|Array}: One or more glob patterns to use for matching.
• options {Object}: Any options to change how matches are performed
• returns {Array}: Returns an array of matches

Example

var nm = require('nanomatch');
nm(list, patterns[, options]);

console.log(nm(['a.js', 'a.txt'], ['*.js']));
//=> [ 'a.js' ]

.match

Similar to the main function, but pattern must be a string.

Params

• list {Array}: Array of strings to match
• pattern {String}: Glob pattern to use for matching.
• options {Object}: Any options to change how matches are performed
• returns {Array}: Returns an array of matches

Example

var nm = require('nanomatch');
nm.match(list, pattern[, options]);

console.log(nm.match(['a.a', 'a.aa', 'a.b', 'a.c'], '*.a'));
//=> ['a.a', 'a.aa']

.isMatch

Returns true if the specified string matches the given glob pattern.

Params

• string {String}: String to match
• pattern {String}: Glob pattern to use for matching.
• options {Object}: Any options to change how matches are performed
• returns {Boolean}: Returns true if the string matches the glob pattern.

Example

var nm = require('nanomatch');
nm.isMatch(string, pattern[, options]);

console.log(nm.isMatch('a.a', '*.a'));
//=> true
console.log(nm.isMatch('a.b', '*.a'));
//=> false

.not

Returns a list of strings that DO NOT MATCH any of the given patterns.

Params

• list {Array}: Array of strings to match.
• patterns {String|Array}: One or more glob pattern to use for matching.
• options {Object}: Any options to change how matches are performed
• returns {Array}: Returns an array of strings that do not match the given patterns.

Example

var nm = require('nanomatch');
nm.not(list, patterns[, options]);

console.log(nm.not(['a.a', 'b.b', 'c.c'], '*.a'));
//=> ['b.b', 'c.c']

.any

Returns true if the given string matches any of the given glob patterns.

Params

• list {String|Array}: The string or array of strings to test. Returns as soon as the first match is found.
• patterns {String|Array}: One or more glob patterns to use for matching.
• options {Object}: Any options to change how matches are performed
• returns {Boolean}: Returns true if any patterns match str

Example

var nm = require('nanomatch');
nm.any(string, patterns[, options]);

console.log(nm.any('a.a', ['b.*', '*.a']));
//=> true
console.log(nm.any('a.a', 'b.*'));
//=> false

.contains

Returns true if the given string contains the given pattern. Similar to .isMatch but the pattern can match any part of the string.

Params

• str {String}: The string to match.
• patterns {String|Array}: Glob pattern to use for matching.
• options {Object}: Any options to change how matches are performed
• returns {Boolean}: Returns true if the patter matches any part of str.

Example

var nm = require('nanomatch');
nm.contains(string, pattern[, options]);

console.log(nm.contains('aa/bb/cc', '*b'));
//=> true
console.log(nm.contains('aa/bb/cc', '*d'));
//=> false

.matchKeys

Filter the keys of the given object with the given glob pattern and options. Does not attempt to match nested keys. If you need this feature, use glob-object instead.

Params

• object {Object}: The object with keys to filter.
• patterns {String|Array}: One or more glob patterns to use for matching.
• options {Object}: Any options to change how matches are performed
• returns {Object}: Returns an object with only keys that match the given patterns.

Example

var nm = require('nanomatch');
nm.matchKeys(object, patterns[, options]);

var obj = { aa: 'a', ab: 'b', ac: 'c' };
console.log(nm.matchKeys(obj, '*b'));
//=> { ab: 'b' }

.matcher

Returns a memoized matcher function from the given glob pattern and options. The returned function takes a string to match as its only argument and returns true if the string is a match.

Params

• pattern {String}: Glob pattern
• options {Object}: Any options to change how matches are performed.
• returns {Function}: Returns a matcher function.

Example

var nm = require('nanomatch');
nm.matcher(pattern[, options]);

var isMatch = nm.matcher('*.!(*a)');
console.log(isMatch('a.a'));
//=> false
console.log(isMatch('a.b'));
//=> true

.makeRe

Create a regular expression from the given glob pattern.

Params

• pattern {String}: A glob pattern to convert to regex.
• options {Object}: Any options to change how matches are performed.
• returns {RegExp}: Returns a regex created from the given pattern.

Example

var nm = require('nanomatch');
nm.makeRe(pattern[, options]);

console.log(nm.makeRe('*.js'));
//=> /^(?:(\.[\\\/])?(?!\.)(?=.)[^\/]*?\.js)$/

.create

Parses the given glob pattern and returns an object with the compiled output and optional source map.

Params

• pattern {String}: Glob pattern to parse and compile.
• options {Object}: Any options to change how parsing and compiling is performed.
• returns {Object}: Returns an object with the parsed AST, compiled string and optional source map.

Example

var nm = require('nanomatch');
nm.create(pattern[, options]);

console.log(nm.create('abc/*.js'));
// { options: { source: 'string', sourcemap: true },
//   state: {},
//   compilers:
//    { ... },
//   output: '(\\.[\\\\\\/])?abc\\/(?!\\.)(?=.)[^\\/]*?\\.js',
//   ast:
//    { type: 'root',
//      errors: [],
//      nodes:
//       [ ... ],
//      dot: false,
//      input: 'abc/*.js' },
//   parsingErrors: [],
//   map:
//    { version: 3,
//      sources: [ 'string' ],
//      names: [],
//      mappings: 'AAAA,GAAG,EAAC,kBAAC,EAAC,EAAE',
//      sourcesContent: [ 'abc/*.js' ] },
//   position: { line: 1, column: 28 },
//   content: {},
//   files: {},
//   idx: 6 }

.parse

Parse the given str with the given options.

Params

• str {String}
• options {Object}
• returns {Object}: Returns an AST

Example

var nm = require('nanomatch');
nm.parse(pattern[, options]);

var ast = nm.parse('a/{b,c}/d');
console.log(ast);
// { type: 'root',
//   errors: [],
//   input: 'a/{b,c}/d',
//   nodes:
//    [ { type: 'bos', val: '' },
//      { type: 'text', val: 'a/' },
//      { type: 'brace',
//        nodes:
//         [ { type: 'brace.open', val: '{' },
//           { type: 'text', val: 'b,c' },
//           { type: 'brace.close', val: '}' } ] },
//      { type: 'text', val: '/d' },
//      { type: 'eos', val: '' } ] }

.compile

Compile the given ast or string with the given options.

Params

• ast {Object|String}
• options {Object}
• returns {Object}: Returns an object that has an output property with the compiled string.

Example

var nm = require('nanomatch');
nm.compile(ast[, options]);

var ast = nm.parse('a/{b,c}/d');
console.log(nm.compile(ast));
// { options: { source: 'string' },
//   state: {},
//   compilers:
//    { eos: [Function],
//      noop: [Function],
//      bos: [Function],
//      brace: [Function],
//      'brace.open': [Function],
//      text: [Function],
//      'brace.close': [Function] },
//   output: [ 'a/(b|c)/d' ],
//   ast:
//    { ... },
//   parsingErrors: [] }

.clearCache

Clear the regex cache.

Example

nm.clearCache();

options.basename

Allow glob patterns without slashes to match a file path based on its basename. Same behavior as minimatch option matchBase.

Type: Boolean

Default: false

Example

nm(['a/b.js', 'a/c.md'], '*.js');
//=> []

nm(['a/b.js', 'a/c.md'], '*.js', {matchBase: true});
//=> ['a/b.js']

options.bash

Enabled by default, this option enforces bash-like behavior with stars immediately following a bracket expression. Bash bracket expressions are similar to regex character classes, but unlike regex, a star following a bracket expression does not repeat the bracketed characters. Instead, the star is treated the same as an other star.

Type: Boolean

Default: true

Example

var files = ['abc', 'ajz'];
console.log(nm(files, '[a-c]*'));
//=> ['abc', 'ajz']

console.log(nm(files, '[a-c]*', {bash: false}));

options.cache

Disable regex and function memoization.

Type: Boolean

Default: undefined

options.dot

Match dotfiles. Same behavior as minimatch option dot.

Type: Boolean

Default: false

options.failglob

Similar to the --failglob behavior in Bash, throws an error when no matches are found.

Type: Boolean

Default: undefined

options.ignore

String or array of glob patterns to match files to ignore.

Type: String|Array

Default: undefined

options.matchBase

Alias for options.basename.

options.nocase

Use a case-insensitive regex for matching files. Same behavior as minimatch.

Type: Boolean

Default: undefined

options.nodupes

Remove duplicate elements from the result array.

Type: Boolean

Default: undefined

Example

Example of using the unescape and nodupes options together:

nm.match(['a/b/c', 'a/b/c'], 'a/b/c');
//=> ['a/b/c', 'a/b/c']

nm.match(['a/b/c', 'a/b/c'], 'a/b/c', {nodupes: true});
//=> ['abc']

options.nonegate

Disallow negation (!) patterns, and treat leading ! as a literal character to match.

Type: Boolean

Default: undefined

options.nonull

Alias for options.nullglob.

options.nullglob

If true, when no matches are found the actual (arrayified) glob pattern is returned instead of an empty array. Same behavior as minimatch option nonull.

Type: Boolean

Default: undefined

options.snapdragon

Pass your own instance of snapdragon to customize parsers or compilers.

Type: Object

Default: undefined

options.unescape

Remove backslashes from returned matches.

Type: Boolean

Default: undefined

Example

In this example we want to match a literal *:

nm.match(['abc', 'a\\*c'], 'a\\*c');
//=> ['a\\*c']

nm.match(['abc', 'a\\*c'], 'a\\*c', {unescape: true});
//=> ['a*c']

options.unixify

Convert path separators on returned files to posix/unix-style forward slashes.

Type: Boolean

Default: true

Example

nm.match(['a\\b\\c'], 'a/**');
//=> ['a/b/c']

nm.match(['a\\b\\c'], {unixify: false});
//=> ['a\\b\\c']