forked from public/fvtt-cthulhu-eternal
Initial import with skill sheet working
This commit is contained in:
139
node_modules/value-or-function/README.md
generated
vendored
Normal file
139
node_modules/value-or-function/README.md
generated
vendored
Normal file
@ -0,0 +1,139 @@
|
||||
<p align="center">
|
||||
<a href="https://gulpjs.com">
|
||||
<img height="257" width="114" src="https://raw.githubusercontent.com/gulpjs/artwork/master/gulp-2x.png">
|
||||
</a>
|
||||
</p>
|
||||
|
||||
# value-or-function
|
||||
|
||||
[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Coveralls Status][coveralls-image]][coveralls-url]
|
||||
|
||||
Normalize a value or function, applying extra args to the function
|
||||
|
||||
## Example
|
||||
|
||||
```js
|
||||
var normalize = require('value-or-function');
|
||||
|
||||
// Values matching type are returned
|
||||
var isEnabled = normalize('boolean', true);
|
||||
// isEnabled === true
|
||||
|
||||
// Values not matching type return undefined
|
||||
var isEnabled = normalize('boolean', 1);
|
||||
// isEnabled === undefined
|
||||
|
||||
// Functions are called
|
||||
var isEnabled = normalize('boolean', function () {
|
||||
return false;
|
||||
});
|
||||
// isEnabled === false
|
||||
|
||||
// Extra arguments are applied to function
|
||||
var count = normalize(
|
||||
'number',
|
||||
function (a, b) {
|
||||
return a + b;
|
||||
},
|
||||
1,
|
||||
2
|
||||
);
|
||||
// count === 3
|
||||
|
||||
// Supply the function with context
|
||||
var context = { c: 3 };
|
||||
var count = normalize.call(
|
||||
context,
|
||||
'number',
|
||||
function (a, b) {
|
||||
return a + b + this.c;
|
||||
},
|
||||
1,
|
||||
2
|
||||
);
|
||||
// count === 6
|
||||
|
||||
// Values one of multiple types are returned
|
||||
var isEnabled = normalize(['string', 'boolean'], true);
|
||||
// isEnabled === true
|
||||
|
||||
// Provide a function as first argument to do custom coercion
|
||||
var now = new Date();
|
||||
var enabledSince = normalize(function (value) {
|
||||
if (value.constructor === Date) {
|
||||
return value;
|
||||
}
|
||||
}, now);
|
||||
// enabledSince === now
|
||||
|
||||
// Convenience methods are available for the built-in types
|
||||
var result = normalize.object({});
|
||||
var result = normalize.number(1);
|
||||
var result = normalize.string('');
|
||||
var result = normalize.symbol(Symbol());
|
||||
var result = normalize.boolean(true);
|
||||
var result = normalize.function(function () {});
|
||||
var result = normalize.date(new Date());
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
### `normalize(coercer, value[, ...appliedArguments])`
|
||||
|
||||
Takes a coercer function `coercer` to transform `value` to the desired type.
|
||||
Also optionally takes any extra arguments to apply to `value` if `value` is a function.
|
||||
|
||||
If the return value of `coercer(value)` is not `null` or `undefined`, that value is returned.
|
||||
Otherwise, if `value` is a function, that function is called with any extra arguments
|
||||
supplied to `normalize`, and its return value is passed through the coercer.
|
||||
|
||||
If `coercer` is a string, it must be one of the built-in types (see below)
|
||||
and the appropriate default coercer is invoked, optionally first reducing `value`
|
||||
to a primitive type with `.valueOf()` if it is an Object.
|
||||
|
||||
If `coercer` is an array, each element is tried until one returns something other
|
||||
than `null` or `undefined`, or it results in `undefined` if all of the elements yield `null` or `undefined`.
|
||||
|
||||
#### `normalize.object(value[, ...appliedArguments])`
|
||||
|
||||
Convenience method for `normalize('object', ...)`.
|
||||
|
||||
#### `normalize.number(value[, ...appliedArguments])`
|
||||
|
||||
Convenience method for `normalize('number', ...)`.
|
||||
|
||||
#### `normalize.string(value[, ...appliedArguments])`
|
||||
|
||||
Convenience method for `normalize('string', ...)`.
|
||||
|
||||
#### `normalize.symbol(value[, ...appliedArguments])`
|
||||
|
||||
Convenience method for `normalize('symbol', ...)`.
|
||||
|
||||
#### `normalize.boolean(value[, ...appliedArguments])`
|
||||
|
||||
Convenience method for `normalize('boolean', ...)`.
|
||||
|
||||
#### `normalize.function(value[, ...appliedArguments])`
|
||||
|
||||
Convenience method for `normalize('function', ...)`.
|
||||
|
||||
#### `normalize.date(value[, ...appliedArguments])`
|
||||
|
||||
Convenience method for `normalize('date', ...)`.
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
[downloads-image]: https://img.shields.io/npm/dm/value-or-function.svg?style=flat-square
|
||||
[npm-url]: https://npmjs.org/package/value-or-function
|
||||
[npm-image]: https://img.shields.io/npm/v/value-or-function.svg?style=flat-square
|
||||
|
||||
[ci-url]: https://github.com/gulpjs/value-or-function/actions?query=workflow:dev
|
||||
[ci-image]: https://img.shields.io/github/workflow/status/gulpjs/value-or-function/dev?style=flat-square
|
||||
|
||||
[coveralls-url]: https://coveralls.io/r/gulpjs/value-or-function
|
||||
[coveralls-image]: https://img.shields.io/coveralls/gulpjs/value-or-function/master.svg?style=flat-square
|
||||
<!-- prettier-ignore-end -->
|
Reference in New Issue
Block a user