@babel/plugin-transform-for-of
Advanced tools
@babel/plugin-transform-for-of - npm Package Compare versions
Comparing version 7.0.0-beta.49 to 7.0.0-beta.50
| { | ||
| "name": "@babel/plugin-transform-for-of", | ||
| "version": "7.0.0-beta.49", | ||
| "version": "7.0.0-beta.50", | ||
| "description": "Compile ES2015 for...of to ES5", | ||
@@ -12,3 +12,3 @@ "repository": "https://github.com/babel/babel/tree/master/packages/babel-plugin-transform-for-of", | ||
| "dependencies": { | ||
| "@babel/helper-plugin-utils": "7.0.0-beta.49" | ||
| "@babel/helper-plugin-utils": "7.0.0-beta.50" | ||
| }, | ||
@@ -19,5 +19,5 @@ "peerDependencies": { | ||
| "devDependencies": { | ||
| "@babel/core": "7.0.0-beta.49", | ||
| "@babel/helper-plugin-test-runner": "7.0.0-beta.49" | ||
| "@babel/core": "7.0.0-beta.50", | ||
| "@babel/helper-plugin-test-runner": "7.0.0-beta.50" | ||
| } | ||
| } |
147
README.md
@@ -5,151 +5,16 @@ # @babel/plugin-transform-for-of | ||
| ## Example | ||
| See our website [@babel/plugin-transform-for-of](https://new.babeljs.io/docs/en/next/babel-plugin-transform-for-of.html) for more information. | ||
| **In** | ||
| ## Install | ||
| ```js | ||
| for (var i of foo) {} | ||
| ``` | ||
| Using npm: | ||
| **Out** | ||
| ```js | ||
| var _iteratorNormalCompletion = true; | ||
| var _didIteratorError = false; | ||
| var _iteratorError = undefined; | ||
| try { | ||
| for (var _iterator = foo[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) { | ||
| var i = _step.value; | ||
| } | ||
| } catch (err) { | ||
| _didIteratorError = true; | ||
| _iteratorError = err; | ||
| } finally { | ||
| try { | ||
| if (!_iteratorNormalCompletion && _iterator.return != null) { | ||
| _iterator.return(); | ||
| } | ||
| } finally { | ||
| if (_didIteratorError) { | ||
| throw _iteratorError; | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
| ## Installation | ||
| ```sh | ||
| npm install --save-dev @babel/plugin-transform-for-of | ||
| npm install --save @babel/plugin-transform-for-of | ||
| ``` | ||
| ## Usage | ||
| or using yarn: | ||
| ### Via `.babelrc` (Recommended) | ||
| **.babelrc** | ||
| Without options: | ||
| ```js | ||
| { | ||
| "plugins": ["@babel/plugin-transform-for-of"] | ||
| } | ||
| ``` | ||
| With options: | ||
| ```js | ||
| { | ||
| "plugins": [ | ||
| ["@babel/plugin-transform-for-of", { | ||
| "loose": true, // defaults to false | ||
| "assumeArray": true // defaults to false | ||
| }] | ||
| ] | ||
| } | ||
| ``` | ||
| ### Via CLI | ||
| ```sh | ||
| babel --plugins @babel/plugin-transform-for-of script.js | ||
| yarn add --save @babel/plugin-transform-for-of | ||
| ``` | ||
| ### Via Node API | ||
| ```javascript | ||
| require("@babel/core").transform("code", { | ||
| plugins: ["@babel/plugin-transform-for-of"] | ||
| }); | ||
| ``` | ||
| ## Options | ||
| ### `loose` | ||
| `boolean`, defaults to `false` | ||
| In loose mode, arrays are put in a fast path, thus heavily increasing performance. | ||
| All other iterables will continue to work fine. | ||
| #### Example | ||
| **In** | ||
| ```js | ||
| for (var i of foo) {} | ||
| ``` | ||
| **Out** | ||
| ```js | ||
| for (var _iterator = foo, _isArray = Array.isArray(_iterator), _i = 0, _iterator = _isArray ? _iterator : _iterator[Symbol.iterator]();;) { | ||
| var _ref; | ||
| if (_isArray) { | ||
| if (_i >= _iterator.length) break; | ||
| _ref = _iterator[_i++]; | ||
| } else { | ||
| _i = _iterator.next(); | ||
| if (_i.done) break; | ||
| _ref = _i.value; | ||
| } | ||
| var i = _ref; | ||
| } | ||
| ``` | ||
| #### Abrupt completions | ||
| In loose mode an iterator's `return` method will not be called on abrupt completions caused by thrown errors. | ||
| Please see [google/traceur-compiler#1773](https://github.com/google/traceur-compiler/issues/1773) and | ||
| [babel/babel#838](https://github.com/babel/babel/issues/838) for more information. | ||
| ### `assumeArray` | ||
| `boolean`, defaults to `false` | ||
| This will apply the optimization shown below to all for-of loops by assuming that _all_ loops are arrays. | ||
| Can be useful when you just want a for-of loop to represent a basic for loop over an array. | ||
| ### Optimization | ||
| If a basic array is used, Babel will compile the for-of loop down to a regular for loop. | ||
| **In** | ||
| ```js | ||
| for (let a of [1,2,3]) {} | ||
| ``` | ||
| **Out** | ||
| ```js | ||
| var _arr = [1, 2, 3]; | ||
| for (var _i = 0; _i < _arr.length; _i++) { | ||
| var a = _arr[_i]; | ||
| } | ||
| ``` |
New alerts
License Policy Violation
LicenseThis 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
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
Worsened metrics
- Total package byte prevSize
- decreased by-18.86%
10337
- Number of package files
- decreased by-25%
3
- Number of lines in readme file
- decreased by-87.1%
20
Dependency changes
+ Added@babel/helper-plugin-utils@7.0.0-beta.50(transitive)
- Removed@babel/helper-plugin-utils@7.0.0-beta.49(transitive)