# validate-glob-opts

> Validate glob options

Latest version **1.0.2** (published 2018-02-08) · ISC license · 0 weekly downloads

## Install

```sh
npm install validate-glob-opts
pnpm add validate-glob-opts
yarn add validate-glob-opts
bun add validate-glob-opts
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.2 |
| Published | 2018-02-08 |
| First published | 2017-01-24 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 12.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Shinnosuke Watanabe |
| Maintainers | shinnn |
| Keywords | glob, option, validate, invalidate, check, type, strict |

## Links

- npm: https://www.npmjs.com/package/validate-glob-opts
- Repository: https://github.com/shinnn/validate-glob-opts
- Homepage: https://github.com/shinnn/validate-glob-opts#readme
- Issues: https://github.com/shinnn/validate-glob-opts/issues
- npm.io page: https://npm.io/package/validate-glob-opts

## Dependencies (4)

- [is-plain-obj](https://npm.io/package/is-plain-obj.md) ^1.1.0
- [indexed-filter](https://npm.io/package/indexed-filter.md) ^1.0.0
- [array-to-sentence](https://npm.io/package/array-to-sentence.md) ^1.1.0
- [inspect-with-kind](https://npm.io/package/inspect-with-kind.md) ^1.0.4

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 1.0.2 (latest) — 2018-02-08
- 1.0.1 — 2018-02-08
- 1.0.0 — 2017-05-16
- 0.5.0 — 2017-05-16
- 0.4.0 — 2017-02-01
- 0.3.0 — 2017-02-01
- 0.2.1 — 2017-01-30
- 0.2.0 — 2017-01-25
- 0.1.0 — 2017-01-24
- 0.0.0 — 2017-01-24

## README

# validate-glob-opts

[![npm version](https://img.shields.io/npm/v/validate-glob-opts.svg)](https://www.npmjs.com/package/validate-glob-opts)
[![Build Status](https://travis-ci.org/shinnn/validate-glob-opts.svg?branch=master)](https://travis-ci.org/shinnn/validate-glob-opts)
[![Coverage Status](https://img.shields.io/coveralls/shinnn/validate-glob-opts.svg)](https://coveralls.io/r/shinnn/validate-glob-opts)

Validate [node-glob](https://github.com/isaacs/node-glob) options

```javascript
validateGlobOpts({
  sync: true,
  mark: '/',
  caches: {}
});
/* => [
  Error: `sync` option is deprecated and there’s no need to pass any values to that option, but true was provided.,
  TypeError: node-glob expected `mark` option to be a Boolean value, but got '/' (string).,
  Error: node-glob doesn't have `caches` option. Probably you meant `cache`.
] */
```

## Installation

[Use](https://docs.npmjs.com/cli/install) [npm](https://docs.npmjs.com/getting-started/what-is-npm).

```
npm install validate-glob-opts
```

## API

```javascript
const validateGlobOpts = require('validate-glob-opts');
```

### validateGlobOpts(*obj* [, *customValidations*])

*obj*: `Object` ([`glob` options](https://github.com/isaacs/node-glob#options))  
*customValidations*: `Array<function>`  
Return: `Array<Error>`

It strictly validates `glob` options, for example,

* It disallows the deprecated `sync` option to receive any values.
* It disallows String options e.g. `cwd` to receive non-string values.
* It disallows Boolean options e.g. `stat` to receive non-boolean values.
* It disallows Object options e.g. `symlinks` to receive non-object values.
* It invalidates probably typoed option names e.g. `symlink`.

Then, it returns the validation result as an array of error objects.

```javascript
const validateGlobOpts = require('validate-glob-opts');

const ok = {
  root: '/foo/bar/',
  nodir: true,
  ignore: ['path1', 'path2'],
  symlinks: {}
};

validateGlobOpts(ok); //=> []

const notOk = {
  root: Buffer.from('Hi'),
  nodir: NaN,
  ignore: ['path1', 1],
  symlink: {}
};

const results = validateGlobOpts(notOk);
results.length; //=> 4
results[0];
//=>  TypeError: node-glob expected `root` option to be a directory path (string), but got <Buffer 48 69>.
results[1];
//=> TypeError: node-glob expected `nodir` option to be a Boolean value, but got NaN (number).
results[2];
//=> TypeError: Expected every value in the `ignore` option to be a string, but the array includes a non-string value 1 (number).
results[3];
//=> Error: node-glob doesn't have `symlink` option. Probably you meant `symlinks`.
```

#### User-defined validation

You can provide your own validations by passing an array of functions to the second parameter. Each function receives the object and should return an error when the object is not valid.

```javascript
validateGlobOpts({realPath: true, nodir: true});
/*=> [
  Error: node-glob doesn't have `realPath` option. Probably you meant `realpath`.
] */

validateGlobOpts({realPath: true, nodir: true}, [
  obj => obj.nodir ? new Error('My app doesn\'t support `nodir` option.') : null
]);
/*=> [
  Error: node-glob doesn't have `realPath` option. Probably you meant `realpath`.
  TypeError: My app doesn't support `nodir` option.
] */
```

## License

[ISC License](./LICENSE) © 2018 Shinnosuke Watanabe

---
_Source: https://npm.io/package/validate-glob-opts · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._