Socket
Socket
Sign inDemoInstall

ignore

Package Overview
Dependencies
0
Maintainers
1
Versions
88
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

ignore

Ignore is a manager and filter for .gitignore rules.


Version published
Maintainers
1
Weekly downloads
54,243,105
decreased by-8.32%

Weekly downloads

Package description

What is ignore?

The ignore npm package is a utility for filtering files and directories according to the particular rules specified in .gitignore files. It can be used to create ignore patterns similar to how git handles .gitignore files, allowing developers to programmatically determine which files should be ignored based on these patterns.

What are ignore's main functionalities?

Add ignore rules

This feature allows you to add ignore rules, which can be a single string or an array of strings representing the patterns to ignore. The example demonstrates adding rules to ignore the .git directory and any files ending with .test.js.

const ignore = require('ignore');
const ig = ignore().add(['.git', '*.test.js']);
console.log(ig.ignores('example.test.js')); // true

Filter file paths

This feature provides a way to filter an array of file paths, removing any that match the ignore patterns. The code sample filters out 'example.test.js' because it matches the '*.test.js' pattern.

const ignore = require('ignore');
const ig = ignore().add('*.test.js');
const files = ['test.js', 'example.test.js', 'README.md'];
const filtered = files.filter(ig.createFilter());
console.log(filtered); // ['test.js', 'README.md']

Check if a file is ignored

This feature checks if a particular file would be ignored based on the current ignore rules. The code sample checks if 'example.test.js' is ignored (true) and if 'README.md' is ignored (false).

const ignore = require('ignore');
const ig = ignore().add('*.test.js');
console.log(ig.ignores('example.test.js')); // true
console.log(ig.ignores('README.md')); // false

Other packages similar to ignore

Readme

Source

ignore

NPM version npm module downloads per month Build Status Dependency Status

ignore is a manager and filter which implemented in pure JavaScript according to the .gitignore spec.

Pay attention that minimatch does not work in the gitignore way. To filter filenames according to .gitignore file, I recommend this module.

Installation

npm install ignore --save

Usage

var ignore = require('ignore');
var ig = ignore(options).addPattern(['.abc/*', '!.abc/d/']);

Filter the given paths

var paths = [
    '.abc/a.js',    // filtered out
    '.abc/d/e.js'   // included
];

ig.filter(paths); // ['.abc/d/e.js']

As the filter function

paths.filter(ig.createFilter()); // ['.abc/d/e.js']

With ignore files

For most cases, we'd better use only one ignore file. We could use ignore.select to select the first existing file.

ignore().addIgnoreFile(
	ignore.select([
		'.xxxignore',
		'.gitignore',
		'.ignore'
	])
);

Why another ignore?

  1. ignore is a standalone module, and is much simpler so that it could easy work with other programs, unlike isaacs's fstream-ignore which must work with the modules of the fstream family.

  2. ignore only contains utility methods to filter paths according to the specified ignore rules, so

  • ignore never try to find out ignore rules by traversing directories or fetching from git configurations.

  • ignore don't cares about sub-modules of git projects.

  1. Exactly according to gitignore man page, fixes some known matching issues of fstream-ignore, such as:
    • '/*.js' should only match 'a.js', but not 'abc/a.js'.
    • '**/foo' should match 'foo' anywhere.

Methods

.addPattern(pattern)

Adds a rule or several rules to the current manager.

Returns this
pattern String|Array.<String>

The ignore rule or a array of rules.

Notice that a line starting with '#'(hash) is treated as a comment. Put a backslash ('\') in front of the first hash for patterns that begin with a hash, if you want to ignore a file with a hash at the beginning of the filename.

ignore().addPattern('#abc').filter(['#abc']); // ['#abc']
ignore().addPattern('\#abc').filter(['#abc']); // []

.addIgnoreFile(path)

Adds rules from a ignore file or several files

Returns this
Rule String|Array.<String>

.filter(paths)

Filters the given array of pathnames, and returns the filtered array.

paths Array.<path>

The array of paths to be filtered.

NOTICE that each path here should be a relative path to the root of your repository. Suppose the dir structure is:

/path/to/your/repo
    |-- a
    |   |-- a.js
    |
    |-- .b
    |
    |-- .c
         |-- .DS_store 

Then the paths might be like this:

[
    'a/a.js'
    '.b',
    '.c/.DS_store'
]

Usually, you could use glob to fetch the structure of the current directory:

var glob = require('glob');
glob('**', function(err, files){
    var filtered;

    if ( err ) {
        console.log(err);
    } else {
        filtered = ignore().addIgnoreFile('.gitignore').filter(files);
        console.log(filtered);
    }
});

.createFilter()

Creates a filter function which could filter an array of paths with Array.prototype.filter.

Returns function(path)

The filter function.

Constructor: ignore.Ignore

new ignore.Ignore(options);
ignore(options);
options.matchCase boolean=false

By default, all ignore rules will be treated as case-insensitive ones as well as the git does.

options.twoGlobstars boolean=false

By defailt, ignoreRules will omit every pattern that includes '**' (two consecutive asterisks) which is not compatible cross operating systems, because the behavior of file .gitignore depends on the implementation of command fnmatch in shell.

By the way, Mac OS doesn't support '**'.

options.ignore Array.<String>

The ignore rules to be added. Default to ['.git', '.svn', '.DS_Store']

If you want those directories to be included, you could

ignore({
	ignore: []
});

You can also use .addPattern() method to do this.

Keywords

FAQs

Last updated on 28 Oct 2015

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc