summaryrefslogtreecommitdiffstats
path: root/node_modules/babel-plugin-syntax-trailing-function-commas/README.md
diff options
context:
space:
mode:
authorGravatar Piotr Russ <mail@pruss.it> 2020-11-18 23:26:45 +0100
committerGravatar Piotr Russ <mail@pruss.it> 2020-11-18 23:26:45 +0100
commit81ddf9b700bc48a1f8e472209f080f9c1d9a9b09 (patch)
tree8b959d50c5a614cbf9fcb346ed556140374d4b6d /node_modules/babel-plugin-syntax-trailing-function-commas/README.md
parent1870f3fdf43707a15fda0f609a021f516f45eb63 (diff)
downloadwebsite_creator-81ddf9b700bc48a1f8e472209f080f9c1d9a9b09.tar.gz
website_creator-81ddf9b700bc48a1f8e472209f080f9c1d9a9b09.tar.bz2
website_creator-81ddf9b700bc48a1f8e472209f080f9c1d9a9b09.zip
rm node_modules
Diffstat (limited to 'node_modules/babel-plugin-syntax-trailing-function-commas/README.md')
-rw-r--r--node_modules/babel-plugin-syntax-trailing-function-commas/README.md123
1 files changed, 0 insertions, 123 deletions
diff --git a/node_modules/babel-plugin-syntax-trailing-function-commas/README.md b/node_modules/babel-plugin-syntax-trailing-function-commas/README.md
deleted file mode 100644
index fd7022b..0000000
--- a/node_modules/babel-plugin-syntax-trailing-function-commas/README.md
+++ /dev/null
@@ -1,123 +0,0 @@
-# babel-plugin-syntax-trailing-function-commas
-
-Compile trailing function commas to ES5
-
-
-```js
-function clownPuppiesEverywhere(
- param1,
- param2,
-) { /* ... */ }
-
-clownPuppiesEverywhere(
- 'foo',
- 'bar',
-);
-```
-[Try in REPL](http://babeljs.io/repl/#?evaluate=true&presets=es2015%2Cstage-0&code=function%20clownPuppiesEverywhere(%0A%20%20param1%2C%0A%20%20param2%2C%0A)%20%7B%20%2F*%20...%20*%2F%20%7D%0A%0AclownPuppiesEverywhere(%0A%20%20'foo'%2C%0A%20%20'bar'%2C%0A)%3B)
-
-## 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)