diff options
Diffstat (limited to 'node_modules/empower-core')
| -rw-r--r-- | node_modules/empower-core/CHANGELOG.md | 8 | ||||
| -rw-r--r-- | node_modules/empower-core/MIT-LICENSE.txt | 2 | ||||
| -rw-r--r-- | node_modules/empower-core/README.md | 293 | ||||
| -rw-r--r-- | node_modules/empower-core/build/empower-core.js | 12 | ||||
| -rw-r--r-- | node_modules/empower-core/index.js | 2 | ||||
| -rw-r--r-- | node_modules/empower-core/lib/default-options.js | 2 | ||||
| -rw-r--r-- | node_modules/empower-core/package.json | 2 |
7 files changed, 312 insertions, 9 deletions
diff --git a/node_modules/empower-core/CHANGELOG.md b/node_modules/empower-core/CHANGELOG.md index e12cc0605..5434365a1 100644 --- a/node_modules/empower-core/CHANGELOG.md +++ b/node_modules/empower-core/CHANGELOG.md @@ -1,3 +1,11 @@ +### [0.6.2](http://github.com/twada/empower-core/releases/tag/v0.6.2) (2017-06-03) + + +#### Bug Fixes + +* [dealing with `err.name` on Node v8](https://github.com/twada/empower-core/pull/9) + + ### [0.6.1](https://github.com/twada/empower-core/releases/tag/v0.6.1) (2016-06-05) diff --git a/node_modules/empower-core/MIT-LICENSE.txt b/node_modules/empower-core/MIT-LICENSE.txt index b3f58e171..dbe5dca58 100644 --- a/node_modules/empower-core/MIT-LICENSE.txt +++ b/node_modules/empower-core/MIT-LICENSE.txt @@ -1,4 +1,4 @@ -Copyright (c) 2013-2016 Takuto Wada, https://github.com/twada/empower-core +Copyright (c) 2013-2017 Takuto Wada, https://github.com/twada/empower-core Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the diff --git a/node_modules/empower-core/README.md b/node_modules/empower-core/README.md new file mode 100644 index 000000000..dc7ef4646 --- /dev/null +++ b/node_modules/empower-core/README.md @@ -0,0 +1,293 @@ +empower-core +================================ + +[![Build Status][travis-image]][travis-url] +[![NPM package][npm-image]][npm-url] +[![Dependency Status][depstat-image]][depstat-url] +[![License][license-image]][license-url] +[![Built with Gulp][gulp-image]][gulp-url] + + +Power Assert feature enhancer for assert function/object. + + +DESCRIPTION +--------------------------------------- +`empower-core` is a core module of [power-assert](https://github.com/power-assert-js/power-assert) family. `empower-core` enhances standard `assert` function or any assert-like object to work with power-assert feature added code instrumented by [espower](https://github.com/power-assert-js/espower). + + +`empower-core` works with standard `assert` function (best fit with [Mocha](https://mochajs.org/)), and also supports assert-like objects/functions provided by various testing frameworks such as [QUnit](https://qunitjs.com/), [buster.js](http://docs.busterjs.org/en/latest/), and [nodeunit](https://github.com/caolan/nodeunit). + + +Pull-requests, issue reports and patches are always welcomed. See [power-assert](https://github.com/power-assert-js/power-assert) project for more documentation. + + +CHANGELOG +--------------------------------------- +See [CHANGELOG](https://github.com/twada/empower-core/blob/master/CHANGELOG.md) + + +API +--------------------------------------- + +### var enhancedAssert = empowerCore(originalAssert, [options]) + +| return type | +|:-----------------------| +| `function` or `object` | + +`empower-core` function takes function or object(`originalAssert`) then returns PowerAssert feature added function/object based on `originalAssert`. +If `destructive` option is falsy, `originalAssert` will be unchanged. If `destructive` option is truthy, `originalAssert` will be manipulated directly and returned `enhancedAssert` will be the same instance of `originalAssert`. + + +#### originalAssert + +| type | default value | +|:-----------------------|:--------------| +| `function` or `object` | N/A | + +`originalAssert` is an instance of standard `assert` function or any assert-like object. see [SUPPORTED ASSERTION LIBRARIES](https://github.com/twada/empower-core#supported-assertion-libraries) and [ASSERTION LIBRARIES KNOWN TO WORK](https://github.com/twada/empower-core#assertion-libraries-known-to-work) section. Be careful that `originalAssert` will be manipulated directly if `destructive` option is truthy. + + +#### options + +| type | default value | +|:---------|:--------------| +| `object` | (return value of `empowerCore.defaultOptions()`) | + +Configuration options. If not passed, default options will be used. + + +#### options.destructive + +| type | default value | +|:----------|:--------------| +| `boolean` | `false` | + +If truthy, modify `originalAssert` destructively. + +If `false`, empower-core mimics originalAssert as new object/function, so `originalAssert` will not be changed. If `true`, `originalAssert` will be manipulated directly and returned `enhancedAssert` will be the same instance of `originalAssert`. + + +#### options.bindReceiver + +| type | default value | +|:----------|:--------------| +| `boolean` | `true` | + +`bindReceiver` defaults to `true`, meaning assertion methods have their `this` value bound to the original assertion. Setting `bindReceiver` to false causes the `this` reference to be passed through from the actual invocation. + + +#### options.onError +#### options.onSuccess + +| type | default value | +|:-----------|:--------------| +| `function` | (function defined in `empowerCore.defaultOptions()`) | + +Both methods are called with a single `event` argument, it will have the following properties: + +- `event.enhanced` - `true` for methods matching `patterns`. `false` for methods matching `wrapOnlyPatterns`. + +- `event.originalMessage` - The actual value the user provided for optional `message` parameter. This will be `undefined` if the user did not provide a value, even if the underlying assertion provides a default message. + +- `event.defaultMessage` - If you use objects instead of strings to specify patterns (see below), the `defaultMessage` metadata will be copied directly on the event object. + +- `event.matcherSpec` - This contains the complete parsed matcher spec as supplied, as well as any additional metadata you may have supplied (see patterns section below for details on how to supply additional metadata). + +- `event.args` - An array of the actual arguments passed to the assertion. + +- `event.assertionThrew` - Whether or not the underlying assertion threw an error. This will always be `true` in an `onError` callback, and always `false` in an `onSuccess` callback. + +- `event.error` - Only present if `event.assertionThrew === true`. Contains the error thrown by the underlying assertion method. + +- `event.returnValue` - Only present if `event.assertionThrew === false`. Contains the value return value returned by the underlying assertion method. + +- `event.powerAssertContext` - Only present for methods that match `patterns`, and only in code that has been enhanced with the power-assert transform. It contains the information necessary for power-assert renderers to generate their output. Implementors of `onError` should usually attach it to the error object + + ```js + function onError (errorEvent) { + var e = errorEvent.error; + if (errorEvent.powerAssertContext && /^AssertionError/.test(e.name)) { + e.powerAssertContext = errorEvent.powerAssertContext; + } + throw e; + } + ``` + +#### options.modifyMessageBeforeAssert + +| type | default value | +|:-----------|:--------------| +| `function` | N/A | + +TBD + + +#### options.patterns + +| type | default value | +|:--------------------|:--------------------| +| `Array` of `string` or `objects`| objects shown below | + +```javascript +[ + 'assert(value, [message])', + 'assert.ok(value, [message])', + 'assert.equal(actual, expected, [message])', + 'assert.notEqual(actual, expected, [message])', + 'assert.strictEqual(actual, expected, [message])', + 'assert.notStrictEqual(actual, expected, [message])', + 'assert.deepEqual(actual, expected, [message])', + 'assert.notDeepEqual(actual, expected, [message])', + 'assert.deepStrictEqual(actual, expected, [message])', + 'assert.notDeepStrictEqual(actual, expected, [message])' +] +``` +Target patterns for power assert feature instrumentation. + +Pattern detection is done by [call-signature](https://github.com/jamestalmage/call-signature). Any arguments enclosed in bracket (for example, `[message]`) means optional parameters. Without bracket means mandatory parameters. + +Instead of a string, you may alternatively specify an object with a `pattern` property, and any other arbitrary data. +Currently only `defaultMessage` is formally recommended, but you can attach any data here and it will be passed to the `onSuccess` and `onError` handlers. + +```javascript +[ + { + pattern: 'assert.fail([message])', + defaultMessage:'assert.fail() was called!!' + }, + ... +] +``` + +#### options.wrapOnlyPatterns + +| type | default value | +|:--------------------|:--------------------| +| `Array` of `string` | empty array | + +Methods matching these patterns will not be instrumented by the code transform, but they will be wrapped at runtime and trigger events in the `onSuccess` and `onError` callbacks. Note that "wrap only" events will never have a `powerAssertContext` property. + +Similar to the `options.patterns`, you may supply objects with a `pattern` member, and the additional metadata will be passed to the assertion listeners. + +### var options = empowerCore.defaultOptions(); + +Returns default options object for `empowerCore` function. In other words, returns + +```javascript +{ + destructive: false, + onError: onError, + onSuccess: onSuccess, + patterns: [ + 'assert(value, [message])', + 'assert.ok(value, [message])', + 'assert.equal(actual, expected, [message])', + 'assert.notEqual(actual, expected, [message])', + 'assert.strictEqual(actual, expected, [message])', + 'assert.notStrictEqual(actual, expected, [message])', + 'assert.deepEqual(actual, expected, [message])', + 'assert.notDeepEqual(actual, expected, [message])', + 'assert.deepStrictEqual(actual, expected, [message])', + 'assert.notDeepStrictEqual(actual, expected, [message])' + ] +} +``` + +with sensible default for `onError` and `onSuccess` + +```js +function onError (errorEvent) { + var e = errorEvent.error; + if (errorEvent.powerAssertContext && e.name === 'AssertionError') { + e.powerAssertContext = errorEvent.powerAssertContext; + } + throw e; +} + +function onSuccess(successEvent) { + return successEvent.returnValue; +} +``` + + +SUPPORTED ASSERTION LIBRARIES +--------------------------------------- +* [Node assert API](https://nodejs.org/api/assert.html) + + +ASSERTION LIBRARIES KNOWN TO WORK +--------------------------------------- +* [QUnit.assert](https://qunitjs.com/) +* [nodeunit](https://github.com/caolan/nodeunit) +* [buster-assertions](http://docs.busterjs.org/en/latest/modules/buster-assertions/) + + +INSTALL +--------------------------------------- + +### via npm + +Install + + $ npm install --save-dev empower-core + + +#### use empower-core npm module on browser + +`empowerCore` function is exported + + <script type="text/javascript" src="./path/to/node_modules/empower-core/build/empower-core.js"></script> + + +### via bower + +Install + + $ bower install --save-dev empower-core + +Then load (`empowerCore` function is exported) + + <script type="text/javascript" src="./path/to/bower_components/empower-core/build/empower-core.js"></script> + + +OUR SUPPORT POLICY +--------------------------------------- + +We support Node under maintenance. In other words, we stop supporting old Node version when [their maintenance ends](https://github.com/nodejs/LTS). + +We also support "modern enough" browsers such as Chrome, Firefox, Safari, Edge etc. + +Any other environments are not supported officially (means that we do not test against them on CI service). empower-core is known to work with old browsers, and trying to keep them working though. + + +AUTHOR +--------------------------------------- +* [Takuto Wada](https://github.com/twada) + + +CONTRIBUTORS +--------------------------------------- +* [James Talmage (jamestalmage)](https://github.com/jamestalmage) + + +LICENSE +--------------------------------------- +Licensed under the [MIT](https://github.com/twada/empower-core/blob/master/MIT-LICENSE.txt) license. + + +[npm-url]: https://npmjs.org/package/empower-core +[npm-image]: https://badge.fury.io/js/empower-core.svg + +[travis-url]: https://travis-ci.org/twada/empower-core +[travis-image]: https://secure.travis-ci.org/twada/empower-core.svg?branch=master + +[depstat-url]: https://gemnasium.com/twada/empower-core +[depstat-image]: https://gemnasium.com/twada/empower-core.svg + +[license-url]: https://github.com/twada/empower-core/blob/master/MIT-LICENSE.txt +[license-image]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat + +[gulp-url]: http://gulpjs.com/ +[gulp-image]: https://img.shields.io/badge/built_with-gulp-brightgreen.svg diff --git a/node_modules/empower-core/build/empower-core.js b/node_modules/empower-core/build/empower-core.js index bdd9431c6..e018d603d 100644 --- a/node_modules/empower-core/build/empower-core.js +++ b/node_modules/empower-core/build/empower-core.js @@ -7,7 +7,7 @@ * author: Takuto Wada <takuto.wada@gmail.com> * contributors: James Talmage * homepage: http://github.com/twada/empower-core - * version: 0.6.1 + * version: 0.6.2 * * call-signature: * license: MIT (http://opensource.org/licenses/MIT) @@ -20,7 +20,7 @@ * license: MIT (http://opensource.org/licenses/MIT) * maintainers: zloirock <zloirock@zloirock.ru> * homepage: https://github.com/zloirock/core-js#readme - * version: 2.4.0 + * version: 2.4.1 * * This header is generated by licensify (https://github.com/twada/licensify) */ @@ -30,7 +30,7 @@ * * https://github.com/twada/empower-core * - * Copyright (c) 2013-2016 Takuto Wada + * Copyright (c) 2013-2017 Takuto Wada * Licensed under the MIT license. * https://github.com/twada/empower-core/blob/master/MIT-LICENSE.txt */ @@ -367,7 +367,7 @@ module.exports = function defaultOptions () { function onError (errorEvent) { var e = errorEvent.error; - if (errorEvent.powerAssertContext && e.name === 'AssertionError') { + if (errorEvent.powerAssertContext && /^AssertionError/.test(e.name)) { e.powerAssertContext = errorEvent.powerAssertContext; } throw e; @@ -825,6 +825,7 @@ var createDict = function(){ // Thrash, waste and sodomy: IE GC bug var iframe = _dereq_('./_dom-create')('iframe') , i = enumBugKeys.length + , lt = '<' , gt = '>' , iframeDocument; iframe.style.display = 'none'; @@ -834,7 +835,7 @@ var createDict = function(){ // html.removeChild(iframe); iframeDocument = iframe.contentWindow.document; iframeDocument.open(); - iframeDocument.write('<script>document.F=Object</script' + gt); + iframeDocument.write(lt + 'script' + gt + 'document.F=Object' + lt + '/script' + gt); iframeDocument.close(); createDict = iframeDocument.F; while(i--)delete createDict[PROTOTYPE][enumBugKeys[i]]; @@ -852,6 +853,7 @@ module.exports = Object.create || function create(O, Properties){ } else result = createDict(); return Properties === undefined ? result : dPs(result, Properties); }; + },{"./_an-object":16,"./_dom-create":26,"./_enum-bug-keys":27,"./_html":33,"./_object-dps":41,"./_shared-key":48}],40:[function(_dereq_,module,exports){ var anObject = _dereq_('./_an-object') , IE8_DOM_DEFINE = _dereq_('./_ie8-dom-define') diff --git a/node_modules/empower-core/index.js b/node_modules/empower-core/index.js index c72d327a0..b262b2bc6 100644 --- a/node_modules/empower-core/index.js +++ b/node_modules/empower-core/index.js @@ -3,7 +3,7 @@ * * https://github.com/twada/empower-core * - * Copyright (c) 2013-2016 Takuto Wada + * Copyright (c) 2013-2017 Takuto Wada * Licensed under the MIT license. * https://github.com/twada/empower-core/blob/master/MIT-LICENSE.txt */ diff --git a/node_modules/empower-core/lib/default-options.js b/node_modules/empower-core/lib/default-options.js index 77b0f5c05..1575f09ec 100644 --- a/node_modules/empower-core/lib/default-options.js +++ b/node_modules/empower-core/lib/default-options.js @@ -24,7 +24,7 @@ module.exports = function defaultOptions () { function onError (errorEvent) { var e = errorEvent.error; - if (errorEvent.powerAssertContext && e.name === 'AssertionError') { + if (errorEvent.powerAssertContext && /^AssertionError/.test(e.name)) { e.powerAssertContext = errorEvent.powerAssertContext; } throw e; diff --git a/node_modules/empower-core/package.json b/node_modules/empower-core/package.json index bbc92230c..f09c4b12b 100644 --- a/node_modules/empower-core/package.json +++ b/node_modules/empower-core/package.json @@ -1,7 +1,7 @@ { "name": "empower-core", "description": "Power Assert feature enhancer for assert function/object", - "version": "0.6.1", + "version": "0.6.2", "author": { "name": "Takuto Wada", "email": "takuto.wada@gmail.com", |