Mirror
/
zulip
mirror of https://github.com/zulip/zulip.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

docs: Server logs in casper tests are now written inline. 

Also, move note about remote debugging to the remote debugging section.
This commit is contained in:
Puneeth Chaganti 2019-06-10 18:45:24 +05:30 committed by Tim Abbott
parent 0409db3c9d
commit 3bfb08806c
1 changed files with 7 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/testing/testing-with-casper.md
View File

@ -31,23 +31,9 @@ trying to use the Casper debugging tools are:
PhantomJS browser, which doesn't support ES6 syntax, so use of
non-transpiled ES6 syntax will generally be first discovered via the
Casper tests failing..
* Are there any errors in `var/casper/server.log` (from the root of
your `zulip` checkout? That's where the `run-dev.py` console output
goes when running Casper tests.
Casper.js (via PhantomJS) has support for remote debugging. However, it
is not perfect. Here are some steps for using it and gotchas you might
want to know; you'll likely also want to read the section on writing
tests (below) if you get stuck, since the advice on how to write
correct Casper selectors will likely be relevant.
The first thing to do when debugging Casper tests is to check the
additional debug output that our framework provides:
* Are there any backend-errors (printed inline) while running the tests?
* You can check the screenshots of what the UI looked like at the time
of failures at `var/casper/casper-failure*.png`.
* If it's possible there's a backend exception involved,
`var/casper/server.log` will contain the server logs from the casper
run; it's worth looking there for tracebacks if you get stuck.
### Print debugging
@ -68,6 +54,12 @@ This can sometimes give insight into exactly what's happening.
### Remote debugging
Casper.js (via PhantomJS) has support for remote debugging. However, it
is not perfect. Here are some steps for using it and gotchas you might
want to know; you'll likely also want to read the section on writing
tests (below) if you get stuck, since the advice on how to write
correct Casper selectors will likely be relevant.
This is a pain to setup with Vagrant because port `7777` and `9981`
aren't forwarded to the host by default, but can be pretty useful in
rare difficult cases.