Skip to content

cpojer/js-codemod

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.

js-codemod Build Status

This repository contains a collection of codemod scripts for use with JSCodeshift.

Setup & Run

npm install -g jscodeshift
git clone https://github.com/cpojer/js-codemod.git
jscodeshift -t <codemod-script> <file>

Use the -d option for a dry-run and use -p to print the output for comparison.

Included Scripts

arrow-function-arguments

jscodeshift -t js-codemod/transforms/arrow-function-arguments.js <file>

arrow-function

Transforms callbacks only when it can guarantee it won't break this context in the function. Also transforms function() { }.bind(this) calls to () => {}.

jscodeshift -t js-codemod/transforms/arrow-function.js <file>
Options:

--inline-single-expressions=true: If you are feeling lucky and you know that returning the value of single-expression functions will not affect the behavior of your application you can specify the option and it will transform function() { relay(); } to () => relay() instead of () => { relay(); }.

--max-width=120: Try the best it can to keep line lengths under the specified length.

invalid-requires

jscodeshift -t js-codemod/transforms/invalid-requires.js <file>

jest-update

jscodeshift -t js-codemod/transforms/jest-update.js <file>

no-reassign-params

Converts functions to not reassign to parameters. This is useful to turn on in conjunction with Flow's const_params option.

jscodeshift -t js-codemod/transforms/no-reassign-params.js <file>

no-vars

Conservatively converts var to const or let.

jscodeshift -t js-codemod/transforms/no-vars.js <file>

object-shorthand

Transforms object literals to use ES6 shorthand for properties and methods.

jscodeshift -t js-codemod/transforms/object-shorthand.js <file>

outline-require

jscodeshift -t js-codemod/transforms/outline-require.js <file>

rm-copyProperties

jscodeshift -t js-codemod/transforms/rm-copyProperties.js <file>

rm-merge

jscodeshift -t js-codemod/transforms/rm-merge.js <file>

rm-object-assign

jscodeshift -t js-codemod/transforms/rm-object-assign.js <file>

rm-requires

Removes any requires where the imported value is not referenced. Additionally if any module is required more than once the two requires will be merged.

jscodeshift -t js-codemod/transforms/rm-requires.js <file>

template-literals

Replaces string concatenation with template literals.

jscodeshift -t js-codemod/transforms/template-literals.js <file>

Adapted from "How to write a codemod" by Ramana Venkata.

Areas of improvement:

  • Comments in the middle of string concatenation are currently added before the string but after the assignment. Perhaps in these situations, the string concatenation should be preserved as-is.

  • Nested concatenation inside template literals is not currently simplified. Currently, a + b${'c' + d} becomes ${a}b${'c' + d} but it would ideally become ${a}b${`c${d}`}.

  • Unnecessary escaping of quotes from the resulting template literals is currently not removed. This is possibly the domain of a different transform.

  • Unicode escape sequences are converted to unicode characters when the simplified concatenation results in a string literal instead of a template literal. It would be nice to perserve the original--whether it be a unicode escape sequence or a unicode character.

touchable

jscodeshift -t js-codemod/transforms/touchable.js <file>

trailing-commas

Adds trailing commas to array and object literals.

jscodeshift -t js-codemod/transforms/trailing-commas.js <file>

unchain-variables

Unchains chained variable declarations.

jscodeshift -t js-codemod/transforms/unchain-variables.js <file>

underscore-to-lodash-native

Replaces underscore (or lodash) to ES6 + lodash, preferring native ES6 array methods. Member imports are used by default to allow tree-shaking, but the --split-imports=true option will split each lodash import into its own lodash/<method> import.

jscodeshift -t js-codemod/transforms/underscore-to-lodash-native.js <file>

unquote-properties

Removes quotes from object properties whose keys are strings which are valid identifiers.

jscodeshift -t js-codemod/transforms/unquote-properties.js <file>

updated-computed-props

jscodeshift -t js-codemod/transforms/updated-computed-props.js <file>

use-strict

Adds a top-level 'use strict' statement to JavaScript files

jscodeshift -t js-codemod/transforms/use-strict.js <file>

Included extensions

jscodeshift-imports helpers for modifying import and require statements, see docs.

Recast Options

Options to recast's printer can be provided through the printOptions command line argument

jscodeshift -t transform.js <file> --printOptions='{"quote":"double"}'

About

Codemod scripts to transform code to next generation JS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published