summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBryce Johnson <bryce@gitlab.com>2016-10-12 19:00:38 +0200
committerBryce Johnson <bryce@gitlab.com>2016-10-12 19:00:38 +0200
commitabfb4f6e32ac13929678039e324307ee3ef2af43 (patch)
tree7b0454f21a0c7a0997c798111e98fe4053dea238
parent3c31f185b931a4054804aee56be0602135b75bed (diff)
downloadgitlab-ce-es6-es5-poltergeist.tar.gz
Document Capybara errors from es6 in es5 file.es6-es5-poltergeist
-rw-r--r--doc/development/frontend.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/development/frontend.md b/doc/development/frontend.md
index f879cd57e25..56c8516508e 100644
--- a/doc/development/frontend.md
+++ b/doc/development/frontend.md
@@ -223,3 +223,14 @@ For our currently-supported browsers, see our [requirements][requirements].
[xss]: https://en.wikipedia.org/wiki/Cross-site_scripting
[scss-style-guide]: scss_styleguide.md
[requirements]: ../install/requirements.md#supported-web-browsers
+
+## Common Errors
+
+### Rspec (Capybara/Poltergeist) chokes on general JavaScript errors
+
+If you see very generic JavaScript errors (e.g. `jQuery is undefined`) being thrown in tests, but
+can't reproduce them manually, you may have included `ES6`-style JavaScript in files that don't
+have the `.js.es6` file extension. Either use ES5-friendly JavaScript or rename the file you're
+working in (`git mv <file>.js> <file.js.es6>`).
+
+