The Salesforce world is moving fast with Lightning. Lightning is an efficient and consistent interface to navigate through your org and the Lightning Experience takes things to another level. In order to enables us to leverage our code, ensuring at the same time that we follow the Salesforce recommended best practices, Salesforce has introduced Lightning Command Line Interface(CLI).
Lightning CLI is a Heroku Toolbelt plugin that lets you scan your code for general JavaScript coding issues and Lightning-specific issues. This tool is based on the ESLint project and finds the issues within the JavaScript code. As your Lightning component mostly consists of client-side code in the form of JavaScript, it becomes pertinent to have code review checks on a periodic basis.
Lightning CLI alerts you to specific issues related to LockerService. Issues that are flagged include incorrect Lightning components code, and usage of unsupported or private JavaScript API methods. Lightning CLI installs into the Heroku Toolbelt, and is used on the command line.
Step 1: Heroku Installation
Download the Heroku toolbelt on your machine from the following link:
https://toolbelt.heroku.com/
Step 2: Install Salesforce Lightning CLI
Install Lightning CLI as a Heroku Toolbelt plugin. Once this is done, update the Heroku Toolbelt to get the latest Lightning CLI rules.
heroku plugins:install salesforce-lightning-cli
Step 3: Use Salesforce Lightning CLI
Written by Twinkle Panjabi, Sr. Salesforce Developer at Eternus Solutions
WHAT IS LIGHTNING CLI?
Lightning CLI is a Heroku Toolbelt plugin that lets you scan your code for general JavaScript coding issues and Lightning-specific issues. This tool is based on the ESLint project and finds the issues within the JavaScript code. As your Lightning component mostly consists of client-side code in the form of JavaScript, it becomes pertinent to have code review checks on a periodic basis.
Lightning CLI alerts you to specific issues related to LockerService. Issues that are flagged include incorrect Lightning components code, and usage of unsupported or private JavaScript API methods. Lightning CLI installs into the Heroku Toolbelt, and is used on the command line.
HOW TO USE LIGHTNING CLI?
Step 1: Heroku Installation
Download the Heroku toolbelt on your machine from the following link:
https://toolbelt.heroku.com/
Step 2: Install Salesforce Lightning CLI
Install Lightning CLI as a Heroku Toolbelt plugin. Once this is done, update the Heroku Toolbelt to get the latest Lightning CLI rules.
heroku plugins:install salesforce-lightning-cli
Step 3: Use Salesforce Lightning CLI
- To display the Code Review on the command prompt in a text format, use:
heroku lightning:lint - To display the Code Review on the command prompt in a JSON format, use:
heroku lightning:lint . -j - To get the Code Review as a File in a json or text format, use:
heroku lightning:lint .(Source Path) > report.txt
heroku lightning:lint "D:\Lightning Component\ContactList\src\aura\campingList" > report.txt
OR
heroku lightning:lint "D:\Lightning Component\ContactList\src\aura\campingList" -j > report.json
ADVANTAGES
There are quite a few advantages of using the Lightning CLI:- Scan the code locally on the lightning component implemented before submitting the code for reviews
- Check/discover the issue related to security and unused variables
- Enforce security and code best practices across implementation
I hope you are all set to use the Lightning CLI. In case you feel the need to reference additional knowledge material, the following links are quite helpful:
References
Written by Twinkle Panjabi, Sr. Salesforce Developer at Eternus Solutions