babel-plugin-transform-function-bind - npm Package Compare versions

Comparing version 6.8.0 to 6.22.0

lib/index.js

@@ -1,7 +0,7 @@
-/*istanbul ignore next*/"use strict";
+"use strict";
 
 exports.__esModule = true;
 
-exports.default = function ( /*istanbul ignore next*/_ref) {
-  /*istanbul ignore next*/var t = _ref.types;
+exports.default = function (_ref) {
+  var t = _ref.types;
 
@@ -37,6 +37,6 @@ function getTempId(scope) {
 
-    visitor: { /*istanbul ignore next*/
+    visitor: {
       CallExpression: function CallExpression(_ref2) {
-        /*istanbul ignore next*/var node = _ref2.node;
-        /*istanbul ignore next*/var scope = _ref2.scope;
+        var node = _ref2.node,
+            scope = _ref2.scope;
 
@@ -50,5 +50,5 @@ var bind = node.callee;
       },
-      /*istanbul ignore next*/BindExpression: function BindExpression(path) {
-        /*istanbul ignore next*/var node = path.node;
-        /*istanbul ignore next*/var scope = path.scope;
+      BindExpression: function BindExpression(path) {
+        var node = path.node,
+            scope = path.scope;
 
@@ -62,2 +62,2 @@ var context = inferBindContext(node, scope);
 
-/*istanbul ignore next*/module.exports = exports["default"];
+module.exports = exports["default"];

package.json

 {
   "name": "babel-plugin-transform-function-bind",
-  "version": "6.8.0",
+  "version": "6.22.0",
   "description": "Compile function bind operator to ES5",
@@ -13,7 +13,7 @@ "repository": "https://github.com/babel/babel/tree/master/packages/babel-plugin-transform-function-bind",
     "babel-plugin-syntax-function-bind": "^6.8.0",
-    "babel-runtime": "^6.0.0"
+    "babel-runtime": "^6.22.0"
   },
   "devDependencies": {
-    "babel-helper-plugin-test-runner": "^6.8.0"
+    "babel-helper-plugin-test-runner": "^6.22.0"
   }
 }

README.md

 # babel-plugin-transform-function-bind
 
-Compile function bind operator to ES5
+> Compile the new function bind operator `::` to ES5.
 
+## Detail
+
+```js
+obj::func
+// is equivalent to:
+func.bind(obj)
+
+obj::func(val)
+// is equivalent to:
+func.call(obj, val)
+
+::obj.func(val)
+// is equivalent to:
+func.call(obj, val)
+```
+
+[Try in REPL](http://babeljs.io/repl/#?evaluate=true&presets=es2015%2Cstage-0&code=obj%3A%3Afunc%3B%0A%0Aobj%3A%3Afunc(val)%3B%0A%0A%3A%3Aobj.func(val)%3B)
+
+## Example
+
+### Basic
+
+```js
+const box = {
+  weight: 2,
+  getWeight() { return this.weight; },
+};
+
+const { getWeight } = box;
+
+console.log(box.getWeight()); // prints '2'
+
+const bigBox = { weight: 10 };
+console.log(bigBox::getWeight()); // prints '10'
+
+// Can be chained:
+function add(val) { return this + val; }
+
+console.log(bigBox::getWeight()::add(5)); // prints '15'
+```
+
+[Try in REPL](http://babeljs.io/repl/#?evaluate=true&presets=es2015%2Cstage-0&code=const%20box%20%3D%20%7B%0A%20%20weight%3A%202%2C%0A%20%20getWeight()%20%7B%20return%20this.weight%3B%20%7D%2C%0A%7D%3B%0A%0Aconst%20%7B%20getWeight%20%7D%20%3D%20box%3B%0A%0Aconsole.log(box.getWeight())%3B%20%2F%2F%20prints%20'2'%0A%0Aconst%20bigBox%20%3D%20%7B%20weight%3A%2010%20%7D%3B%0Aconsole.log(bigBox%3A%3AgetWeight())%3B%20%2F%2F%20prints%20'10'%0A%2F%2F%20bigBox%3A%3AgetWeight()%20is%20equivalent%20to%20getWeight.call(bigBox)%0A%0A%2F%2F%20Can%20be%20chained%3A%0Afunction%20add(val)%20%7B%20return%20this%20%2B%20val%3B%20%7D%0A%0Aconsole.log(bigBox%3A%3AgetWeight()%3A%3Aadd(5))%3B%20%2F%2F%20prints%20'15')
+
+### Using with `document.querySelectorAll`
+
+It can be very handy when used with `document.querySelectorAll`:
+
+```js
+const { map, filter } = Array.prototype;
+
+let sslUrls = document.querySelectorAll('a')
+                ::map(node => node.href)
+                ::filter(href => href.substring(0, 5) === 'https');
+
+console.log(sslUrls);
+```
+
+[Try in REPL](http://babeljs.io/repl/#?evaluate=true&presets=es2015%2Cstage-0&code=%0Aconst%20%7B%20map%2C%20filter%20%7D%20%3D%20Array.prototype%3B%0A%0Alet%20sslUrls%20%3D%20document.querySelectorAll('a')%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%3A%3Amap(node%20%3D%3E%20node.href)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%3A%3Afilter(href%20%3D%3E%20href.substring(0%2C%205)%20%3D%3D%3D%20'https')%3B%0A%0Aconsole.log(sslUrls)%3B%0A)
+
+`document.querySelectorAll` returns a `NodeList` element which is not a plain array, so you normally can't use the `map` function on it, and have to use it this way: `Array.prototype.map.call(document.querySelectorAll(...), node => { ... })`. The above code using the `::` will work because it is equivalent to:
+
+```js
+const { map, filter } = Array.prototype;
+
+let sslUrls = document.querySelectorAll('a');
+sslUrls = map.call(sslUrls, node => node.href);
+sslUrls = filter.call(sslUrls, href => href.substring(0, 5) === 'https');
+
+console.log(sslUrls);
+```
+
+### Auto self binding
+When nothing is specified before the `::` operator, the function is bound to its object:
+
+```js
+$('.some-link').on('click', ::view.reset);
+// is equivalent to:
+$('.some-link').on('click', view.reset.bind(view));
+```
+
 ## Installation
 
 ```sh
-$ npm install babel-plugin-transform-function-bind
+npm install --save-dev babel-plugin-transform-function-bind
 ```
@@ -26,3 +106,3 @@
 ```sh
-$ babel --plugins transform-function-bind script.js
+babel --plugins transform-function-bind script.js
 ```
@@ -37,1 +117,6 @@
 ```
+
+## References
+
+* [Proposal](https://github.com/zenparsing/es-function-bind)
+* [Babel Blog: Function Bind Syntax](/blog/2015/05/14/function-bind)

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

5901

increased by99.7%

Number of lines in readme file

121

increased by236.11%

Dependency changes

• Updatedbabel-runtime@^6.22.0