vlad 6f123ff03e 18.07 | 6 năm trước cách đây | |
---|---|---|
.. | ||
out | 6 năm trước cách đây | |
LICENSE | 6 năm trước cách đây | |
README.md | 6 năm trước cách đây | |
index.d.ts | 6 năm trước cách đây | |
index.js | 6 năm trước cách đây | |
package.json | 6 năm trước cách đây |
Is a faster
node-glob
alternative.
['*', '!*.md']
).!**/node_modules/**
).fs.Stats
for matched path if you wanted.If you want to thank me, or promote your Issue.
Sorry, but I have work and support for packages requires some time after work. I will be glad of your support and PR's.
$ npm install --save fast-glob
const fg = require('fast-glob');
fg(['src/**/*.js', '!src/**/*.spec.js']).then((entries) => console.log(entries));
fg.async(['src/**/*.js', '!src/**/*.spec.js']).then((entries) => console.log(entries));
const fg = require('fast-glob');
const entries = fg.sync(['src/**/*.js', '!src/**/*.spec.js']);
console.log(entries);
const fg = require('fast-glob');
const stream = fg.stream(['src/**/*.js', '!src/**/*.spec.js']);
const entries = [];
stream.on('data', (entry) => entries.push(entry));
stream.once('error', console.log);
stream.once('end', () => console.log(entries));
Returns a Promise<Array>
of matching entries.
string|string[]
This package does not respect the order of patterns. First, all the negative patterns are applied, and only then the positive patterns.
Object
See options section for more detailed information.
Returns a Array
of matching entries.
Returns a ReadableStream
.
Return a set of tasks based on provided patterns. All tasks satisfy the Task
interface:
interface Task {
/**
* Parent directory for all patterns inside this task.
*/
base: string;
/**
* Dynamic or static patterns are in this task.
*/
dynamic: boolean;
/**
* All patterns.
*/
patterns: string[];
/**
* Only positive patterns.
*/
positive: string[];
/**
* Only negative patterns without ! symbol.
*/
negative: string[];
}
string
process.cwd()
The current working directory in which to search.
number|boolean
true
The deep option can be set to true
to traverse the entire directory structure, or it can be set to a number to only traverse that many levels deep.
string[]
[]
An array of glob patterns to exclude matches.
boolean
false
Allow patterns to match filenames starting with a period (files & directories), even if the pattern does not explicitly have a period in that spot.
number|boolean
false
Return fs.Stats
with path
property instead of file path.
boolean
true
Return only files.
boolean
false
Return only directories.
boolean
true
Follow symlinked directories when expanding **
patterns.
boolean
true
Prevent duplicate results.
boolean
false
Add a /
character to directory entries.
boolean
false
Return absolute paths for matched entries.
boolean
false
Disable expansion of brace patterns ({a,b}
, {1..3}
).
boolean
true
The nobrace
option without double-negation. This option has a higher priority then nobrace
.
boolean
false
Disable matching with globstars (**
).
boolean
true
The noglobstar
option without double-negation. This option has a higher priority then noglobstar
.
boolean
false
Disable extglob support (patterns like +(a|b)
), so that extglobs are regarded as literal characters.
boolean
true
The noext
option without double-negation. This option has a higher priority then noext
.
boolean
false
Disable a case-insensitive regex for matching files.
boolean
true
The nocase
option without double-negation. This option has a higher priority then nocase
.
boolean
false
Allow glob patterns without slashes to match a file path based on its basename. For example, a?b
would match the path /xyz/123/acb
, but not /xyz/acb/123
.
Function
null
Allows you to transform a path or fs.Stats
object before sending to the array.
const fg = require('fast-glob');
const entries1 = fg.sync(['**/*.scss']);
const entries2 = fg.sync(['**/*.scss'], { transform: (entry) => '_' + entry });
console.log(entries1); // ['a.scss', 'b.scss']
console.log(entries2); // ['_a.scss', '_b.scss']
If you are using TypeScript, you probably want to specify your own type of the returned array.
import * as fg from 'fast-glob';
interface IMyOwnEntry {
path: string;
}
const entries: IMyOwnEntry[] = fg.sync<IMyOwnEntry>(['*.md'], {
transform: (entry) => typeof entry === 'string' ? { path: entry } : { path: entry.path }
// Will throw compilation error for non-IMyOwnEntry types (boolean, for example)
});
You can use a negative pattern like this: !**/node_modules
or !**/node_modules/**
. Also you can use ignore
option. Just look at the example below.
first/
├── file.md
└── second
└── file.txt
If you don't want to read the second
directory, you must write the following pattern: !**/second
or !**/second/**
.
fg.sync(['**/*.md', '!**/second']); // ['first/file.txt']
fg.sync(['**/*.md'], { ignore: '**/second/**' }); // ['first/file.txt']
:warning: When you write
!**/second/**/*
it means that the directory will be read, but all the entries will not be included in the results.
You have to understand that if you write the pattern to exclude directories, then the directory will not be read under any circumstances.
node-glob
?Not fully, because fast-glob
does not implement all options of node-glob
. See table below.
node-glob | fast-glob |
---|---|
cwd |
cwd |
root |
– |
dot |
dot |
nomount |
– |
mark |
markDirectories |
nosort |
– |
nounique |
unique |
nobrace |
nobrace or brace |
noglobstar |
noglobstar or globstar |
noext |
noext or extension |
nocase |
nocase or case |
matchBase |
matchbase |
nodir |
onlyFiles |
ignore |
ignore |
follow |
followSymlinkedDirectories |
realpath |
– |
absolute |
absolute |
Tech specs:
Server: Vultr Bare Metal
You can see results here for latest release.
fs.readdir()
.See the Releases section of our GitHub project for changelogs for each release version.
This software is released under the terms of the MIT license.