Appium-style-guide

Style guide for contributors

Thanks for your contribution to Appium! Here are the principles we use when
writing javascript. Please conform to these so we can merge your pull request
without going back and forth about style. The main principle is: make your
code look like the surrounding code
.

JavaScript

With the exception of the code that runs on the devices themselves
(appium-uiautomator2-server for
Android, WebDriverAgent for iOS), Appium is written in Node.js. If you are
not familiar with JavaScript, please familiarize yourself before attempting
to modify the code. There are plenty of good, free resources (see, for example,
You Don’t Know JavaScript).

Rebasing

Commits in a pull request should consist of logical changes.
If there are multiple authors, make sure each author has their own commit.
It’s not a good idea to modify author information. Merge commits should be
rebased out of pull requests.

Linting

All code must pass ESLint. To check your code, you can simply run npm run lint
from the Appium repo dir. The configuration is specified in the
eslint-config-appium package.

Most modern editors have integration with ESLint. See here for details.

Style notes

We use a future version of JavaScript and take advantage of the Babel
transpiler to render it down to what is supported by current versions of
Node.js. We use ES2015 (formerly called ES6) with some
not-yet-standard features, namely async/await. This style guide
must be followed diligently in all Appium contributions! Luckily, linting
will enforce most of these rules!

  • Use two spaces for indentation, no tabs

  • Use single spaces around operators

    let x = 1;
    

    not

    let x=1;
    
  • Spaces after commas and colons in lists, objects, function calls, etc…

    let x = myFunc('lol', {foo: bar, baz: boo});
    

    not

    let x = myFunc('lol',{foo:bar,baz:boo});
    
  • Always end statements with semicolons

  • Brackets for function, if, etc… go on same line, else gets sandwiched

    if (foo === bar) {
      // do something
    } else {
      // do something else
    }
    

    not

    if (foo === bar)
    {
      // do something
    }
    else
    {
      // do something else
    }
    
  • Space after if, for, and function:

    if (foo === bar) {
    
    for (let i = 0; i < 10; i ++) {
    
    let lol = function (foo) {
    

    not

    if(foo === bar) {
    
    for(let i = 0; i < 10; i ++) {
    
    let lol = function(foo) {
    
  • Avoid bracketless if for one-liners:

    if (foo === bar) {
      foo++;
    }
    

    not

    if (foo === bar)
      foo++;
    

    except in the case of short-circuiting to return/error

    if (err) return;
    
    if (err) throw new Error(err);
    
  • Use ===, not ==, and !==, not != for no surprises

  • Line length shouldn’t be longer than 79 characters

  • Break up long strings like this:

    myFunc('This is a really long string that's longer ' +
           'than 79 characters so I broke it up, woo');
    
  • Comments should line up with code

    if (foo === 5) {
      myFunc(foo);
      // foo++;
    }
    

    not

    if (foo === 5) {
      myFunc(foo);
    //foo++;
    }
    
  • Variable names should be camelCased:

    let myVariable = 42;
    

    not

    let my_variable = 42;
    
  • Check for undefined using Appium’s appium-support package

    util.hasValue(myVariable)
    
  • Define a variable with a default value

    let x = y || z;
    

    not

    let x = y ? y : z;
    

Test Style:

Tests are written using mocha and chai. The WebDriver
library used is wd.

Keep on the same line if it makes sense semantically and length is not an issue:

Examples:

driver.elementByTagName('el1').should.become('123');

driver
  .elementsByTagName('el1').should.eventually.have.length(0);

Alternatively use extra indents to improve readability:

driver
  .elementById('comments')
    .clear()
    .click()
    .keys('hello world')
    .getValue()
    .should.become('hello world')
  .elementById('comments')
    .getValue().should.become('hello world');

driver
  .execute("'NaN'--")
    .should.be.rejectedWith('status: 13');

官方链接为:Appium Style Guide - Appium