value.js 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. /**
  2. * Checks if the given form element's value equals the expected value.
  3. *
  4. * ```
  5. * this.demoTest = function (client) {
  6. * browser.assert.value("form.login input[type=text]", "username");
  7. * };
  8. * ```
  9. *
  10. * @method value
  11. * @param {string} selector The selector (CSS / Xpath) used to locate the element.
  12. * @param {string} expectedText The expected text.
  13. * @param {string} [message] Optional log message to display in the output. If missing, one is displayed by default.
  14. * @api assertions
  15. */
  16. var util = require('util');
  17. exports.assertion = function(selector, expected, msg) {
  18. var MSG_ELEMENT_NOT_FOUND = 'Testing if value of <%s> equals: "%s". ' +
  19. 'Element or attribute could not be located.';
  20. this.message = msg || util.format('Testing if value of <%s> equals: "%s".', selector, expected);
  21. this.expected = expected;
  22. this.pass = function(value) {
  23. return value === this.expected;
  24. };
  25. this.failure = function(result) {
  26. var failed = (result === false) ||
  27. // no such element
  28. result && result.status === -1 ||
  29. // element doesn't have a value attribute
  30. result && result.value === null;
  31. if (failed) {
  32. this.message = msg || util.format(MSG_ELEMENT_NOT_FOUND, selector, expected);
  33. }
  34. return failed;
  35. };
  36. this.value = function(result) {
  37. return result.value;
  38. };
  39. this.command = function(callback) {
  40. return this.api.getValue(selector, callback);
  41. };
  42. };