Files
gerrit/polygerrit-ui
Wyatt Allen afdd9e5d3f Addresses unit-test flakiness in Safari
The gr-settings-view tests partially relied on timing for evaluating the
tests. If a browser acted too slowly in executing the test, the tests
would occasionally fail. This change removes timing from the test and
instead listens to a promise that the settings view now provides.

A gr-error-manager test relied on flushing the DOM for a response
content promise to be resolved. In Safari, this would frequently execute
out of the expected order. This change waits for the promise itself to
complete before continuing the test.

Change-Id: Id93ccc44bcf3baecdba53058e42dcebccfa4c326
2016-06-17 17:17:31 -07:00
..
2016-05-04 19:09:34 +00:00

PolyGerrit

Installing Node.js

# Debian/Ubuntu
sudo apt-get install nodejs-legacy

# OS X with Homebrew
brew install node

All other platforms: download from nodejs.org.

Optional: installing go

This is only required for running the run-server.sh script for testing. See below.

# Debian/Ubuntu
sudo apt-get install golang

# OS X with Homebrew
brew install go

All other platforms: download from golang.org

Add [go] to your path

PATH=$PATH:/usr/local/go/bin

Local UI, Production Data

To test the local UI against gerrit-review.googlesource.com:

./polygerrit-ui/run-server.sh

Then visit http://localhost:8081

Local UI, Test Data

One-time setup:

  1. Install Buck for building Gerrit.
  2. Build Gerrit and set up a local test site.

Run a test server:

buck build polygerrit && \
java -jar buck-out/gen/polygerrit/polygerrit.war daemon --polygerrit-dev -d ../gerrit_testsite --console-log --show-stack-trace

Running Tests

One-time setup:

# Debian/Ubuntu
sudo apt-get install npm

# OS X with Homebrew
brew install npm

# All platforms (including those above)
sudo npm install -g web-component-tester

Run all web tests:

buck test --no-results-cache --include web

The --no-results-cache flag prevents flaky test failures from being cached.

If you need to pass additional arguments to wct:

WCT_ARGS='-p --some-flag="foo bar"' buck test --no-results-cache --include web

For interactively working on a single test file, do the following:

./polygerrit-ui/run-server.sh

Then visit http://localhost:8081/elements/foo/bar_test.html

Style guide

We follow the Google JavaScript Style Guide with a few exceptions. When in doubt, remain consistent with the code around you.