This commit is contained in:
Yamozha
2021-04-02 02:24:13 +03:00
parent c23950b545
commit 7256d79e2c
31493 changed files with 3036630 additions and 0 deletions

View File

@ -0,0 +1,3 @@
src
test
*.log

View File

@ -0,0 +1,122 @@
# babel-plugin-syntax-trailing-function-commas
> Compile trailing function commas to ES5
```js
function clownPuppiesEverywhere(
param1,
param2,
) { /* ... */ }
clownPuppiesEverywhere(
'foo',
'bar',
);
```
## Example
### Basic
This is an example from the [Proposal](https://github.com/jeffmo/es-trailing-function-commas).
Let's say you have this function:
```js
function clownPuppiesEverywhere(
param1,
param2
) { /* ... */ }
clownPuppiesEverywhere(
'foo',
'bar'
);
```
If you want to have a new parameter called `param3`, the diff output would be like that:
```diff
function clownPuppiesEverywhere(
param1,
- param2
+ param2, // Change this line to add a comma
+ param3 // Add param3
) { /* ... */ }
clownPuppiesEverywhere(
'foo',
- 'bar'
+ 'bar', // Change this line to add a comma
+ 'baz' // Add param3
);
```
In total, you have to change 2 lines for the function declaration and 2 lines for each usage.
If you had your function defined with trailing commas:
```js
function clownPuppiesEverywhere(
param1,
param2,
) { /* ... */ }
clownPuppiesEverywhere(
'foo',
'bar',
);
```
Adding a new parameter would only change one line in the function declaration and one line for each usage:
```diff
function clownPuppiesEverywhere(
param1,
param2,
+ param3, // Add param3
) { /* ... */ }
clownPuppiesEverywhere(
'foo',
'bar',
+ 'baz', // Add param3
);
```
In the end, your diff output will be cleaner and easier to read, it would be much quicker to add a new parameter to your functions, it also makes it easier to copy paste elements and move code around.
## Installation
```sh
npm install --save-dev babel-plugin-syntax-trailing-function-commas
```
## Usage
### Via `.babelrc` (Recommended)
**.babelrc**
```json
{
"plugins": ["syntax-trailing-function-commas"]
}
```
### Via CLI
```sh
babel --plugins syntax-trailing-function-commas script.js
```
### Via Node API
```javascript
require("babel-core").transform("code", {
plugins: ["syntax-trailing-function-commas"]
});
```
## References
* [Proposal](https://github.com/jeffmo/es-trailing-function-commas)
* [Spec](http://jeffmo.github.io/es-trailing-function-commas/)
* [Why you should enforce Dangling Commas for Multiline Statements](https://medium.com/@nikgraf/why-you-should-enforce-dangling-commas-for-multiline-statements-d034c98e36f8)

View File

@ -0,0 +1,11 @@
"use strict";
exports.__esModule = true;
exports.default = function () {
return {
manipulateOptions: function manipulateOptions(opts, parserOpts) {
parserOpts.plugins.push("trailingFunctionCommas");
}
};
};

View File

@ -0,0 +1,14 @@
{
"name": "babel-plugin-syntax-trailing-function-commas",
"version": "7.0.0-beta.0",
"description": "Compile trailing function commas to ES5",
"repository": "https://github.com/babel/babel/tree/master/packages/babel-plugin-syntax-trailing-function-commas",
"license": "MIT",
"main": "lib/index.js",
"keywords": [
"babel-plugin"
],
"devDependencies": {
"babel-helper-plugin-test-runner": "7.0.0-beta.0"
}
}